版本：5.5

Laravel 的消息通知系统

简介

除了发送邮件，Laravel 还支持通过多种频道发送通知，包括邮件、短信（通过 Nexmo）以及 Slack 。通知还能存到数据库，这样就能在网页界面上显示了。

通常情况下，通知应该是简短、有信息量的消息来通知用户你的应用发生了什么。举例来说，如果你在编写一个在线交易应用，你应该会通过邮件和短信频道来给用户发送一条「账单已付」的通知。

创建通知

Laravel 中一条通知就是一个类（通常存在 app/Notifications 文件夹里）。看不到的话不要担心，运行一下 make:notification 命令就能创建了：

php artisan make:notification InvoicePaid

这个命令会在 app/Notifications 目录下生成一个新的通知类。这个类包含 via 方法和几个消息构建方法（比如 toMail 或 toDatabase），它们会针对指定的渠道把通知转换过为对应的消息。

发送通知

使用 Notifiable Trait

通知可以通过两种方法发送： Notifiable trait 的 notify 方法或 Notification facade 。首先，让我们探索使用 trait ：

<?php

namespace App;

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

class User extends Authenticatable
{
    use Notifiable;
}

默认的 App\User 模型中使用了这个 trait，它包含着一个可以用来发通知的方法：notify 。 notify 方法需要一个通知实例做参数：

use App\Notifications\InvoicePaid;

$user->notify(new InvoicePaid($invoice));

提示

记住，你可以在任意模型中使用 Illuminate\Notifications\Notifiable trait，而不仅仅是在 User 模型中。

使用 Notification Facade

另外，你可以通过 Notification facade 来发送通知。它主要用在当你给多个可接收通知的实体发送通知的时候，比如给用户集合发通知。要用 facade 发送通知的话，要把可接收通知的实体和通知的实例传递给 send 方法：

Notification::send($users, new InvoicePaid($invoice));

指定发送频道

每个通知类都有个 via 方法，它决定了通知在哪个频道上发送。开箱即用的通知频道有 mail, database, broadcast, nexmo, 和 slack 。

提示

如果你想用其他的频道比如 Telegram 或者 Pusher ，可以去看下社区驱动的 Laravel 通知频道网站。

via 方法受到一个 $notifiable 实例，它是接收通知的类实例。你可以用 $notifiable 来决定通知用哪个频道来发送：

/**
 * 获取通知发送频道
 *
 * @param  mixed  $notifiable
 * @return array
 */
public function via($notifiable)
{
    return $notifiable->prefers_sms ? ['nexmo'] : ['mail', 'database'];
}

队列化通知

备注

在队列化通知前你需要配置队列，并运行队列处理器。

发送通知可能会花很长时间，尤其是发送频道需要调用外部 API 的时候。要加速应用响应的话，可以通过添加 ShouldQueue 接口和 Queueable trait 把通知加入队列。它们两个在使用 make:notification 命令来生成通知文件的时候就已经被导入了，所以你只需要添加到你的通知类就行了：

<?php

namespace App\Notifications;

use Illuminate\Bus\Queueable;
use Illuminate\Notifications\Notification;
use Illuminate\Contracts\Queue\ShouldQueue;

class InvoicePaid extends Notification implements ShouldQueue
{
    use Queueable;

    // ...
}

一旦加入 ShouldQueue 接口，你就能像平常那样发送通知了。Laravel 会检测 ShouldQueue 接口并自动将通知的发送放入队列中。

$user->notify(new InvoicePaid($invoice));

如果你想延迟发送，你可以通过 delay 方法来链式操作你的通知实例：

$when = Carbon::now()->addMinutes(10);

$user->notify((new InvoicePaid($invoice))->delay($when));

按需通知

有时候你可能需要将通知发送给某个不是以”用户”身份存储在你的应用中的人。使用Notification::route 方法，你可以在发送通知之前指定 ad-hoc 通知路由信息：

Notification::route('mail', 'taylor@laravel.com')
            ->route('nexmo', '5555555555')
            ->notify(new InvoicePaid($invoice));

邮件通知

