hmoradian/fhsms

FHCo Sms 的简单 API 扩展,用于发送短信

dev-master 2023-04-29 11:21 UTC

This package is auto-updated.

Last update: 2024-09-29 14:22:03 UTC


README

FhSms API for send text messages v0.1.1

此包允许连接 FhSms API 到使用 composer 和 PSR-4 标准自动加载类的框架,例如 (Laravel, Yii, symfony)。
如需更多信息或咨询,请致电 09132101417(哈希姆·莫拉迪安)。期待您的宝贵建议。

内容

安装和配置

您可以使用 composer 安装此服务

composer require hmoradian/fhsms

使用方法

请根据以下代码输入标识符、密码和发送者电话号码的设置

$user_name = '*******';
$password = '*******';
$phone_number = '*******';;
$sms = new \Hmoradian\FhSms\Sms($user_name, $password, $phone_number);

方法

1- 发送短信方法(一短信多号码)

sendSms($reciver_numbers, $text_message)

示例
echo $sms->sendSms('0936*******','Test Message');
...
echo $sms->sendSms(['0936*******', '091********'],'Test Message');

2- 发送短信方法(多短信多号码)

sendSms2(array $reciver_numbers, array $text_messages)

示例
echo $sms->sendSms2(['0936*******', '091********'],['Test Message 1', 'Test Message 2']);

3- 获取账户信息方法

getData()

示例
echo $sms->getData();

4- 获取短信发送状态方法

getStatus($unique_id)

示例
echo $sms->getStatus('536221499');

5- 获取接收到的短信方法

getMessages()

示例
echo $sms->getMessages();

Laravel

在 Laravel 中的配置

在安装包后,请根据以下修改 env. 文件,并在其中输入您在短信系统中的用户账户的相关设置(第三个键值是发送者的电话号码)
// .env
...
FHSMS_BASE_URL=*******
FHSMS_USERNAME=*******
FHSMS_PASSWORD=*******
FHSMS_PHONE_NUMBER=*******
...
当然,您也可以编辑包中现有的配置文件,或者将其发布到项目的配置目录中,并直接替换 env. 文件中的值,而无需输入到 env. 文件中
// config/fhsms.php
...
    'services' => [
        'base_url' => env('FHSMS_BASE_URL'),
        'user_name' => env('FHSMS_USERNAME'),
        'password' => env('FHSMS_PASSWORD'),
        'phone_number' => env('FHSMS_PHONE_NUMBER'),
    ],
...
如果您使用的是低于 5.5 的版本,请将下面的 providers 和 aliases 添加到 config/app.php 文件中
// config/app.php
...
'providers':
Hmoradian\FhSms\FhSmsServiceProvider::class,
...
'aliases':
'FhSms' => Hmoradian\FhSms\Facades\FhSms::class,
...

在 Laravel 中的使用方法

现在您可以通过 Facade 使用此包(FhSms)来访问包中的方法
echo  FhSms::sendSms('0936*******','Test Message');
   ...   
   
echo  FhSms::sendSms2(['0936*******'],['Welcome ...']);
   ...
   
$result = FhSms::getStatus('536221499');
if($result['result']['statusId'] === 4){
   ///
}else{
  ///
}
   ...   
   
echo  FhSms::getData();
   ...

在 Laravel 系统通知中的使用

制作人

许可证

此包的许可证是 MIT。有关许可证的详细信息,请参阅 许可证文件