PHPackages j42/laravel-twilio - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. j42/laravel-twilio ActiveLibrary[API Development](/categories/api) j42/laravel-twilio ================== A Twilio port for Laravel (4.2+) v0.0.11a(11y ago)1517.0k9[1 PRs](https://github.com/j42/laravel-twilio/pulls)PHPPHP >=5.4.0 Since Jun 30Pushed 10y ago3 watchersCompare [ Source](https://github.com/j42/laravel-twilio)[ Packagist](https://packagist.org/packages/j42/laravel-twilio)[ RSS](/packages/j42-laravel-twilio/feed)WikiDiscussions master Synced 3w ago READMEChangelogDependencies (1)Versions (12)Used By (0) laravel-twilio ============== [](#laravel-twilio) A Twilio port for Laravel (5.1+) Install ------- [](#install) Add the package to your `composer.json` and run composer update: ``` { "require": { ... "j42/laravel-twilio": "dev-master" } } ``` Then add the service providers and facades to `config/app.php` ``` 'J42\LaravelTwilio\LaravelTwilioServiceProvider', ``` ... ``` 'Twilio' => 'J42\LaravelTwilio\LaravelTwilioFacade' ``` Configure --------- [](#configure) Generate the package config files by running `php artisan config:publish j42/laravel-twilio`, and adjust the relevant fields: ``` return [ 'key' => 'YOURAPIKEY', // Public key 'token' => 'YOURSECRETTOKEN', // Private key 'from' => '9999999999', // Default From Address 'twiml' => 'https://yourdomain.com/base_path', // TWIML Hosted Base Path // Default Features When Requesting Numbers (override via `numbersNear` method) 'features' => [ 'SmsEnabled' => true, 'VoiceEnabled' => false, 'MmsEnabled' => false, ] ]; ``` Phone Verification ------------------ [](#phone-verification) Since phone verification is such a common use case, I created a simple flow to automate this. This package automatically installs the following routes (`GET` or `POST` allowed): ``` /twilio/verify ``` ### Request a Token [](#request-a-token) Initiate an HTTP `GET` or `POST` request to `/twilio/verify` with the following parameters: - `phone` phone number (parsed as string) - `method` ('sms' or 'call') The numeric token is set in a cookie and has a 2 minute TTL during which it is valid. **Returns:** ``` // Get token (method can be either 'sms' or 'call') file_get_contents('/twilio/verify?phone=0000000000&method=sms'); /* { status: 'success', data: { phone: '0000000000', // User's phone status: 'queued' // Twilio response status } } */ ``` ### Verify a Token [](#verify-a-token) Initiate an HTTP `GET` or `POST` re uest to `/twilio/verify/` with the following parameters: - `code` numeric code entered by user If properly verified, the full object will be returned: ``` // Verify token file_get_contents('/twilio/verify?code=00000'); /* { status: 'success', data: { code: '00000', // Initial Generated Code number: '0000000000', // User's phone valid: true } } */ ``` ### Post-Verification (Success) [](#post-verification-success) Once the code has been confirmed, the verified data is available via `Cookie` with a 5 minute TTL. An HTTP request to `/twilio/verify` (with or without any parameters) will return: ``` file_get_contents('/twilio/verify'); /* { status: 'success', data: { code: '00000', // Initial Generated Code number: '0000000000', // User's phone valid: true } } */ ``` #### Advanced Usage [](#advanced-usage) Sometimes you may need to handle additional logic in a controller of your own. By including a handy interface, this becomes easy: **Define the route overrides (whichever suits your preference, or, both)** ``` \Route::any('twilio/verify', [ 'uses' => 'YourController@verify' ]); \Route::any('api/twilio/verify', [ 'uses' => 'YourController@verify' ]); ``` **Create your controller, extending `J42\LaravelTwilio\TwilioVerify`** ``` use J42\LaravelTwilio\TwilioVerify; class TwilioController extends TwilioVerify { // Verify Phone public function verify() { // Your pre-verification logic // Magic // You can include an optional message instead of the default, if you want. // If you do this PLEASE make sure you include `{code}` somewhere so that the user sees the verification code // Without this token present in a custom message, they won't receive their confirmation token. $response = parent::verify($message); // Your post-verification logic // $this->phone === Cookie::get('twilio::phone') === json_decode($response)['data'] return $response; } } ``` **Define your functionality as needed, making sure to call `parent::verify();` to handle the default events. If you need to access the cookie directly you may do so via: `Cookie::get('twilio::phone')`.** SMS --- [](#sms) How to interact with Twilio's REST-based SMS methods. \####Send an SMS ``` Twilio::sms([ // From (optional -- if unsupplied, will be taken from default Config::get('twilio::config.from')) 'from' => '' // Array of recipients 'to' => ['19999999999'], // Text Message 'message' => 'Contents of the text message go here' ]); ``` Call ---- [](#call) How to interact with Twilio's REST-based call initiation methods. \####Initiate a Call (TWIML Endpoint) ``` Twilio::call([ // From (optional -- if unsupplied, will be taken from default Config::get('laravel-twilio::from')) 'from' => '' // Array of recipients 'to' => ['19999999999'], // Relative path to twiml document/endpoint (combined with Config::get('laravel-twilio::twiml') to form an absolute URL endpoint) // You could also specify an abslute URL (http:// or https:// which would not be modified) 'twiml' => 'twilio/verify/twiml' ]); // Response Statuses: // QUEUED, RINGING, IN-PROGRESS, COMPLETED, FAILED, BUSY or NO_ANSWER. ``` Request Local Numbers --------------------- [](#request-local-numbers) You can also request local numbers (to be used in the 'from' field) via any of the attributes available in the SDK client. **Currently US only. If you want to adapt this (feel free to fork it) you may do so easily by abstracting the geoList parameters to the configuration file.** `numbersNear` accepts 3 arguments: - `conditions` Array, of conditions, taken from Twilio docs - `features` Array, of features required (SmsEnabled, VoiceEnabled, MmsEnabled) or null (use default in config) - `buy` int, of #s to purchase automatically & provision with account ``` // Near Area Code (With MMS Capability) + Buy 2 Twilio::numbersNear([ 'AreaCode' => '415' ], ['MmsEnabled' => true], 2); // Near Another Phone # Twilio::numbersNear([ 'NearNumber' => '415XXXXXX', // Other Number 'Distance' => '50' // Miles (optional, default: 25) ]); // Near A City (any combination allowed) Twilio::numbersNear([ 'InRegion' => 'CA', // State/Region/Province Code 'InPostalCode' => '90017' // Postal code? ]); // Near Lat/Long Coordinates Twilio::numbersNear([ 'NearLatLong' => '37.840699,-122.461853', 'Distance' => '50' ]); // ... you get the idea. Most fields can be mixed and matched arbitrarily, but if you are wondering, test it out for yourself! ``` ##### By Regex [](#by-regex) A pattern to match phone numbers on. Valid characters are '*' and \[0-9a-zA-Z\]. The '*' character will match any single digit. See Example 2 and Example 3 below. ``` // By Regex // Valid characters are '*' and [0-9a-zA-Z]. The '*' character will match any single digit. Twilio::numbersNear([ 'Contains' => 'J42' ]); // Matches String Twilio::numbersNear([ 'Contains' => '510555****' ]); // Matches Pattern ``` Purchasing Numbers ------------------ [](#purchasing-numbers) Purchasing numbers is easy. Just pass an array of phone #s you would like to buy to the `buyNumbers` method. ``` // Purchase Phone Numbers Twilio::buyNumber('4151111111'); // Valid as a single request Twilio::buyNumber([ '4151111111', '4152222222' ]); // Or an array // Including a configuration is recommended, but optional Twilio::buyNumber([ '4151111111', '4152222222' ], [ 'VoiceUrl' => 'myendpoint', 'SmsUrl' => 'mysmsendpoint', 'VoiceMethod' => 'GET' ]); ``` Associating #s with TWIML (VoiceUrl/SmsUrl) ------------------------------------------- [](#associating-s-with-twiml-voiceurlsmsurl) You can work with number resources by assigning them to TWIML endpoints for various services (voice, sms), as well as integrate and remove other features. This is as simple as calling `update` with a number resource (an array of numbers, which include `sid` properties -- this includes all responses returned from this library). You can learn more about the "incoming phone numbers" resource via the [Twilio Docs](https://www.twilio.com/docs/api/rest/incoming-phone-numbers) ``` // Associate a # with a new TWIML endpoint Twilio::update(Twilio::buyNumber('4151111111'), [ 'VoiceUrl' => '' ]); ``` ### Health Score 34 — LowBetter than 75% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity32 Limited adoption so far Community16 Small or concentrated contributor base Maturity55 Maturing project, gaining track record Bus Factor1 Top contributor holds 93.6% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~10 days Recently: every ~25 days Total 11 Last Release 4280d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/17124060?v=4)[FreeCode](/maintainers/lmlj)[@lmlj](https://github.com/lmlj) --- Top Contributors [![j42](https://avatars.githubusercontent.com/u/5133586?v=4)](https://github.com/j42 "j42 (44 commits)")[![5starphpdeveloper](https://avatars.githubusercontent.com/u/13958826?v=4)](https://github.com/5starphpdeveloper "5starphpdeveloper (1 commits)")[![bitnbytesio](https://avatars.githubusercontent.com/u/10267256?v=4)](https://github.com/bitnbytesio "bitnbytesio (1 commits)")[![leek](https://avatars.githubusercontent.com/u/60204?v=4)](https://github.com/leek "leek (1 commits)") ### Embed Badge ![Health badge](/badges/j42-laravel-twilio/health.svg) ``` [![Health](https://phpackages.com/badges/j42-laravel-twilio/health.svg)](https://phpackages.com/packages/j42-laravel-twilio) ``` ### Alternatives [aloha/twilio Twilio API for Laravel 4733.7M5](/packages/aloha-twilio)[signalwire-community/signalwire Client library for connecting to SignalWire. 23140.5k](/packages/signalwire-community-signalwire) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)