ossycodes/nigeriabulksms

该软件包使您能够通过Laravel轻松地使用Nigeriabulksms发送通知

v2.2.0 2023-09-21 17:56 UTC

This package is auto-updated.

Last update: 2024-09-22 15:43:56 UTC


README

Latest Version on Packagist Total Downloads

该软件包使您能够使用Laravel 5及以上版本通过Nigeriabulksms发送通知变得简单

内容

关于

该软件包使您能够通过Nigeriabulksms API将Laravel通知作为短信发送出去。

安装

您可以通过composer安装此软件包

composer require ossycodes/nigeriabulksms

服务提供者会自动加载。

设置Nigeriabulksms服务

您需要注册以获取您的用户名和密码。将它们放在您的.env文件中。请记住添加您将用于发送消息的发送者ID。

NIGERIABULKSMS_USERNAME=""
NIGERIABULKSMS_PASSWORD=""
NIGERIABULKSMS_SENDER=""

要加载它们,请将以下内容添加到您的config/services.php中。这将从.env文件中加载Nigeriabulksms数据。

'nigeriabulksms' => [
    'username'      => env('NIGERIABULKSMS_USERNAME'),
    'password'      => env('NIGERIABULKSMS_PASSWORD'),
    'sender'        => env('NIGERIABULKSMS_SENDER'),
]

在您的可通知模型上添加routeNotifcationForNigeriabulksms方法。

<?php

namespace App;

use Illuminate\Notifications\Notifiable;
use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable
{
    use Notifiable;

    /**
     * Route notifications for the Nigeriabulksms channel.
     *
     * @param  \Illuminate\Notifications\Notification  $notification
     * @return string
     */
    public function routeNotificationForNigeriabulksms($notification)
    {
        return $this->phone;
    }
}

用法

要使用此软件包,您需要在您的Laravel应用程序中创建一个通知类,例如下面的NewsWasPublished,确保查看Laravel的文档以了解此过程。

<?php

use NotificationChannels\Nigeriabulksms\NigeriabulksmsChannel;
use NotificationChannels\Nigeriabulksms\NigeriabulksmsMessage;

class NewsWasPublished extends Notification
{
    /**
     * Get the notification's delivery channels.
     *
     * @param  mixed  $notifiable
     * @return array
     */
    public function via($notifiable)
    {
        return [NigeriabulksmsChannel::class];
    }

    public function toNigeriabulksms($notifiable)
    {
		return (new NigeriabulksmsMessage())
                    ->setContent('Your SMS message content');

    }
}

此外,您可以添加收件人(消息将被发送的电话号码)(单个值或数组)

return (new NigeriabulksmsMessage("Your {$notifiable->service} was ordered!"))->setRecipients($recipients);

您还可以添加发送通知(短信)的发送者,这将覆盖您的.env中的NIGERIABULKSMS_SENDER=""

return (new NigeriabulksmsMessage("Your {$notifiable->service} was ordered!"))->setFrom("name of your app");

如果从Nigeriabulksms服务收到错误,请查看Nigeriabulksms开发者门户上的API错误代码

安全

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

贡献

有关详细信息,请参阅CONTRIBUTING

致谢

许可

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

如何表达感谢?

留下一个星级,并关注我的Twitter