abdullahobaid / sms
使用 mobily.ws, smsgw.net API 发送 SMS 的包
1.1.0
2023-06-01 21:06 UTC
Requires
- php: >=8.0
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 网站上注册并激活。
许可证
瓦克夫通用公共许可证