Це стара версія документу!
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); }