格式化邮件消息

如果一条通知支持以邮件发送，你应该在通知类里定义一个 toMail 方法。这个方法将收到一个 $notifiable 实体并返回一个 Illuminate\Notifications\Messages\MailMessage 实例。邮件消息可以包含多行文本也可以是引导链接。我们来看一个 toMail 方法的例子：

/**
 * 获取通知的邮件展示方式
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\MailMessage
 */
public function toMail($notifiable)
{
    $url = url('/invoice/'.$this->invoice->id);

    return (new MailMessage)
                ->line('One of your invoices has been paid!')
                ->action('View Invoice', $url)
                ->line('Thank you for using our application!');
}

提示

注意我们在方法中用了 $this->invoice->id ，其实你可以传递应用所需要的任何数据来传递给通知的构造器。

在这个例子中，我们注册了一行文本，引导链接，然后又是一行文本。 MailMessage 提供的这些方法简化了对小的事务性的邮件进行格式化操作。邮件频道将会把这些消息组件转换成漂亮的响应式的 HTML 邮件模板并附上文本。下面是个 mail 频道生成的邮件示例：

提示

发送邮件通知前，请在 config/app.php 中设置 name 值。这将会在邮件通知消息的头部和尾部中被使用。

其他通知格式选项

你可以使用 view 方法来指定一个应用于渲染通知电子邮件的自定义模板，而不是在通知类中定义文本的「模板」：

/**
 * 获取通知的邮件展示方式
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\MailMessage
 */
public function toMail($notifiable)
{
    return (new MailMessage)->view(
        'emails.name', ['invoice' => $this->invoice]
    );
}

另外，你可以从 toMail 方法中返回一个 mailable 对象：

use App\Mail\InvoicePaid as Mailable;

/**
 * 获取通知的邮件展示方式
 *
 * @param  mixed  $notifiable
 * @return Mailable
 */
public function toMail($notifiable)
{
    return (new Mailable($this->invoice))->to($this->user->email);
}

错误消息

有些通知是给用户提示错误，比如账单支付失败的提示。你可以通过调用 error 方法来指定这条邮件消息被当做一个错误提示。当邮件消息使用了 error 方法后，引导链接按钮会变成红色而非蓝色：

/**
 * 获取通知的邮件展示方式
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\MailMessage
 */
public function toMail($notifiable)
{
   return (new MailMessage)
                ->error()
                ->subject('Notification Subject')
                ->line('...');
}

自定义接收者

当通过 mail 频道来发送通知的时候，通知系统将会自动寻找你的 notifiable 实体中的 email 属性。你可以通过在实体中定义 routeNotificationForMail 方法来自定义邮件地址。

<?php

namespace App;

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

class User extends Authenticatable
{
    use Notifiable;

    /**
     * 邮件频道的路由
     *
     * @return string
     */
    public function routeNotificationForMail()
    {
        return $this->email_address;
    }
}

自定义主题

默认情况下，邮件主题是格式化成了标题格式的通知类的类名。所以如果你对通知类名为 InvoicePaid ，邮件主题将会是 Invoice Paid 。如果你想显式指定消息的主题，你可以在构建消息时调用 subject 方法：

/**
 * 获取通知的邮件展示方式
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\MailMessage
 */
public function toMail($notifiable)
{
    return (new MailMessage)
                ->subject('Notification Subject')
                ->line('...');
}

自定义模板

你可以通过发布通知包的资源来修改 HTML 模板和纯文本模板。运行这个命令后，邮件通知模板就被放在了 resources/views/vendor/notifications 文件夹下：

php artisan vendor:publish --tag=laravel-notifications

Markdown 邮件通知

Markdown 邮件通知可让您利用邮件通知的预先构建的模板，同时给予您更多自由地撰写更长的自定义邮件。由于消息是用 Markdown 编写的， Laravel 能够为消息呈现漂亮，响应的 HTML 模板，同时还自动生成纯文本对应。

生成消息

要使用相应的 Markdown 模板生成通知，您可以使用 make：notification Artisan命令的 --markdown 选项：

