README

Version 1.8.7 available here

SMSAPI.COM API documentation

SMSAPI.PL API documentation

Requirements

composer

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

smsapi/php-client

Maintainers

Details