dash8x/dhiraagu-sms-notification

Dhiraagu批量短信网关的Laravel通知频道

v0.5.0 2024-04-14 10:05 UTC

This package is auto-updated.

Last update: 2024-09-14 11:01:07 UTC


README

Latest Version on Packagist Software License Build Status StyleCI SensioLabsInsight Quality Score Code Coverage Total Downloads

此包使得使用Dhiraagu批量短信网关在Laravel 5.3中发送通知变得简单。

内容

安装

您可以通过composer安装此包

composer require dash8x/dhiraagu-sms-notification

添加服务提供者(仅在Laravel 5.4或更低版本中需要)

// config/app.php
'providers' => [
    ...
    Dash8x\DhiraaguSmsNotification\DhiraaguSmsNotificationServiceProvider::class,
],

可选地添加外观。

// config/app.php
'aliases' => [
    ...
    'DhiraaguSms' => Dash8x\DhiraaguSmsNotification\Facades\DhiraaguSms::class,
],

设置Dhiraagu批量短信网关凭证

将您的Dhiraagu批量短信网关账户用户名、密码和URL(可选)添加到您的config/services.php

// config/services.php
...
'dhiraagu' => [
    'username' => env('DHIRAAGU_SMS_USERNAME'), // Bulk SMS gateway username, usually same as your sender name 
    'password' => env('DHIRAAGU_SMS_PASSWORD'), // Bulk SMS gateway password
    'url' => env('DHIRAAGU_SMS_URL'), // optional, use only if you need to override the default,
                                      // defaults to https://bulkmessage.dhiraagu.com.mv/partners/xmlMessage.jsp   
],
...

用法

现在您可以在通知内的via()方法中使用该通道

use Dash8x\DhiraaguSmsNotification\DhiraaguSmsNotificationChannel;
use Illuminate\Notifications\Notification;

class AccountApproved extends Notification
{
    public function via($notifiable)
    {
        return [DhiraaguSmsNotificationChannel::class];
    }

    public function toDhiraagu($notifiable)
    {
        return "Your {$notifiable->service} account was approved!";
    }
}

为了让您的通知知道您要发送给哪个电话,该通道将查找Notifiable模型的phone_number属性。如果您想覆盖此行为,请将routeNotificationForDhiraagu方法添加到您的Notifiable模型中。

public function routeNotificationForDhiraagu()
{
    return '+9607777777';
}

它还支持向多个电话号码发送。

public function routeNotificationForDhiraagu()
{
    return ['+9607777777', '+9609999999'];
}

可用的消息方法

DhiraaguSmsNotificationMessage

  • setNumbers(''):接受用作通知收件人的电话号码。
  • setMessage(''):接受用作通知主体的字符串值。
  • getNumbers():返回收件人。
  • getMessage():返回通知主体的字符串值。

检查投递状态

要处理任何Laravel通知通道响应,请检查Laravel通知事件 此通道返回一个DhiraaguSmsMessage响应对象。

有关投递状态检查的文档,请参阅dash8x/dhiraagu-sms

变更日志

有关最近更改的更多信息,请参阅CHANGELOG

测试

$ composer test

安全

如果您发现任何安全相关的问题,请通过电子邮件arushad@javaabu.com联系,而不是使用问题跟踪器。

贡献

有关详细信息,请参阅CONTRIBUTING

致谢

许可

MIT许可(MIT)。有关更多信息,请参阅许可文件

免责声明

此包与Dhiraagu没有任何官方联系。已使用“Dhiraagu”名称进行公平使用。