README

这是一个提供通过Jormall SMS网络服务发送短信的简单方法的Symfony扩展包。

功能

• 使用Jormall SMS API发送短信消息。
• 获取账户余额。
• 优雅地处理连接和请求错误。

要求

• PHP 8.2或更高版本
• GuzzleHttp 7.8或更高版本
• Symfony Framework Bundle 7.0或更高版本
• 用户必须拥有JorMall的有效短信账户
• 短信账户必须有短信余额。
• 在此网络服务中使用的发送者必须在JorMall注册后才能使用。

安装

将以下内容添加到您的composer.json

"require": {
    "extendy/jormall-sms-bundle": "0.0.0-beta.1"
}

或者通过运行

composer require extendy/jormall-sms-bundle

编辑您的.env文件并添加以下内容（并用您的Jormall短信账户详情替换值）

JORMALLSMS_SENDERID=SENDERNAME
JORMALLSMS_ACCNAME=ACCOUNTUSERNAME
JORMALLSMS_ACCPASS=ACCOUNTPASSWORD

用法

您可以使用JormallSmsService服务来发送短信消息或获取余额。以下是一个示例（在控制器中使用时）

<?php

namespace App\Controller;

use Extendy\JormallSmsBundle\Service\JormallSmsService;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;

class TestController extends AbstractController
{
    private $jormallSmsService;

    public function __construct(JormallSmsService $jormallSmsService)
    {
        $this->jormallSmsService = $jormallSmsService;
    }


    #[Route('/test', name: 'app_test')]
    public function index()
    {
        $msg = "Hello, this is a test message";
        // send sms
        dd($this->jormallSmsService->sendSms("962777774221", $msg, "1"));

    }

    #[Route('/test/balance', name: 'app_test_balance')]
    public function balance()
    {
        // get sms balance
        dd($this->jormallSmsService->getBalance());

    }

}

许可

本软件包采用MIT许可证。有关详细信息，请参阅LICENSE文件。