Download the PHP package dhalsted/sms-utils without Composer
On this page you can find all versions of the php package dhalsted/sms-utils. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download dhalsted/sms-utils
More information about dhalsted/sms-utils
Files in dhalsted/sms-utils
Package sms-utils
Short Description Validate SMS numbers using libphonenumber and Twilio
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package sms-utils
sms-utils
sms-utils contains methods I've found useful for handling text messaging. I primarily use Twilio for this but eventually I hope to add support for other vendors.
The first version contains code to validate that a string represents a valid SMS number--something that Twilio won't choke on. This means it must meet certain formatting restrictions and, in addition, must be a number for a text-capable phone (ie, not a landline). The rules for this are complicated. The SMS Validator class will take a string, check that it can be parsed as a phone number, check that it is not a landline, and return a version of the number formatted for use with Twilio. It can handle numbers from different countries and regions. Format validation is handled through Google's libphonenumber and the check for SMS capability is run through Twilio.
Note that you'll need Twilio API credentials to use the Validator.
Installation
Clone or download the repository. Then
To run tests, first copy .env.example to .env and then run
This will run a set of tests that don't require Twilio credentials. To run a more complete set of tests, fill in .env with Twilio credentials and some sample phone numbers, and then do
again.
Quickstart
To use the validator, do something like
where (444) 111-2222 is a valid US landline. You should get
Then try it with a mobile number. In this case, you'll get back
To call the SMSValidator class in your own code, just do
By default, the Validator checks whether the submitted phone number is a mobile or VoIP number. If you want to check specifically for one or the other, do something like this:
SMSValidator throws several kinds of exceptions which can help your users understand why a number will not work for texts.
-
SMSTwilioMisconfigException (code 20100) occurs if missing, incomplete or invalid Twilio credentials are submitted.
-
SMSBadNumberException (code 20101) occurs if the data submitted for a phone number can't be parsed or is incomplete. Submitting a non-existent country or region code, a string that cannot be parsed ("phone number 888 555 1212" instead of "888 555 1212"), or a truncated number will raise this exception.
- SMSNotMobileException (code 20102) occurs if a number is submitted that is not a valid type, by default either mobile or VoIP.
All versions of sms-utils with dependencies
twilio/sdk Version ^5.5
giggsey/libphonenumber-for-php Version ^8.8
vlucas/phpdotenv Version ^2.4@dev