SMSAPI PHP Client
Requirements
Install package with dependencies
Execute: composer require smsapi/php-client
How to pick a service
Depending on which of SMSAPI service your account is, you should pick it calling one of a method from examples below:
How to use SMSAPI.COM client?
<?php
declare(strict_types=1);
require_once 'vendor/autoload.php';
use Smsapi\Client\SmsapiHttpClient;
$apiToken = '0000000000000000000000000000000000000000';
$service = (new SmsapiHttpClient())
->smsapiComService($apiToken);How to use SMSAPI.PL client?
<?php
declare(strict_types=1);
require_once 'vendor/autoload.php';
use Smsapi\Client\SmsapiHttpClient;
$apiToken = '0000000000000000000000000000000000000000';
$service = (new SmsapiHttpClient())
->smsapiPlService($apiToken);All following examples consider you have a account on SMSAPI.COM.
How to use a custom URI?
<?php
declare(strict_types=1);
require_once 'vendor/autoload.php';
use Smsapi\Client\SmsapiHttpClient;
$apiToken = '0000000000000000000000000000000000000000';
$uri = 'http://example.com';
$service = (new SmsapiHttpClient())
->smsapiComServiceWithUri($apiToken, $uri);How to use service business features?
How to use ping feature?
<?php
declare(strict_types=1);
require_once 'vendor/autoload.php';
use Smsapi\Client\SmsapiHttpClient;
$apiToken = '0000000000000000000000000000000000000000';
$service = (new SmsapiHttpClient())
->smsapiComService($apiToken);
$result = $service->pingFeature()
->ping();
if ($result->smsapi) {
echo 'SMSAPI active';
} else {
echo 'SMSAPI not active';
}How to send a SMS?
<?php
declare(strict_types=1);
require_once 'vendor/autoload.php';
use Smsapi\Client\SmsapiHttpClient;
use Smsapi\Client\Feature\Sms\Bag\SendSmsBag;
$apiToken = '0000000000000000000000000000000000000000';
$sms = SendSmsBag::withMessage('someone phone number', 'some message');
$service = (new SmsapiHttpClient())
->smsapiComService($apiToken);
$service->smsFeature()
->sendSms($sms);How to send a SMS with optional from field?
<?php
declare(strict_types=1);
require_once 'vendor/autoload.php';
use Smsapi\Client\SmsapiHttpClient;
use Smsapi\Client\Feature\Sms\Bag\SendSmsBag;
$apiToken = '0000000000000000000000000000000000000000';
$sms = SendSmsBag::withMessage('someone phone number', 'some message');
$sms->from = 'Test';
$service = (new SmsapiHttpClient())
->smsapiComService($apiToken);
$service->smsFeature()
->sendSms($sms);For more usage examples take a look at client test suite.
How to use optional request parameters?
Request parameters are represented in a form of data transfer object. DTOs can be found by searching for 'bag' postfixed classes. Each bag may contain required and optional parameters. Required parameters are that class public properties, usually accessible via some form of a setter or named constructor. Optional parameters are described by docblock's '@property' annotation.
Each parameter can be also set directly by setting bag property, as in example:
<?php
declare(strict_types=1);
use Smsapi\Client\Feature\Sms\Bag\SendSmsBag;
$sms = SendSmsBag::withMessage('someone phone number', 'some message');
$sms->encoding = 'utf-8';How to use additional features?
How to use proxy server?
<?php
declare(strict_types=1);
require_once 'vendor/autoload.php';
use Smsapi\Client\SmsapiHttpClient;
$proxyUrl = 'https://example.org';
(new SmsapiHttpClient())->setProxy($proxyUrl);How to log requests and responses?
Set logger to SmsapiHttpClient instance.
<?php
declare(strict_types=1);
use Psr\Log\LoggerInterface;
use Psr\Log\LoggerTrait;
require_once 'vendor/autoload.php';
use Smsapi\Client\SmsapiHttpClient;
$logger = new class() implements LoggerInterface
{
use LoggerTrait;
public function log($level, $message, array $context = [])
{
var_dump($level, $message, $context);
}
};
(new SmsapiHttpClient())->setLogger($logger);Test package
- Download package:
composer create-project smsapi/php-client - Execute tests:
./vendor/bin/phing