php artisan make:notification InvoicePaid --markdown=mail.invoice.paid

与所有其他邮件通知一样，使用 Markdown 模板的通知应在其通知类上定义一个 toMail 方法。但是，不使用 line 和 action 方法来构造通知，而是使用 markdown 方法来指定应该使用的 Markdown 模板的名称：

/**
 * 获取通知的邮件展示方式
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\MailMessage
 */
public function toMail($notifiable)
{
    $url = url('/invoice/'.$this->invoice->id);

    return (new MailMessage)
                ->subject('Invoice Paid')
                ->markdown('mail.invoice.paid', ['url' => $url]);
}

写消息

Markdown 邮件通知使用 Blade 组件和Markdown语法的组合，允许您轻松构建通知，同时利用Laravel的预制通知组件：

@component('mail::message')
# Invoice Paid

Your invoice has been paid!

@component('mail::button', ['url' => $url])
View Invoice
@endcomponent

Thanks,<br>
{{ config('app.name') }}
@endcomponent

按钮组件

按钮组件渲染了一个居中的链接按钮。组件有两个参数， url 和一个可选的参数 color 。支持的颜色有 blue ， green ，和 red 。你可以根据你的需要向通知中添加任意数量的按钮组件：

@component('mail::button', ['url' => $url, 'color' => 'green'])
View Invoice
@endcomponent

面板组件

面板部件在面板中呈现给定文本块，该面板具有与通知的其余部分稍微不同的背景颜色。这将会允许你将给定的文本块引起注意：

@component('mail::panel')
This is the panel content.
@endcomponent

表格组件

表格组件允许你将一个 Markdown 表格转化成一个 HTML 表格。表格组件接受 Markdown 表格作为内容。支持使用默认的 Markdown 表格对齐语法使表列对齐：

@component('mail::table')
| Laravel       | Table         | Example  |
| ------------- |:-------------:| --------:|
| Col 2 is      | Centered      | $10      |
| Col 3 is      | Right-Aligned | $20      |
@endcomponent

自定义组件

您可以将所有 Markdown 通知组件导出到您自己的应用程序中进行自定义。要导出组件，请使用 vendor：publish Artisan命令来发布 laravel-mail 标签：

php artisan vendor:publish --tag=laravel-mail

此命令将 Markdown 邮件组件发布到 resources/views/vendor/mail 目录。 mail 目录将包含一个 html 和一个 markdown 目录，每个目录包含它们各自可用组件的展示方式。您可以随意自定义这些组件。

自定义CSS

导出组件后， resources/views/vendor/mail/html/themes 目录将包含一个 default.css 文件。您可以在此文件中自定义 CSS ，并且您的样式将自动内嵌在 Markdown 通知的HTML展示中。

提示

如果您想为 Markdown 组件构建一个全新的主题，只需在 html/themes 目录中写一个新的 CSS 文件，并更改 mail 配置文件中的 theme 选项。

数据库通知

先决条件

database 通知频道在一张数据表里存储通知信息。这张表包含了比如通知类型、JSON 格式数据等描述通知的信息。

你可以查询这张表的内容在应用界面上展示通知。但是在这之前，你需要先创建一个数据表来保存通知。你可以用 notifications:table 命令来生成迁移表：

php artisan notifications:table

php artisan migrate

格式化数据库通知

如果通知支持被存储到数据表中，你应该在通知类中定义一个 toDatabase 或 toArray 方法。这个方法接收 $notifiable 实体参数并返回一个普通的 PHP 数组。这个返回的数组将被转成 JSON 格式并存储到通知数据表的 data 列。我们来看一个 toArray 的例子：

/**
 * 获取通知的数组展示方式
 *
 * @param  mixed  $notifiable
 * @return array
 */
public function toArray($notifiable)
{
    return [
        'invoice_id' => $this->invoice->id,
        'amount' => $this->invoice->amount,
    ];
}

`toDatabase` Vs `toArray`

toArray 方法在 broadcast 频道也用到了，它用来决定广播给 JavaScript 客户端的数据。如果你想在 database 和 broadcast 频道中采用两种不同的数组展示方式，你应该定义 toDatabase 方法而非 toArray 方法。

