zhukmax/smsc

Lib for modern integration smsc.ru service

Smsc API

, _(*1)

Компонент для интеграции сервиса SMSC.RU API (smsc.ru) на сайт. Основано на версии 3.6 официального кода., _(*2)

Установка

С помощью композера:, _(*3)

$ composer require zhukmax/smsc

Использование

Для того, что бы правильно отлавливать Исключения желательно использовать в конструкции try\catch. Не обязательно использовать выход exit(), можно эхом вывести текст ошибки и продолжить выполнение скрипта., _(*4)

<?php
try {
    $sms = new \Zhukmax\Smsc\Api(
        'test',
        '123',
        [
            'https' => true,
            'charset' => 'windows-1251',
            'from' => 'api@smsc.ru',
            'post' => true,
            'debug' => '/home/user/smsc.log'
        ]
    );
} catch (Exception $exception) {
    exit($exception->getMessage());
}

Так же можно унаследовать класс \Zhukmax\Smsc\Api и добавить собственное поведение до/после выполнения методов компонента или, даже, переназначить некоторые из них., _(*5)

<?php
class Sms extends \Zhukmax\Smsc\Api
{
    public function balance()
    {
        var_dump($this->sendCmd('balance'));
    }
}

Свойства конструктора

• логин клиента
• пароль или MD5-хеш пароля в нижнем регистре
• Массив с опциями:
  • protocol - использовать HTTPS протокол, любое значение кроме 'https' приравнивается использованию не защищенного протокола HTTP
  • charset - кодировка сообщения: utf-8 (по умолчанию), koi8-r или windows-1251
  • from - e-mail адрес отправителя
  • post - использовать метод POST, булев
  • debug - флаг отладки, булев

Методы

Публичные методы:

sendSms() - Функция отправки SMS, _(*6)

• обязательные параметры:, _(*7)

  • $phones - список телефонов через запятую или точку с запятой
  • $message - отправляемое сообщение

• необязательные параметры:, _(*8)

  • $translit - переводить или нет в транслит (1,2 или 0)
  • $time - необходимое время доставки в виде строки (DDMMYYhhmm, h1-h2, 0ts, +m)
  • $id - идентификатор сообщения. Представляет собой 32-битное число в диапазоне от 1 до 2147483647.
  • $format - формат сообщения (0 - обычное sms, 1 - flash-sms, 2 - wap-push, 3 - hlr, 4 - bin, 5 - bin-hex, 6 - ping-sms, 7 - mms, 8 - mail, 9 - call)
  • $sender - имя отправителя (Sender ID). Для отключения Sender ID по умолчанию необходимо в качестве имени передать пустую строку или точку.
  • $query - строка дополнительных параметров, добавляемая в URL-запрос ("valid=01:00&maxsms=3&tz=2")
  • $files - массив путей к файлам для отправки mms или e-mail сообщений

возвращает массив (, <количество sms>, стоимость, баланс) в случае успешной отправки либо массив (, -<код ошибки>) в случае ошибки, _(*9)

sendSmsMail() - SMTP версия функции отправки SMS, _(*10)

getSmsCost() - Функция получения стоимости SMS, _(*11)

• обязательные параметры:, _(*12)

  • $phones - список телефонов через запятую или точку с запятой
  • $message - отправляемое сообщение

• необязательные параметры:, _(*13)

  • $translit - переводить или нет в транслит (1,2 или 0)
  • $format - формат сообщения (0 - обычное sms, 1 - flash-sms, 2 - wap-push, 3 - hlr, 4 - bin, 5 - bin-hex, 6 - ping-sms, 7 - mms, 8 - mail, 9 - call)
  • $sender - имя отправителя (Sender ID)
  • $query - строка дополнительных параметров, добавляемая в URL-запрос ("list=79999999999:Ваш пароль: 123\n78888888888:Ваш пароль: 456")

возвращает массив (стоимость, <количество sms>) либо массив (0, -<код ошибки>) в случае ошибки, _(*14)

getStatus() - Функция проверки статуса отправленного SMS или HLR-запроса, _(*15)

• $id - ID cообщения или список ID через запятую, _(*16)

• $phone - номер телефона или список номеров через запятую, _(*17)

• $all - вернуть все данные отправленного SMS, включая текст сообщения (0,1 или 2), _(*18)

возвращает массив (для множественного запроса двумерный массив):, _(*19)

для одиночного SMS-сообщения: (статус, <время изменения>, <код ошибки доставки>), _(*20)

для HLR-запроса: (статус, <время изменения>, <код ошибки sms>, <код IMSI SIM-карты>, <номер сервис-центра>, <код страны регистрации>, <код оператора>, <название страны регистрации>, <название оператора>, <название роуминговой страны>, <название роумингового оператора>), _(*21)

при $all = 1 дополнительно возвращаются элементы в конце массива: (<время отправки>, <номер телефона>, стоимость, , <название статуса>, <текст сообщения>), _(*22)

при $all = 2 дополнительно возвращаются элементы страна, оператор и регион, _(*23)

при множественном запросе: если $all = 0, то для каждого сообщения или HLR-запроса дополнительно возвращается и <номер телефона>, _(*24)

если $all = 1 или $all = 2, то в ответ добавляется , _(*25)

либо массив (0, -<код ошибки>) в случае ошибки, _(*26)

getBalance() - Функция получения баланса, _(*27)

возвращает баланс в виде строки или false в случае ошибки, _(*28)

Внутренние методы:

sendCmd() - Функция вызова запроса. Формирует URL и делает 5 попыток чтения через разные подключения к сервису, _(*29)

readUrl() - Функция чтения URL., _(*30)

Для работы должно быть доступно: curl или fsockopen (только http) или включена опция allow_url_fopen для file_get_contents, _(*31)

, _(*32)

Лицензия

The Apache License Version 2.0. Текст лицензии находится в файле License File., _(*33)