README

这个库依赖于包 cri2net/sms-client，旨在通过 letsads.com 网关发送短信。当前描述扩展了 cri2net/sms-client 的描述

安装

composer require cri2net/sms-letsads

使用

方法描述

这里只列出与包 cri2net/sms-client 中描述不同的方法（或之前未描述的）

• getStateText($code) — 一个静态方法，返回网关状态文本描述（"解密"网关状态码）
• sendSmsByCron() — 发送保存在数据库中的已准备短信

代码示例

普通发送

<?php

use cri2net\Sms\LetsAds\LetsAds;

$sms = new LetsAds($login, $password);
$sms->alfaname = 'MyName'; // по умолчанию InfoCentr или Test или

$data = $sms->sendSMS('+380480000000', 'Hello!');
var_dump($data); // array('campaignID' => 1111, 'status' => 'MESSAGE_IN_QUEUE')

数据库发送

要从数据库发送，需要在数据库中创建一个表，如包 cri2net/sms-client 中所述

此外，还需要通过库 cri2net/php-pdo-db 初始化与数据库的连接

<?php

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

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

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

在保存到数据库时，可以使用 additional 字段。它仅对用户开放。例如，可以在其中保存 JSON 格式的与其他实体的关联信息或任何其他信息

默认情况下，processing 字段为 NULL。在这种情况下，sms 将尝试通过任何可用的网关发送，并在发送后填充此字段。但也可以在插入数据库时指定此字段，这样 sms 就只能发送特定的网关。

<?php

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