访问通知

一旦通知被存到数据库中，你需要一种方便的方式来从通知实体中访问它们。 Illuminate\Notifications\Notifiable trait 包含一个可以返回这个实体所有通知的 notifications Eloquent 关联。要获取这些通知，你可以像用其他 Eloquent 关联一样来使用这个方法。默认情况下，通知将会以 created_at 时间戳来排序：

$user = App\User::find(1);

foreach ($user->notifications as $notification) {
    echo $notification->type;
}

如果你只想检索未读通知，你可以使用 unreadNotifications 关联。检索出来的通知也是以 created_at 时间戳来排序的：

$user = App\User::find(1);

foreach ($user->unreadNotifications as $notification) {
    echo $notification->type;
}

提示

要从 JavaScript 客户端来访问通知的话，你应该定义一个通知控制器来给可通知的实体返回通知，比如给当前用户返回通知。然后你就可以在 JavaScript 客户端来发起对应 URI 的 HTTP 请求了。

标为已读

通常情况下，当用户查看了通知时，你就希望把通知标为已读。Illuminate\Notifications\Notifiable trait 提供了一个 markAsRead 方法，它能在对应的数据库记录里更新 read_at 列：

$user = App\User::find(1);

foreach ($user->unreadNotifications as $notification) {
    $notification->markAsRead();
}

你可以使用 markAsRead 方法直接操作一个通知集合，而不是一条条遍历每个通知：

$user->unreadNotifications->markAsRead();

你可以用批量更新的方式来把所有通知标为已读，而不用在数据库里检索：

$user = App\User::find(1);

$user->unreadNotifications()->update(['read_at' => Carbon::now()]);

当然，你可以通过 delete 通知来把它们从数据库删除：

$user->notifications()->delete();

广播通知

先决条件

在广播通知前，你应该配置并熟悉 Laravel 事件广播服务。事件广播提供了一种 JavaScript 客户端响应服务端 Laravel 事件的机制。

格式化广播通知

broadcast 频道使用 Laravel 事件广播服务来广播通知，它使得 JavaScript 客户端可以实时捕捉通知。如果一条通知支持广播，你应该在通知类里定义一个 toBroadcast 或 toArray 方法。这个方法将收到一个 $notifiable 实体并返回一个普通的 PHP 数组。返回的数组会被编码成 JSON 格式并广播给你的 JavaScript 客户端。我们来看个 toArray 方法的例子：

use Illuminate\Notifications\Messages\BroadcastMessage;

/**
 * 获取通知的数组展示方式
 *
 * @param  mixed  $notifiable
 * @return BroadcastMessage
 */
public function toBroadcast($notifiable)
{
    return new BroadcastMessage([
        'invoice_id' => $this->invoice->id,
        'amount' => $this->invoice->amount,
    ]);
}

广播队列配置

所有广播通知都排队等待广播。如果要配置用于广播队列操作的队列连接或队列名称，你可以使用 BroadcastMessage 的 onConnection 和 onQueue 方法：

return new BroadcastMessage($data)
                ->onConnection('sqs')
                ->onQueue('broadcasts');

提示

除了你指定的数据外，广播通知也包含一个 type 字段，这个字段包含了通知类的类名。

监听通知

通知将会在一个私有频道里进行广播，频道格式为 {notifiable}.{id}。所以，如果你给 ID 为 1 的 App\User 实例发送通知，这个通知就在 App.User.1 私有频道里被发送。当你使用 Laravel Echo 的时候，你可以很简单地使用 notification 辅助函数来监听一个频道的通知：

Echo.private('App.User.' + userId)
    .notification((notification) => {
        console.log(notification.type);
    });

自定义通知通道

如果您想自定义应通知实体接收其广播通知的渠道，您可以定义一个 receiveBroadcastNotificationsOn 方法：

<?php

namespace App;

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

class User extends Authenticatable
{
    use Notifiable;

