Smspoh 通知渠道,适用于 Laravel 9.x 和 10.x。

v1.5.0 2024-04-07 14:13 UTC

This package is auto-updated.

Last update: 2024-09-10 03:49:16 UTC


README

Latest Version on Packagist Total Downloads GitHub Tests Action Status Software License

此包使得使用 Laravel 和 9.x、10.x 版本发送通知变得简单,通过 SmsPoh

内容

安装

您可以通过 composer 安装此包

composer require laravel-notification-channels/smspoh

设置 Smspoh 服务

将您的 Smspoh 令牌和默认发送者名称(或电话号码)添加到 config/services.php 文件中

// config/services.php
...
'smspoh' => [
    'endpoint' => env('SMSPOH_ENDPOINT', 'https://smspoh.com/api/v2/send'),
    'token' => env('SMSPOH_TOKEN', 'YOUR SMSPOH TOKEN HERE'),
    'sender' => env('SMSPOH_SENDER', 'YOUR SMSPOH SENDER HERE')
],
...

使用

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

use Illuminate\Notifications\Notification;
use NotificationChannels\Smspoh\SmspohMessage;

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

    public function toSmspoh($notifiable)
    {
        return (new SmspohMessage)->content("Your account was approved!");       
    }
}

在您的可通知模型中,确保包含一个 routeNotificationForSmspoh() 方法,该方法返回一个电话号码或电话号码数组。

public function routeNotificationForSmspoh()
{
    return $this->phone;
}

按需通知

有时您可能需要向非“用户”发送通知。使用 Notification::route 方法,您可以在发送通知之前指定临时的通知路由信息

Notification::route('smspoh', '5555555555')                      
            ->notify(new InvoicePaid($invoice));

可用的消息方法

sender(): 设置发送者的名称。 请确保在您的 SmsPoh 控制台中注册发送者名称。

content(): 设置通知消息的内容。此参数不应超过 918 个字符(6 个消息部分)

test(): 是否向特定的手机号码发送测试消息。此参数应为布尔值,默认值为 true

测试

$ composer test

变更日志

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

贡献

有关详细信息,请参阅 CONTRIBUTING

安全漏洞

请查看我们如何报告安全漏洞的 安全策略

致谢

许可

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