dtisgodsson / twilio
A Laravel 4 wrapper for the Twilio PHP SDK.
This package's canonical repository appears to be gone and the package has been frozen as a result.
Installs: 3 739
Dependents: 0
Suggesters: 0
Security: 0
Stars: 4
Watchers: 2
Forks: 2
Open Issues: 1
Requires
- php: >=5.3.0
- illuminate/support: 4.1.*
- twilio/sdk: 3.12.*
This package is not auto-updated.
Last update: 2019-12-09 03:21:16 UTC
README
Resources
Installation
This package can be installed via Composer by adding the following to your composer.json file:
"require": {
"dtisgodsson/twilio": "dev-master"
}
You must then run the following command:
composer update
After installing via Composer, you will need to add the following lineto the providers
array in your app/config/app.php
file:
'Dtisgodsson\Twilio\TwilioServiceProvider'
Configuration
To configure, publish the packages configuration files using the following command from the root of your project:
php artisan config:publish dtisgodsson/twilio
You will now have the Twilio configuration file in your app/config/packages/dtisgodsson/twilio
folder. This config file contains three options:
- sid - obtained from Twilio
- auth_token - obtained from Twilio
- defaut_from_number - a fallback number that texts/voice calls will be sent from should you not specify one
Usage
After installing and configuring this package, using it is easy!
Sending Text Messages
Simplest example
Twilio::to('232323')->message('Fancy a drink?')
Overriding the from number
Twilio::from('121212')->to('232323')->message('Hows it going?')
Making Calls
Calling using TwiML from URL
Twilio::to('232323')->call('http://twimlets.com/holdmusic?Bucket=com.twilio.music.ambient')
Exceptions
The following exceptions may be thrown whilst using the package:
Dtisgodsson\Twilio\Exceptions\TwilioException
This is the default exception and can be thrown in situations such as, trying to sending a message without specifying a number to send it to.
Dtisgodsson\Twilio\Exceptions\TwilioAPIException
This exception is thrown when an error is thrown by the Twilio API. It simply overrides the exception provided with the Twilio SDK. The following methods can be called on the exception for more information:
- getMessage()
- getCode()
- getInformation()
- getStatus()