uapixart-fork/laravel-turbosms

Laravel 的 Turbosms 包

dev-master 2023-07-02 14:25 UTC

This package is not auto-updated.

Last update: 2024-09-23 18:42:02 UTC


README

一个用于通过 SOAP 使用 Turbosms.ua 发送电子邮件的 Laravel 框架包。

安装

安装此扩展的首选方式是通过 composer

运行以下命令之一

composer require uapixart/laravel-turbosms

添加到 config/app.php

'providers' => array(
//...
    Uapixart\LaravelTurbosms\TurbosmsServiceProvider::class,
//...
),
'aliases' => array(
//...
    'Turbosms' => Uapixart\LaravelTurbosms\TurbosmsFacade::class,
//...
),

然后运行命令

$ php artisan vendor:publish --provider="Uapixart\LaravelTurbosms\TurbosmsServiceProvider"

基本设置

您应该在 http://turbosms.ua/ 注册账户

在你的 config/turbosms.php 中,修改以下内容

在调试模式下,短信不会发送,只会添加到数据库表中。如果需要代理

'login' => '',
'password' => '',
'sender' => '',
'options' => [],
'debug' => false,

使用

'options' => ['proxy_host' => "proxy.com", 'proxy_port' => 3128],

发送消息

一旦安装了扩展,只需在代码中使用它即可

或对于多个收件人

Turbosms::send('+380XXXXXXXXX','test');

示例响应此命令

Turbosms::send(['+380XXXXXXXXX','+380XXXXXXXXX'],'test');

状态

Turbosms::send(['+9873','+3805037512XX'],'Test');
array:2 [▼
  0 => array:3 [▼
    "status" => 3
    "status_detail" => "Message undelivered: Не удалось распознать номер получателя "+9873""
    "messageid" => null
  ]
  1 => array:3 [▼
    "status" => 1
    "status_detail" => "Message send"
    "messageid" => "f7a6e2c8-5931-7dda-1d29-19c0bfec6beb"
  ]
]

0 - 新消息

1 - 在队列中

2 - 消息在队列中等待重试

3 - 消息已发送

4 - 消息失败

5 - 信用额不足

获取信用额余额

从配置获取用户账户余额

Turbosms::getBalance();

获取消息状态

获取消息 ID 的状态

Turbosms::getMessageStatus('f7a6e2c8-5931-7dda-1d29-19c0bfec6beb');

和响应

array:1 [▼
  0 => array:2 [▼
    "status" => 4
    "status_description" => "Сообщение доставлено получателю"
  ]
]

状态可以是以下之一

'0' => 'Сообщение с ID X не найдено',
'1' => 'Отправлено', *
'2' => 'В очереди', *
'3' => 'Сообщение передано в мобильную сеть', *
'4' => 'Сообщение доставлено получателю',
'5' => 'Истек срок сообщения',
'6' => 'Удалено оператором',
'7' => 'Не доставлено',
'8' => 'Сообщение доставлено на сервер', *
'9' => 'Отклонено оператором',
'10' => 'Неизвестный статус',
'11' => 'Ошибка, сообщение не отправлено',
'12' => 'Не достаточно кредитов на счете',
'13' => 'Отправка отменена',
'14' => 'Отправка приостановлена',
'15' => 'Удалено пользователем',

* - 消息的状态将在最终状态之前发生变化