Download the PHP package spiti/smsclient without Composer
On this page you can find all versions of the php package spiti/smsclient. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download spiti/smsclient
More information about spiti/smsclient
Files in spiti/smsclient
Package smsclient
Short Description PHP-класс для работы с API сервисов СМС уведомлений
License MIT
Homepage https://github.com/sintsov/smsClient
Informations about the package smsclient
SMS Client
PHP-класс для работы с API сервисов СМС уведомлений
В настоящий момент поддержка DevinoTelecom http://www.devinotele.com/
Установка зависимостей через Composer
Для работы проекта требуется подтянуть необходмые зависимости
Для этого запустите
Для установки в свой проект
Требования
- PHP >= 5.4.0
Классы и методы
Класс SmsClient\DevinoSMS\Api
Реализует основные методы Devino REST API
send
Описание: Отправка СМС сообщения
Параметры
$sourceAddress: string, отправитель. До 11 латинских символов или до 15 цифровых.
$destinationAddress: string|array, адрес или массив адресов назначения. (Код страны+код сети+номер телефона, Пример: 79031234567)
$data: string, текст сообщения
$sendDate: mixed. дата отправки сообщения. Строка вида (YYYY-MM-DDTHH:MM:SS) или Timestamp (необязательный параметр)
$validity: integer, время жизни сообщения в минутах (необязательный параметр)
Возвращаемое значение
array массив ID сообщений
Пример
$devinoSMS->send('test', '7905000000', 'Тестовое сообщение!'); // отправка SMS
$devinoSMS->send('test', '7905000000', 'Тестовое сообщение!', '2015-07-09T11:55:00'); // отправка SMS в указанное время
$devinoSMS->send('test', '7905000000', 'Тестовое сообщение!', '2015-07-09T11:55:00', '10'); // отправка SMS в указанное время и указанием времени жизни сообщения (10 минут)
sendByTimeZone
Описание: Отправка СМС сообщения с учетом часового пояса получателя
Параметры
$sourceAddress: string, отправитель. До 11 латинских символов или до 15 цифровых.
$destinationAddress: string, адрес назначения. (Код страны+код сети+номер телефона, Пример: 79031234567
$data: string, текст сообщения
$sendDate: mixed. дата отправки сообщения. Строка вида (YYYY-MM-DDTHH:MM:SS) или Timestamp
$validity: integer, время жизни сообщения в минутах (необязательный параметр)
Возвращаемое значение
array массив ID сообщений
Пример
$devinoSMS->sendByTimeZone('test', '7905000000', 'Тестовое сообщение!', '1436608063'); // отправка SMS в указанное время с учетом часового пояса получателя указанного в виде timestamp
$devinoSMS->sendByTimeZone('test', '7905000000', 'Тестовое сообщение!', '2015-07-09T11:55:00'); // отправка SMS в указанное время с учетом часового пояса получателя
$devinoSMS->sendByTimeZone('test', '7905000000', 'Тестовое сообщение!', '2015-07-09T11:55:00', '10'); // отправка SMS в указанное время с учетом часового пояса получателя и указанием времени жизни сообщения (10 минут)
getSMSStatus
Описание: Запрос статуса SMS-сообщения
Параметры
$messageID: string, ID сообщения (который возвращает методы send и sendByTimeZone)
Возвращаемое значение
object объект, вида:
- State: статус сообщения
- TimeStampUtc: дата и время получения ответа
- StateDescription: описание статуса
- CreationDateUtc: дата создания
- SubmittedDateUtc: дата отправки
- ReportedDateUtc: дата доставки
- Price: цена за сообщение
Пример
$devinoSMS->getSMSStatus($id); // Запрос статуса SMS-сообщения
getInbox
Описание: Запрос входящих SMS-сообщений за указанный период
Параметры
$minDateUTC: mixed, начало периода выборки. Строка вида (YYYY-MM-DDTHH:MM:SS) или Timestamp
$maxDateUTC: mixed, конец периода выборки. Строка вида (YYYY-MM-DDTHH:MM:SS) или Timestamp
Возвращаемое значение
array массив объектов с полями:
- Data: текст сообщения
- SourceAddress: адрес отправителя
- DestinationAddress: адрес приема входящих сообщений
- ID: идентификатор сообщения
Пример
$devinoSMS->getInbox('2015-07-09T09:00:00', '2015-07-09T19:00:00'); // Запрос входящих SMS-сообщений за указанный период
$devinoSMS->getInbox('1436608063', '1436861906'); // Запрос входящих SMS-сообщений за указанный период используя timestamp
getStatistics
Описание: Запрос статистики по SMS-рассылкам за указанный период
Параметры
$startDate: mixed, начало периода выборки. Строка вида (YYYY-MM-DDTHH:MM:SS) или Timestamp
$endDate: mixed, конец периода выборки. Строка вида (YYYY-MM-DDTHH:MM:SS) или Timestamp
Возвращаемое значение
array массив с информацией по статистике
Пример
$devinoSMS->getStatistics('2015-07-09T09:00:00', '2015-07-09T19:00:00'); // Запрос статистики по SMS-рассылкам за указанный период
$devinoSMS->getStatistics('1436608063', '1436861906'); // Запрос статистики по SMS-рассылкам за указанный период используя timestamp
getSessionID
Описание: Получить ID сессии (в рамках API метод вызывается в конструкторе) и отдельно вызывать его не требуется
Возвращаемое значение
string ID сессии
Пример
$devinoSMS->getSessionID(); // получить ID сесси
getBalance
Описание: Запроса баланса
Возвращаемое значение
double Баланс
Пример
$devinoSMS->getBalance(); // получить баланс
getClient
Описание: Получить клиента
Возвращаемое значение
object SmsClient\Client\ClientInterface
Пример
$client = $devinoSMS->getClient(); // получить клиента
$client->setTimeout(2); // установить таймаут соединения
Пример использования API
DevinoTelecom
TODO
- [ ] реализовать DI и нормальный интерфейс
- [ ] вынести настройки в конфиги
- [ ] написать тесты