README

Легковесный, типобезопасный и полностью тестируемый клиент для работы с SmsTraffic HTTP API на PHP 8.4+.

Соблюдает принципы SOLID, PSR-4, использует immutable DTO, enums и современные возможности PHP.

Требования

• PHP 8.4 или выше
• Расширение ext-simplexml (включено по умолчанию в большинстве сборок)
• Composer для управления зависимостями

Автоматически устанавливает:

• guzzlehttp/guzzle — для HTTP-запросов

Быстрый старт

1. Установите пакет:

composer require gelo11/smstraffic-client

1. Отправьте SMS:

use Gelo11\SmsTraffic\SmsTrafficClient;
use Gelo11\SmsTraffic\SmsTrafficConfig;
use Gelo11\SmsTraffic\Client\GuzzleHttpClient;
use Gelo11\SmsTraffic\Parser\SimpleXmlResponseParser;
use Gelo11\SmsTraffic\Request\SendSmsRequest;

$config = new SmsTrafficConfig('ваш_логин', 'ваш_пароль');

$client = new SmsTrafficClient(
    $config,
    new GuzzleHttpClient(new \GuzzleHttp\Client()),
    new SimpleXmlResponseParser()
);

$request = new SendSmsRequest(
    phones: '79051112233',
    message: 'Привет!',
    originator: 'MySender',
    wantSmsIds: true
);

$response = $client->sendSms($request);
echo "Отправлено: {$response->description}\n";

1. Обработка ошибок

use Gelo11\SmsTraffic\Exception\SmsTrafficException;
use Gelo11\SmsTraffic\Model\ErrorCode;

try {
    $client->sendSms($request);
} catch (SmsTrafficException $e) {
    if ($e->getCode() === ErrorCode::INSUFFICIENT_FUNDS) {
        // Обработка нехватки средств
    }
}

1. Работа со статусами

use Gelo11\SmsTraffic\Model\Status;

$status = Status::fromString('Delivered');
echo $status->isFinal() ? 'Доставлено' : 'В обработке';

Методы

Клиент поддерживает следующие операции:

Лицензия

Этот проект распространяется под лицензией MIT.