rolikoff/iqsms-sdk

0.1.8 2020-04-12 18:30 UTC

This package is not auto-updated.

Last update: 2024-03-25 10:43:23 UTC


README

Форк Fruitware/prostor-sms-php-sdk. Проблема оригинальной версии в том, что с изменением IQSMS API, поменялись и URL-ы запросов. Автор Fruitware/prostor-sms-php-sdk не имел возможности принять PR для обновления URL-ов, это и привело к созданию данного форка.

Ссылки на внешнюю документацию:

Установка

composer require rolikoff/iqsms-sdk

Инициализация

use rolikoff\iqsms\Client;
use GuzzleHttp\Client as GuzzleClient;

//set basic access authentication
$options = [
	'auth'    => ['username', 'password'],
];

$smsGate = new Client(new GuzzleClient($options));

Включение логов (необязательно)

Требуются зависимости

composer require guzzlehttp/log-subscriber monolog/monolog
use GuzzleHttp\Subscriber\Log\Formatter;
use GuzzleHttp\Subscriber\Log\LogSubscriber;
use Monolog\Handler\StreamHandler;
use Monolog\Logger;

$log = new Logger('maib_guzzle_request');
$log->pushHandler(new StreamHandler(__DIR__.'/logs/prostor_sms_guzzle_request.log', Logger::DEBUG));
$subscriber = new LogSubscriber($log, Formatter::SHORT);
$smsGate->getHttpClient()->getEmitter()->attach($subscriber);

Примеры использования

Проверить баланс

$balance = $smsGate->balance();
var_dump('balance', $balance);

Отослать sms

Простой вариант

use rolikoff\iqsms\Model\Sms;
use rolikoff\iqsms\Exception\BadSmsStatusException;

$sms = new Sms();
$sms->setId(unique()) // id sms в вашей системе
    ->setPhone('+71234567890')
    ->setText('тест sms');

try {
    $smsGate->send($sms);
}
catch (BadSmsStatusException $ex) {
    // что-то сделать с ошибкой
}

var_dump('sms', $sms);

Отсылка нескольких

$sms = new Sms();

$sms->setId(unique()) // id sms в вашей системе
    ->setPhone('+71234567890')
    ->setText('тест sms')
    ->sender('TEST') // Подпись отправителя (например TEST);

// Название очереди статусов отправленных сообщений
$queueName = 'myQueue1';

// Дата для отложенной отправки сообщения
$scheduleTime = (new \DateTime())->modify('+1 day');

$smsCollection = $smsGate->sendQueue([$sms, $sms], $queueName, $scheduleTime);

foreach ($smsCollection as $sms) {
    if ($sms->getStatus() !== $sms::STATUS_ACCEPTED) {
        // что-то сделать с ошибкой
    }
}