Download and install nexmo/client without Composer
Shortdescription PHP Client for using Nexmo's API.
All versions of client with dependenciesVendor: nexmo
Informations about the package client
Nexmo Client Library for PHP
This library requires a minimum PHP version of 5.6
This is the PHP client library for use Nexmo's API. To use this, you'll need a Nexmo account. Sign up for free at nexmo.com. This is currently a beta release, see contributing for more information.
To use the client library you'll need to have created a Nexmo account.
To install the PHP client library using Composer (Whilst the client is marked as a beta, the API is stable. The beta flag is due to the fact that the client does not cover the full Nexmo API yet.)
If you're using composer, make sure the autoloader is included in your project's bootstrap file:
Create a client with your API key and secret:
Sending A Message
To use Nexmo's SMS API to send an SMS message, call the
The API can be called directly, using a simple array of parameters, the keys match the parameters of the API.
The API response data can be accessed as array properties of the message.
A message object is a more expressive way to create and send messages. Each message type can be constructed with the required parameters, and a fluent interface provides access to optional parameters.
The message object is passed to the same
Once sent, the message object can be used to access the response data.
Array access can still be used:
If the message text had to be sent as multiple messages, by default, the data of the last message is returned. However, specific message data can be accessed using array notation, passing an index to a getter, or iterating over the object.
The send example also has full working examples.
Receiving A Message
Inbound messages are sent to your application as a webhook, and the client library provides a way to create an inbound message object from a webhook:
You can also access the webhook data as an arry:
Fetching A Message
You can retrieve a message log from the API using the ID of the message:
If the message was sent to a Nexmo virtual number, the object will be an instance of
the message was sent from your account, it will be an instance of
Nexmo\Message\Message. You can also pass a message
object to the client:
Starting a Verification
Nexmo's Verify API makes it easy to prove that a user has provided their own phone number during signup, or implement second factor authentication during signin.
You can start a verification process using a simple array:
Or you can pass the client a verification object:
Controlling a Verification
To cancel an in-progress verification, or to trigger the next attempt to send the confirmation code, you can pass either an exsisting verification object to the client library, or simply use a request ID:
Checking A Verification
In the same way, checking a verification requires the code the user provided, and an exiting verification object:
Or a request ID:
Searching For A Verification
You can check the status of a verification, or access the results of past verifications using either an exsisting verification object, or a request ID. The verification object will then provide a rich interface:
You can also access the raw API response here using array access:
Making A Call
$client->calls() methods require the client to be constructed with a
Nexmo\Client\Credentials\Keypair, or a
Nexmo\Client\Credentials\Container that includes the
You can start a call using an array as the structure:
Or you can create a
Nexmo\Call\Call object, and use that:
Fetching A Call
You can fetch a call using a
Nexmo\Call\Call object, or the call's UUID as a string:
The call collection can also be treated as an array:
And iterated over:
With an optional filter:
Creating An Application
Application are configuration containers, and you can create one using a simple array structure:
You can also pass the client an application object:
You can iterate over all your applications:
Or you can fetch an application using a string UUID, or an application object.
Updating an Application
Once you have an application object, you can modify and save it.
You can also pass an array and the application UUID to the client:
Search available numbers
You can search for numbers available to purchase in a specific country
To purchase a number, you can pass in a value returned from number search
Or you can specify the number and country manually
Some users have issues making requests due to the following error:
This is due to some PHP installations not shipping with a list of trusted CA certificates. This is a system configuration problem, and not specific to either cURL or Nexmo.
IMPORTANT: In the next paragraph we provide a link to a CA certificate bundle. Nexmo do not guarantee the safety of this bundle, and you should review it yourself before installing any CA bundle on your machine
To resolve this issue, download a list of trusted CA certificates (e.g. the curl bundle) and copy it on to your machine. once this is done, edit
php.ini and set the
- [X] Balance
- [X] Pricing
- [ ] Settings
- [ ] Top Up
- [X] Numbers
- [X] Search
- [X] Buy
- [X] Cancel
- [X] Update
- Number Insight
- [X] Basic
- [X] Standard
- [X] Advanced
- [X] Webhook Notification
- [X] Verify
- [X] Check
- [X] Search
- [X] Control
- [X] Send
- [X] Delivery Receipt
- [X] Inbound Messages
- [X] Search
- [X] Message
- [X] Messages
- [X] Rejections
- [ ] US Short Codes
- [ ] Two-Factor Authentication
- [ ] Event Based Alerts
- [ ] Sending Alerts
- [ ] Campaign Subscription Management
- [X] Outbound Call
- [ ] Inbound Call
- [ ] Text-To-Speech Call
- [ ] Text-To-Speech Prompt
This library is currently being refactored from an earlier prototype to match the current client library spec.
legacy branch can be used to require that earlier version. During the transition the
branches will have both new and legacy code. The API coverage section identifies what features are
currently implemented and up to date.
To contribute to the library, docs, or examples, [create an issue][issues] or a pull request. Please only raise issues about features marked as working in the API coverage as the rest of the code is being updated.
This library is released under the MIT License