Це стара версія документу!
API UbillingSMS
Ubilling надає зручну модель абстракції для роботи з чергою SMS-повідомлень. Починаючи зі стабільного релізу Ubilling 0.7.1, ви можете використовувати у своїх модулях базовий клас UbillingSMS для надсилання SMS-повідомлень, особливо не хвилюючись, що з ними відбуватиметься надалі. Починаючи з Ubilling 0.8.0 усю роботу з подальшого опрацювання будь-яких, зокрема й SMS-повідомлень, винесено в окрему підсистему - Собака-посилака.
Давайте рассмотрим на конкретном примере простейший случай посылки SMS сообщения.
//создаем объект класса $sms=new UbillingSMS(); //что будем слать? $message='просто тестовое сообщение'; // Складываем SMS в системную очередь для дальнейшей посылки. // // Параметры метода: 1. номер в международном формате (string) // 2. текстовое сообщение для посылки (string) // 3. принудительная транслитерация сообщения (bool) // 4. модуль, по заказу которого производится посылка (string) $sms->sendSMS('+380931234567', $message, false, 'SAMPLEMODULE');
Вот собственно и все. Сообщение будет сложено в общую очередь SMS для последующей отправки через один из поддерживаемых сервисов доставки SMS. С работой с очередью все тоже довольно просто. Мы в любой момент можем узнать, сколько и каких SMS ожидают отправки в данный момент при помощи метода getQueueCount (возвращает int) и получить полное содержимое очереди, при помощи метода getQueueData (возвращает array).
Пример работы с очередью:
$sms = new UbillingSMS(); //получаем количество SMS ожидающих отправки $queueCount = $sms->getQueueCount(); if ($queueCount > 0) { //и если они есть, получаем их содержимое $queueData = $sms->getQueueData(); //показываем содержимое - внтри array debarr($queueData); }
