使用 mobily.ws, smsgw.net API 发送 SMS 的包

1.1.0 2023-06-01 21:06 UTC

This package is auto-updated.

Last update: 2024-08-30 01:17:36 UTC


README

这是一个用于发送短信消息的 Laravel 扩展包。它支持多个短信网关,并且可以轻松扩展以支持新的网关。默认配置支持 mobily.ws 和 smsgw.net,您可以轻松添加任何其他网关(请参阅定义新网关

目录

功能和需求

  • 支持直接发送消息
  • 支持在特定日期/时间发送消息
  • 支持一次性发送多个号码的消息
  • 支持多种号码格式,请参阅使用
  • 支持同时使用多个网关和发送者名称。
  • 需要任何短信网关的活跃账户。
  • 支持 Laravel 5.*
  • cURL
  • php >=5.5.0

安装

通过运行 composer require abdullahobaid/sms:dev-master 使用 composer 安装
Composer 将下载并安装包。如果您使用 Laravel > 5.5,请直接转到配置。如果您使用 laravel < 5.4,请打开 config/app.php 并添加以下服务提供者和别名

'providers' => array(
    ...
    abdullahobaid\sms\SmsProvider::class,
),
.
.
.
'aliases' => array(
    ...
    'SMS'    => abdullahobaid\sms\SMS::class,
),

配置

通过运行以下 Artisan 命令发布配置文件。

$ php artisan vendor:publish --provider="abdullahobaid\sms\SmsProvider"

最后,您需要编辑 config/sms.php 配置文件中的自己的网关信息。您还需要在配置文件顶部设置默认网关。

使用

方法

检查余额

SMS::Balance($gatewayName = false);

返回默认网关或指定网关的当前余额。

发送消息 / 消息

SMS::Send($numbers,$message,$dateTime=false,$senderName=false,$gatwayName=false);

$numbers ( 必需 )

您可以传递单个号码或号码数组,以下有示例

  • 号码可以带有尾随零 00966555555555
  • 带有尾随加号 +966555555555
  • 不带尾随零的国际号码 966555555555
  • 即使您可以使用不带国际代码的手机号码 - 仅适用于沙特手机号码 - 0555555555,包将负责格式化号码。

$message ( 必需 )

消息文本

$dateTime ( 可选 )

dateTime 格式 Y-m-d H:i:s

$senderName ( 可选 )

覆盖默认发送者名称

$gatewayName ( 可选 )

覆盖默认网关

示例

直接发送 SMS 消息

将直接向号码发送消息

SMS::Send(966555555555, 'Your Message Here');

如果消息发送成功返回 true,如果未发送返回 false

向多个号码发送 SMS

传递一个号码数组而不是单个号码,以向所有号码发送

$numbers = array('966555555555','966545555555','966565555555');
SMS::Send($numbers, 'Your Message Here');

如果消息发送成功返回 true,如果未发送返回 false

在特定日期/时间发送 SMS 消息

将在指定的日期和时间发送消息

SMS::send(966555555555, 'Your Message Here', $dateTime);
注意
  • DateTime 格式 Y-m-d H:i:s
  • 如果消息发送成功返回 true,如果未发送返回 false

检查当前余额

SMS::Balance();

返回用户的余额。

获取文本消息所需的 SMS 消息数量

SMS::count_messages($text);

覆盖默认发送者名称

SMS::Send(966555555555, 'Your Message Here', $dateTime=false,'SenderName');

注意,新发送者应在 mobily.ws 网站上注册并激活。

许可证

瓦克夫通用公共许可证

基本内容