grantholle/aliyun-sms-notification-channel

Aliyun SMS Notification Channel for Laravel.

2.4.0 2024-03-29 14:17 UTC

This package is auto-updated.

Last update: 2024-10-29 15:27:51 UTC


README

A Laravel notification channel for Aliyun's SMS product.

Installation

composer require grantholle/aliyun-sms-notification-channel

Configuration

It's preferred to include sensitive keys and secrets in the .env file so that the information is not included in source control.

In your .env file, add some keys:

ALIYUN_SMS_AK=XXXXXXXXXX
ALIYUN_SMS_AS=XXXXXXXXXX
ALIYUN_SMS_SIGN_NAME=名字

In config/services.php, add the following:

'aliyun_sms' => [
    'key' => env('ALIYUN_SMS_AK'),
    'secret' => env('ALIYUN_SMS_AS'),
    'sign' => env('ALIYUN_SMS_SIGN_NAME'),
],

Usage

During Development

When developing your application, it may be a good idea to prevent accidentally sending SMS messages to real phone numbers. To safeguard against this, you can use the alwaysTo function for non-production environments.

Add this snippet in your AppServiceProvider to prevent spamming real people.

use GrantHolle\Notifications\Channels\AliyunSmsChannel;

class AppServiceProvider extends ServiceProvider
{
    public function boot()
    {
        if (!app()->environment('production')) {
            AliyunSmsChannel::alwaysTo('your-phone-number');
        }
    }
}

Create the Notification

Generate a new notification for your application.

php artisan make:notification OrderPaid

Add the aliyun channel and the toAliyunSms() function to generate the Aliyun message. There is the template() function to set the template ID of this message, as well as a data() function to set the placeholders in the template.

<?php

namespace App\Notifications;

use Illuminate\Notifications\Notification;
use GrantHolle\Notifications\Messages\AliyunMessage;
use App\Order;

class OrderPaid extends Notification
{
    protected $order;

    /**
     * Create a new notification instance.
     *
     * @return void
     */
    public function __construct(Order $order)
    {
        $this->order = $order;
    }

    /**
     * Get the notification's delivery channels.
     *
     * @param  mixed  $notifiable
     * @return array
     */
    public function via($notifiable)
    {
        return ['aliyun'];
    }

    /**
     * Get the Aliyun SMS representation of the notification.
     *
     * @param  mixed  $notifiable
     * @return \GrantHolle\Notifications\Messages\AliyunMessage
     */
    public function toAliyunSms($notifiable)
    {
        return (new AliyunMessage)
            ->template('SMS_XXXXXXX')
            ->data([
                'order_no' => $this->order->order_no,
                'total' => $this->order->total,
            ]);
    }
}

Routing the Notification

Following the documentation, this assumes we're using the User model. We need to add the Notifiable trait and the routeNotificationForAliyun() function to return the phone number.

<?php

namespace App;

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

class User extends Authenticatable
{
    use Notifiable;

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

Sending the Notification

Now in our application we can send the notification. Refer to the documentation for information on queues.

use App\Notifications\OrderPaid;

$user->notify(new OrderPaid($order));