lumecent/smsc-ru

SmscRu 通知通道,适用于 Laravel 5.3。

1.0.1 2024-05-03 15:16 UTC

This package is auto-updated.

Last update: 2024-09-03 16:08:59 UTC


README

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

本包使得使用smsc.ru(又名 СМС–Центр)在Laravel 5.3+中发送通知变得简单。

内容

安装

使用Composer安装此包

composer require laravel-notification-channels/smsc-ru

如果你使用Laravel 5.x,还需要指定版本约束

composer require laravel-notification-channels/smsc-ru -v 2.0.3

服务提供者会自动加载。或者你可以手动进行

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

配置SmscRu服务

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

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

如果你想使用除smsc.ru之外的其他主机,你必须设置带有尾斜杠的自定义主机。

// .env
...
SMSCRU_HOST=http://www1.smsc.kz/
...
// config/services.php
...
'smscru' => [
    ...
    'host' => env('SMSCRU_HOST'),
    ...
],
...

使用方法

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

use Illuminate\Notifications\Notification;
use NotificationChannels\SmscRu\SmscRuMessage;
use NotificationChannels\SmscRu\SmscRuChannel;

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

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

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

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

可用方法

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

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

sendAt():设置安排通知消息的时间。

更新日志

请查看更新日志了解最近的变化。

测试

$ composer test

安全

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

贡献

请查看贡献指南了解详细信息。

致谢

许可

MIT许可(MIT)。请参阅许可文件以获取更多信息。