    /**
     * 用户接收的通知广播
     *
     * @return array
     */
    public function receivesBroadcastNotificationsOn()
    {
        return [
            new PrivateChannel('users.'.$this->id),
        ];
    }
}

短信通知

先决条件

在 Laravel 中发送短信通知是基于 Nexmo 服务的。在通过 Nexmo 发送短信通知前，你需要安装 nexmo/client Composer 包并在 config/services.php 配置文件中添加几个配置选项。你可以复制下面的配置示例来开始使用：

'nexmo' => [
    'key' => env('NEXMO_KEY'),
    'secret' => env('NEXMO_SECRET'),
    'sms_from' => '15556666666',
],

sms_from 选项是短信消息发送者的手机号码。你可以在 Nexmo 控制面板中生成一个手机号码。

格式化短信通知

如果通知支持以短信方式发送，你应该在通知类里定义一个 toNexmo 方法。这个方法将会收到一个 $notifiable 实体并返回一个 Illuminate\Notifications\Messages\NexmoMessage 实例：

/**
 * 获取通知的 Nexmo / 短信展示方式
 *
 * @param  mixed  $notifiable
 * @return NexmoMessage
 */
public function toNexmo($notifiable)
{
    return (new NexmoMessage)
                ->content('Your SMS message content');
}

Unicode 内容

如果您的 SMS 消息包含 unicode 字符，您应该在构建 NexmoMessage 实例时调用 unicode 方法：

/**
 * 获取通知的 Nexmo / 短信展示方式
 *
 * @param  mixed  $notifiable
 * @return NexmoMessage
 */
public function toNexmo($notifiable)
{
    return (new NexmoMessage)
                ->content('Your unicode message')
                ->unicode();
}

自定义 `From` 号码

如果你想通过一个手机号来发送某些通知，而这个手机号不同于你的 config/services.php 配置文件中指定的话，你可以在 NexmoMessage 实例中使用 from：

/**
 * 获取通知的 Nexmo / 短信展示方式
 *
 * @param  mixed  $notifiable
 * @return NexmoMessage
 */
public function toNexmo($notifiable)
{
    return (new NexmoMessage)
                ->content('Your SMS message content')
                ->from('15554443333');
}

路由短信通知

当通过 nexmo 频道来发送通知的时候，通知系统会自动寻找通知实体的 phone_number 属性。如果你想自定义通知被发送的手机号码，你要在通知实体里定义一个 routeNotificationForNexmo 方法。

<?php

namespace App;

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

class User extends Authenticatable
{
    use Notifiable;

    /**
     * Nexmo 频道的路由通知
     *
     * @return string
     */
    public function routeNotificationForNexmo()
    {
        return $this->phone;
    }
}

Slack 通知

先决条件

通过 Slack 发送通知前，你必须通过 Composer 安装 Guzzle HTTP 库：

composer require guzzlehttp/guzzle

你还需要给 Slack 组配置「Incoming Webhook」。它将提供你使用路由 Slack 通知时用到的 URL。

格式化 Slack 通知

如果通知支持被当做 Slack 消息发送，你应该在通知类里定义一个 toSlack 方法。这个方法将收到一个 $notifiable 实体并且返回一个 Illuminate\Notifications\Messages\SlackMessage 实例。Slack 消息可以包含文本内容以及一个「attachment」用来格式化额外文本或者字段数组。我们来看个基本的 toSlack 例子：

/**
 * 获取通知的 Slack 展示方式
 *
 * @param  mixed  $notifiable
 * @return SlackMessage
 */
public function toSlack($notifiable)
{
    return (new SlackMessage)
                ->content('One of your invoices has been paid!');
}

这个例子中，我们只发送了一行文本给 Slack，这会创建类似下面的一条消息：

自定义发件人和收件人

您可以使用 from 和 to 方法来自定义发件人和收件人。 from 方法接受用户名和表情符号标识符，而 to 方法接受一个频道或用户名：

/**
 * 获取通知的 Slack 展示方式
 *
 * @param  mixed  $notifiable
 * @return SlackMessage
 */
