laravel-lib/onewaysms

Laravel 的 OneWaySMS 通知渠道

v1.0.0 2022-05-29 01:22 UTC

This package is auto-updated.

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


README

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

📲 此包使得使用 OneWaySMS 在 Laravel 6.x、7.x、8.x 和 9.x 中发送通知(短信)变得简单

内容

安装

您可以通过 composer 安装此包

composer require laravel-lib/onewaysms

设置 OneWaySMS 服务

将您的 OneWaySMS API 账户和设置添加到您的 config/services.php 文件中

// config/services.php

'onewaysms' => [
    'username' => env('SMS_USERNAME', 'YOUR USERNAME HERE'),
    'password' => env('SMS_PASSWORD', 'YOUR PASSWORD HERE'),
    'endpoint' => env('SMS_ENDPOINT', 'https://gateway.onewaysms.com.my/api.aspx'),
    'sender' => env('SMS_SENDER', 'YOUR SENDER ID')
],

使用方法

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

use Illuminate\Notifications\Notification;
use NotificationChannels\Onewaysms\OnewaysmsMessage;

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

    public function toOnewaysms($notifiable)
    {
        return (new OnewaysmsMessage)->content("Your account has been successfully approved !");
    }
}

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

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

按需通知

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

Notification::route('onewaysms', '+60123456789')                      
            ->notify(new InvoicePaid($invoice));

可用的消息方法

to():设置接收者的手机号。

from():设置发送者 ID。

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

变更日志

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

测试

$ composer test

安全

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

贡献

有关详细信息,请参阅 CONTRIBUTING

致谢

许可证

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