Package Data | |
---|---|
Maintainer Username: | isaacesso |
Maintainer Contact: | daprod2009@gmail.com (Isaac Esso) |
Package Create Date: | 2017-03-24 |
Package Last Update: | 2021-12-26 |
Home Page: | |
Language: | PHP |
License: | MIT |
Last Refreshed: | 2024-12-16 15:02:03 |
Package Statistics | |
---|---|
Total Downloads: | 9,685 |
Monthly Downloads: | 56 |
Daily Downloads: | 0 |
Total Stars: | 13 |
Total Watchers: | 2 |
Total Forks: | 11 |
Total Open Issues: | 0 |
A php library to interact with the orange sms api for MiddleEast and Africa.
Using composer:
$ composer require mediumart/orange-sms
First you need to resolve a SMSClient
instance:
use Mediumart\Orange\SMS\SMS;
use Mediumart\Orange\SMS\Http\SMSClient;
/**
* if you already have a valid access token
* */
$client = SMSClient::getInstance('<your_access_token>');
// OR
/**
* directly using <client_id> and <client_secret>
* */
$client = SMSClient::getInstance('<client_id>', '<client_secret>');
next step, create an SMS
object passing it the $client
:
$sms = new SMS($client);
and you're good to go:
// prepare and send an sms in a fluent way
$sms->message('Hello, my dear...')
->from('+237690000000')
->to('+237670000000')
->send();
You now have access to the full orange sms api through the $sms
object :
// sending SMS.
$response = $sms->to('+237670000000')
->from('+237690000000', <'optional_sender_name>')
->message('Hello, world!')
->send();
// checking your balance(remaining sms units)
// with optional country code filter ie: CIV
$response = $sms->balance('<country_code>');
// checking SMS orders history
// with optional country code filter ie: CMR
$response = $sms->ordersHistory('<country_code>');
// checking SMS statistics
// with optional country code filter
// and optional appID filter
$response = $sms->statistics('<country_code>', '<app_id>');
// setting the SMS DR notification endpoint
// '<your_backend_notification_url>' $url
// '<sender address>' $sender = '+237690000000'
$response = $sms->setDeliveryReceiptNotificationUrl($url, $sender);
// checking the SMS DR notification endpoint
// '<your_last_registered_endpoint_ID>' $id
$response = $sms->checkDeliveryReceiptNotificationUrl($id);
// delete the SMS DR notification endpoint
// '<last_registered_endpoint_ID>' $id
// '<sender address>' $sender = '+237690000000'
$response = $sms->deleteDeliveryReceiptNotificationUrl($id, $sender);
All json
responses will automatically be converted to array
.
Be sure to lookup the official documentation, to see what to expect as a response
to each call.
When you resolve the SMSClient
instance using your client_id
and client_secret
, a new access token will be fetched from the api server and automatically set on the instance, along with its lifetime in seconds.
We recommend saving the token (maybe to your database) for future use, at least within the limit of its validity period. this will help speed up requests to the api.
Use the getToken()
and getTokenExpiresIn()
to get those values from the instance:
use Mediumart\Orange\SMS\Http\SMSClient;
$client = SMSClient::getInstance('<client_id>', '<client_secret>');
// get the token
$token = $client->getToken();
// get the token lifetime in seconds
$tokenExpiresIn = $client->getTokenExpiresIn();
If you wish, you can also fetch your access token directly without resolving a client instance, using the static authorize
method:
$response = SMSClient::authorize('<client_id>', '<client_secret>');
this will return as $response
, an array of this form:
[
"token_type" => "Bearer",
"access_token" => "i6m2iIcY0SodWSe...L3ojAXXrH",
"expires_in" => "7776000"
]
If you experience ssl certificate checking issue, in your local environment. You can disable the check temporarily with the following line, before starting to interact with the api in your code.
Just for testing purposes though. You should never do this on a production server.
\Mediumart\Orange\SMS\Http\SMSClientRequest::verify(false);
Mediumart orange-sms is an open-sourced software licensed under the MIT license.