public function toSlack($notifiable)
{
    return (new SlackMessage)
                ->from('Ghost', ':ghost:')
                ->to('#other')
                ->content('This will be sent to #other');
}

你也可以不使用表情符号，改为使用图片作为你的 logo：

/**
 * 获取通知的 Slack 展示方式
 *
 * @param  mixed  $notifiable
 * @return SlackMessage
 */
public function toSlack($notifiable)
{
    return (new SlackMessage)
                ->from('Laravel')
                ->image('https://laravel.com/favicon.png')
                ->content('This will display the Laravel logo next to the message');
}

Slack 附加项 (Attachments)

你可以给 Slack 消息添加 "附加项"。附加项提供了比简单文本消息更丰富的格式化选项。在这个例子中，我们将发送一条有关应用中异常的错误通知，它里面有个可以查看这个异常更多详情的链接：

/**
 * 获取通知的 Slack 展示方式。
 *
 * @param  mixed  $notifiable
 * @return SlackMessage
 */
public function toSlack($notifiable)
{
    $url = url('/exceptions/'.$this->exception->id);

    return (new SlackMessage)
                ->error()
                ->content('Whoops! Something went wrong.')
                ->attachment(function ($attachment) use ($url) {
                    $attachment->title('Exception: File Not Found', $url)
                               ->content('File [background.jpg] was not found.');
                });
}

上面这个例子将会生成一条类似下面的 Slack 消息：

附加项也允许你指定一个应该被展示给用户的数据的数组。给定的数据将会以表格样式展示出来，这能方便阅读：

/**
 * 获取通知的 Slack 展示方式
 *
 * @param  mixed  $notifiable
 * @return SlackMessage
 */
public function toSlack($notifiable)
{
    $url = url('/invoices/'.$this->invoice->id);

    return (new SlackMessage)
                ->success()
                ->content('One of your invoices has been paid!')
                ->attachment(function ($attachment) use ($url) {
                    $attachment->title('Invoice 1322', $url)
                               ->fields([
                                    'Title' => 'Server Expenses',
                                    'Amount' => '$1,234',
                                    'Via' => 'American Express',
                                    'Was Overdue' => ':-1:',
                                ]);
                });
}

上面的例子将会生成一条类似下面的 Slack 消息：

Markdown 附件内容

如果一些附件字段包含 Markdown ，您可以使用 markdown 方法指示 Slack 解析并将给定的附件字段显示为 Markdown 格式的文本：

/**
 * 获取通知的 Slack 展示方式
 *
 * @param  mixed  $notifiable
 * @return SlackMessage
 */
public function toSlack($notifiable)
{
    $url = url('/exceptions/'.$this->exception->id);

    return (new SlackMessage)
                ->error()
                ->content('Whoops! Something went wrong.')
                ->attachment(function ($attachment) use ($url) {
                    $attachment->title('Exception: File Not Found', $url)
                               ->content('File [background.jpg] was **not found**.')
                               ->markdown(['title', 'text']);
                });
}

路由 Slack 通知

要把 Slack 通知路由到正确的位置，你要在通知实体中定义 routeNotificationForSlack 方法。它返回通知要被发往的 URL 回调地址。URL 可以通过在 Slack 组里面添加 "Incoming Webhook" 服务来生成。

<?php

namespace App;

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

class User extends Authenticatable
{
    use Notifiable;

    /**
     * Slack 频道的通知路由
     *
     * @return string
     */
    public function routeNotificationForSlack()
    {
        return $this->slack_webhook_url;
    }
}

通知事件

当通知发送后，通知系统就会触发 Illuminate\Notifications\Events\NotificationSent 事件。它包含了「notifiable」实体和通知实例本身。你应该在 EventServiceProvider 中注册监听器：

/**
 * 应用中的事件监听映射
 *
 * @var array
 */
protected $listen = [
    'Illuminate\Notifications\Events\NotificationSent' => [
        'App\Listeners\LogNotification',
    ],
];

提示

注册完监听器后，使用 event:generate Artisan 命令来快速生成监听器类。

在事件监听器中，你可以访问事件中的 notifiable, notification, 和 channel 属性，来了解通知接收者和通知本身：

