cri2net/sms-fly

PHP Library for sms-fly service

README

Эта библиотека зависит от пакета cri2net/sms-client и предназначена для отправки sms через шлюз sms-fly.com Текущее описание расширяет описание cri2net/sms-client, _(*1)

Установка

composer require cri2net/sms-fly

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

Описание методов

Тут приведены лишь методы, использование которых отличается от описания в пакете cri2net/sms-client (либо не описанные ранее), _(*2)

• sendSMS($recipient, $text, $description = '') — отправка sms, добавлен необязательный параметр $description, отвечающий за описании кампании отправки (не влияет на отправку, отображается в web интерфейсе sms-fly.com), _(*3)

• getStateText($code) — статический метод, который отдаёт текстовое описание статуса от шлюза ("расшифровывает" кодировки статуса у шлюза), _(*4)

• sendSmsByCron() — отправка подготовленных sms, которые сохранены в БД

Примеры кода

обычная оправка

``` php <?php, <sub>(*5)</sub>

$sms = new \cri2net\sms_fly\SMS_fly($login, $password); $sms->alfaname = 'SMS.TEST'; // by default InfoCenter, <sub>(*6)</sub>

$data = $sms->sendSMS('+380480000000', 'Hello!'); var_dump($data); // array('campaignID' => 1111, 'status' => 'ACCEPTED'), <sub>(*7)</sub>

### Оправка из БД
Для отправки из БД нужно создать в БД таблицу, как описано в пакете [cri2net/sms-client](https://packagist.org/packages/cri2net/sms-client)

Также, нужно инициализировать соединение с базой через библиотеку [cri2net/php-pdo-db](https://packagist.org/packages/cri2net/php-pdo-db)

``` php
<?php

// сохранение sms в БД для отправки
$arr = [
    'to'               => '+380480000000',
    'created_at'       => microtime(true),
    'updated_at'       => microtime(true),
    'min_sending_time' => microtime(true), // отправка прямо сейчас, но можно указать время в будущем для отложенной отправки
    'replace_data'     => json_encode([
        'username'     => 'John', // массив с правилами замен
    ]),
    'raw_text'         => 'Привет, {{username}}!', // переменные в тексте следует обрамлять в двойные фигурный кавычки
];
$insert_sms_id = \cri2net\php_pdo_db\PDO_DB::insert($arr, 'sms_table_name');


// непосредственно отправка, предположительно в кроне
$sms = new \cri2net\sms_fly\SMS_fly($login, $password);
$sms->table = 'sms_table_name'; // нужно создать таблицу в БД

$sms->sendSmsByCron();
$sms->checkStatusByCron();

При сохранении в БД можно использовать поле additional. Оно предназначено исключительно для пользователя. В него, например, можно сохранить в JSON привязку к другой сущности или любую другую информацию, <sub>(*8)</sub>

Поле processing по умолчанию NULL. В этом случае sms попробует отправить любой доступный шлюз, а после отправки заполнит это поле своим ключём. Но можно указать это поле при вставке в БД, и тогда sms сможет отправить только один конкретный шлюз. ``` php <?php, <sub>(*9)</sub>

$arr = [ // ... 'processing' => $sms->getProcessingKey(), 'additional' => json_encode([ 'payment_id' => '10' ]), // ... ]; ```, <sub>(*10)</sub>