edemsky/sms-ru

Laravel 5.3 的短信通知通道。

v0.1-beta.9 2024-03-04 12:48 UTC

This package is auto-updated.

Last update: 2024-09-04 13:46:04 UTC


README

Latest Version on Packagist Software License Total Downloads

此包使得使用 Laravel 5.3+ 发送通知变得简单。

内容

安装

使用 Composer 安装此包

composer require require edemsky/sms-ru

如果您正在使用 Laravel 5.x,您还需要指定版本约束条件

composer require edemsky/sms-ru

服务提供程序将自动加载。或者您可以手动操作

// config/app.php
'providers' => [
    ...
    NotificationChannels\SmsBee\SmsServiceProvider::class,
],

设置 SmscRu 服务

将您的 SmscRu 登录、密钥(哈希密码)和默认发送者名称(或电话号码)添加到您的 config/services.php

// config/services.php
...
'sms' => [
    'login'  => env('SMS_LOGIN'),
    'secret' => env('SMS_SECRET'),
    'sender' => 'John_Doe',
    'extra'  => [
        // any other API parameters
        // 'tinyurl' => 1
    ],
],
...

如果您想使用除了 sms 之外的其他主机,您必须设置带有尾部斜杠的自定义主机。

// .env
...
SMSCRU_HOST=http://www.sms.kz/
...
// config/services.php
...
'sms' => [
    ...
    'host' => env('SMSCRU_HOST'),
    ...
],
...

用法

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

use Illuminate\Notifications\Notification;
use NotificationChannels\SmsBee\SmsMessage;
use NotificationChannels\SmsBee\SmsChannel;

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

    public function toSms($notifiable)
    {
        return SmsMessage::create("Task #{$notifiable->id} is complete!");
    }
}

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

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

可用方法

from():设置发送者的名称或电话号码。

content():设置通知消息的内容。

sendAt():设置计划发送通知消息的时间。

变更日志

请参阅 CHANGELOG 了解最近更改的更多信息。

测试

$ composer test

安全

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

贡献

请参阅 CONTRIBUTING 了解详细信息。

鸣谢

许可证

MIT 许可证 (MIT)。请参阅 许可证文件 了解更多信息。