/**
 * 处理事件
 *
 * @param  NotificationSent  $event
 * @return void
 */
public function handle(NotificationSent $event)
{
    // $event->channel
    // $event->notifiable
    // $event->notification
}

自定义频道

Laravel 提供了开箱即用的通知频道，但是你可能会想编写自己的驱动来通过其他频道发送通知。Laravel 很容易实现。首先，定义一个包含 send 方法的类。这个方法应该收到两个参数：$notifiable 和 $notification:

<?php

namespace App\Channels;

use Illuminate\Notifications\Notification;

class VoiceChannel
{
    /**
     * 发送给定通知
     *
     * @param  mixed  $notifiable
     * @param  \Illuminate\Notifications\Notification  $notification
     * @return void
     */
    public function send($notifiable, Notification $notification)
    {
        $message = $notification->toVoice($notifiable);

        // 将通知发送给 $notifiable 实例
    }
}

一旦定义了通知频道类，你应该在所有通知里通过 via 方法来简单地返回这个频道的类名。

<?php

namespace App\Notifications;

use Illuminate\Bus\Queueable;
use App\Channels\VoiceChannel;
use App\Channels\Messages\VoiceMessage;
use Illuminate\Notifications\Notification;
use Illuminate\Contracts\Queue\ShouldQueue;

class InvoicePaid extends Notification
{
    use Queueable;

    /**
     * 获取通知频道
     *
     * @param  mixed  $notifiable
     * @return array|string
     */
    public function via($notifiable)
    {
        return [VoiceChannel::class];
    }

    /**
     * 获取通知的声音展示方式
     *
     * @param  mixed  $notifiable
     * @return VoiceMessage
     */
    public function toVoice($notifiable)
    {
        // ...
    }
}

译者署名

用户名	头像	职能	签名
@carlclone		翻译	@carlclone at Github

备注

欢迎任何形式的转载，但请务必注明出处，尊重他人劳动共创开源社区。

转载请注明：本文档由 Laravel China 社区 laravel-china.org 组织翻译，详见翻译召集帖。

文档永久地址： https://d.laravel-china.org

简介​

创建通知​

发送通知​

使用 Notifiable Trait​

使用 Notification Facade​

指定发送频道​

队列化通知​

按需通知​

邮件通知​

格式化邮件消息​

其他通知格式选项​

错误消息​

自定义接收者​

自定义主题​

自定义模板​

Markdown 邮件通知​

生成消息​

写消息​

按钮组件​

面板组件​

表格组件​

自定义组件​

自定义CSS​

数据库通知​

先决条件​

格式化数据库通知​

toDatabase Vs toArray​

访问通知​

标为已读​

广播通知​

先决条件​

格式化广播通知​

广播队列配置​

监听通知​

自定义通知通道​

短信通知​

先决条件​

格式化短信通知​

Unicode 内容​

自定义 From 号码​

路由短信通知​

Slack 通知​

先决条件​

格式化 Slack 通知​

自定义发件人和收件人​

Slack 附加项 (Attachments)​

Markdown 附件内容​

路由 Slack 通知​

通知事件​

自定义频道​

译者署名​

简介

创建通知

发送通知

使用 Notifiable Trait

使用 Notification Facade

指定发送频道

队列化通知

按需通知

邮件通知

格式化邮件消息

其他通知格式选项

错误消息

自定义接收者

自定义主题

自定义模板

Markdown 邮件通知

生成消息

写消息

按钮组件

面板组件

表格组件

自定义组件

自定义CSS

数据库通知

先决条件

格式化数据库通知

`toDatabase` Vs `toArray`

访问通知

标为已读

广播通知

先决条件

格式化广播通知

广播队列配置

监听通知

自定义通知通道

短信通知

先决条件

格式化短信通知

Unicode 内容

自定义 `From` 号码

路由短信通知

Slack 通知

先决条件

格式化 Slack 通知

自定义发件人和收件人

Slack 附加项 (Attachments)

Markdown 附件内容

路由 Slack 通知

通知事件

自定义频道

译者署名