twilio-php
The default branch name for this repository has been changed to main as of 07/27/2020.
Documentation
The documentation for the Twilio API can be found here.
The PHP library documentation can be found here.
Versions
twilio-php uses a modified version of Semantic Versioning for all changes. See this document for details.
Supported PHP Versions
This library supports the following PHP implementations:
- PHP 7.2
- PHP 7.3
- PHP 7.4
- PHP 8.0
Installation
You can install twilio-php via composer or by downloading the source.
Via Composer:
twilio-php is available on Packagist as the twilio/sdk package:
composer require twilio/sdk
Quickstart
Send an SMS
// Send an SMS using Twilio's REST API and PHP
<?php
$sid = "ACXXXXXX"; // Your Account SID from www.twilio.com/console
$token = "YYYYYY"; // Your Auth Token from www.twilio.com/console
$client = new Twilio\Rest\Client($sid, $token);
$message = $client->messages->create(
'8881231234', // Text this number
[
'from' => '9991231234', // From a valid Twilio number
'body' => 'Hello from Twilio!'
]
);
print $message->sid;
Make a Call
<?php
$sid = "ACXXXXXX"; // Your Account SID from www.twilio.com/console
$token = "YYYYYY"; // Your Auth Token from www.twilio.com/console
$client = new Twilio\Rest\Client($sid, $token);
// Read TwiML at this URL when a call connects (hold music)
$call = $client->calls->create(
'8881231234', // Call this number
'9991231234', // From a valid Twilio number
[
'url' => 'https://twimlets.com/holdmusic?Bucket=com.twilio.music.ambient'
]
);
Specify Region and/or Edge
To take advantage of Twilio's Global Infrastructure, specify the target Region and/or Edge for the client:
<?php
$sid = "ACXXXXXX"; // Your Account SID from www.twilio.com/console
$token = "YYYYYY"; // Your Auth Token from www.twilio.com/console
$client = new Twilio\Rest\Client($sid, $token, null, 'au1');
$client->setEdge('sydney');
A Client constructor without these parameters will also look for TWILIO_REGION and TWILIO_EDGE variables inside the current environment.
This will result in the hostname transforming from api.twilio.com to api.sydney.au1.twilio.com.
Enable Debug Logging
There are two ways to enable debug logging in the default HTTP client. You can create an environment variable called TWILIO_LOG_LEVEL and set it to debug or you can set the log level to debug:
$sid = "ACXXXXXX"; // Your Account SID from www.twilio.com/console
$token = "YYYYYY"; // Your Auth Token from www.twilio.com/console
$client = new Twilio\Rest\Client($sid, $token);
$client->setLogLevel('debug');
Generating TwiML
To control phone calls, your application needs to output TwiML.
Use Twilio\TwiML\(Voice|Messaging|Fax)Response to easily chain said responses.
<?php
$response = new Twilio\TwiML\VoiceResponse();
$response->say('Hello');
$response->play('https://api.twilio.com/cowbell.mp3', ['loop' => 5]);
print $response;
That will output XML that looks like this:
<?xml version="1.0" encoding="utf-8"?>
<Response>
<Say>Hello</Say>
<Play loop="5">https://api.twilio.com/cowbell.mp3</Play>
</Response>
Handling Exceptions
For an example on how to handle exceptions in this helper library, please see the Twilio documentation.
Using a Custom HTTP Client
To use a custom HTTP client with this helper library, please see the Twilio documentation.
Docker Image
The Dockerfile present in this repository and its respective twilio/twilio-php Docker image are currently used by Twilio for testing purposes only.
Getting help
If you need help installing or using the library, please check the Twilio Support Help Center first, and file a support ticket if you don't find an answer to your question.
If you've instead found a bug in the library or would like new features added, go ahead and open issues or pull requests against this repo!
9 Oct 11, 2022
45 Dec 13, 2022
75 Sep 23, 2022
31 Oct 13, 2022
24 Aug 10, 2020
96 Jan 6, 2023
5 Dec 31, 2022
2 Feb 6, 2022
2 May 19, 2022
6 Jun 14, 2023
1 May 9, 2022
117 Dec 26, 2022
8.4k Dec 30, 2022
15 Nov 17, 2022
3 May 18, 2022
3.3k Jan 5, 2023
287 Jan 6, 2023
156 Jul 30, 2022
62 Jul 28, 2022