README

SSL Wireless SMS Laravel 扩展包

一个用于将 SSL Wireless SMS 服务集成到您的 Laravel 应用程序中的 Laravel 扩展包。使用此扩展包可以轻松发送单个、批量或动态短信消息。

功能

• 单个短信：向一个电话号码发送单个短信消息。
• 批量短信：在一个请求中向多个电话号码发送短信消息。
• 动态短信：发送具有不同内容的动态短信消息。

目录

• 安装
• 配置
• 使用
• 作者
• 贡献
• 许可证

要求

• PHP >= 8.0
• Laravel >= 10

安装

1. 通过 Composer 安装包

   composer require kssadi/sslwirelesssms

2. 发布配置文件

   php artisan vendor:publish --provider="KsSadi\SSLWirelessSMS\SSLWirelessSMSServiceProvider" --tag="config"

   这会将 sslwireless.php 配置文件发布到您的 config 目录。

配置

将您的 SSL Wireless SMS 凭证添加到 config/sslwireless.php 文件

return [
    'api_token' => env('SSLWIRELESS_API_TOKEN', ''),
    'sid' => env('SSLWIRELESS_SID', ''),
    'domain' => env('SSLWIRELESS_DOMAIN', 'https://smsplus.sslwireless.com'),
    'message_type' => env('SSLWIRELESS_MESSAGE_TYPE', 'EN'),
];

将这些值添加到您的 .env 文件

SSLWIRELESS_API_TOKEN=your_api_token
SSLWIRELESS_SID=your_sid

使用

使用此扩展包，您可以通过统一的 sendSms() 方法发送单个、批量或动态短信消息。此方法通过处理所有类型的短信来简化过程。如果您愿意，您也可以为每种类型的短信使用单独的方法。

统一短信发送

sendSms() 方法允许您使用单个函数发送不同类型的短信，具体取决于您提供的数据

单个短信：向一个电话号码发送单个短信消息。
批量短信：向多个电话号码发送相同的短信消息。
动态短信：向多个电话号码发送不同的短信消息。

示例：发送单个短信

use KsSadi\SSLWirelessSMS\Facades\SSLWirelessSMS;

$response = SSLWirelessSMS::sendSms([
'phoneNumber' => '1234567890',
'messageBody' => 'Hello World'
], 'txn123');

示例：发送批量短信

use KsSadi\SSLWirelessSMS\Facades\SSLWirelessSMS;

$response = SSLWirelessSMS::sendSms([
    'phoneNumbers' => ['1234567890', '0987654321'],
    'messageBody' => 'Hello, this is a test message for bulk SMS.'
], 'batch123');

示例：发送动态短信

use KsSadi\SSLWirelessSMS\Facades\SSLWirelessSMS;

$response = SSLWirelessSMS::sendSms([
    'messages' => [
        ['phoneNumber' => '1234567890', 'message' => 'Hello, User 1!', 'sms_id' => 'sms1'],
        ['phoneNumber' => '0987654321', 'message' => 'Hello, User 2!', 'sms_id' => 'sms2']
    ]
]);

单独的方法

如果您希望为每种类型的短信使用单独的方法，可以按照以下方式进行

sendSingleSms(): 发送单个短信消息。
sendBulkSms(): 向多个电话号码发送短信消息。
sendDynamicSms(): 向多个电话号码发送不同的短信消息。

示例：发送单个短信

use KsSadi\SSLWirelessSMS\Facades\SSLWirelessSMS;

$response = SSLWirelessSMS::sendSingleSms('1234567890', 'Hello, world!', 'TX123');

示例：发送批量短信

use KsSadi\SSLWirelessSMS\Facades\SSLWirelessSMS;

$phoneNumbers = ['1234567890', '0987654321'];
$response = SSLWirelessSMS::sendBulkSms($phoneNumbers, 'Hello, world!', 'TX123');

示例：发送动态短信

use KsSadi\SSLWirelessSMS\Facades\SSLWirelessSMS;

$messageData = [
    [
        'phone_number' => '1234567890',
        'message' => 'Hello, John!',
        "sms_id" => uniqid() //must be unique
    ],
    [
        'phone_number' => '0987654321',
        'message' => 'Hello, Jane!',
        "sms_id" => uniqid() //must be unique
    ]
];

$response = SSLWirelessSMS::sendDynamicSms($messageData);

作者

姓名： Khaled Saifullah Sadi
电子邮件： mdsadi4@gmail.com

社交媒体

贡献

请随时为此扩展包做出贡献并提交拉取请求。

许可证

此扩展包是开源软件，采用 MIT 许可证。

关键部分

• 功能：突出扩展包的功能。
• 目录：提供易于导航的概述。
• 安装：安装扩展包的说明。
• 配置：设置配置的详细信息。
• 使用：使用扩展包函数的示例。
• 测试：运行测试的说明。
• 作者：有关扩展包作者的说明。
• 贡献：贡献到项目的指南。
• 许可证：有关扩展包许可的说明。

根据您的特定用例或额外功能，请随时调整内容。

版权所有 2024 Khaled Saifullah Sadi