消息通知

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

    创建通知

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

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

    发送通知

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

    1. <?php
    3. namespace App;
    5. use Illuminate\Notifications\Notifiable;
    6. use Illuminate\Foundation\Auth\User as Authenticatable;
    8. class User extends Authenticatable
    9. {
    10.     use Notifiable;
    11. }

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

    1. use App\Notifications\InvoicePaid;
    3. $user->notify(new InvoicePaid($invoice));

    使用 Notification Facade

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

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

    指定发送频道

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

    {tip} 如果你想用其它的频道比如 Telegram 或者 Pusher ，可以去看下社区驱动的 。

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

    1. /**
    2.  * 获取通知发送频道。
    3.  *
    4.  * @param  mixed  $notifiable
    5.  * @return array
    6.  */
    7. public function via($notifiable)
    8. {
    9.     return $notifiable->prefers_sms ? ['nexmo'] : ['mail', 'database'];
    10. }

    队列化通知

    {note} 在队列化通知之前你应该配置你的队列并且 启动队列处理器.

    发送通知可能很耗时，尤其是是当频道需要一个额外的 API 来发送通知。要加速你的应用响应时间，让你的通知继承 ShouldQueue 接口 并且在你的类中添加 Queueable trait。这些接口和 trait 已经被使用 make:notification 生成的所有通知引入了，所以你可以直接将他们添加到你的通知类：

    1. <?php
    3. namespace App\Notifications;
    5. use Illuminate\Bus\Queueable;
    6. use Illuminate\Notifications\Notification;
    7. use Illuminate\Contracts\Queue\ShouldQueue;
    9. class InvoicePaid extends Notification implements ShouldQueue
    10. {
    11.     use Queueable;
    13.     // ...
    14. }

    一旦 ShouldQueue 接口被添加到通知，你就可以和平常一样发送通知了。 Laravel 将会找到类中的 ShouldQueue 接口并且自动发送通知：

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

    如果你想延迟发送通知，你可以链式调用 delay 方法到你的通知实例：

    1. $when = now()->addMinutes(10);
    3. $user->notify((new InvoicePaid($invoice))->delay($when));

    按需通知

    有时你可能需要发送通知给一个非应用中的用户。使用 Notification::route 方法，你在发送通知之前可以指定点对点的通知信息：

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

    格式化邮件信息

    如果一个通知支持邮件发送，你应该定义一个 toMail 方法到你的类中。这个方法接收 $notifiable 实体并且返回一个 Illuminate\Notifications\Messages\MailMessage 实例。邮件信息可能包含多行文本或「链接」。让我们看一下示例 toMail 方法：

    1. /**
    2.  * 获取通知中的邮件展示方式。
    3.  *
    4.  * @param  mixed  $notifiable
    5.  * @return \Illuminate\Notifications\Messages\MailMessage
    6.  */
    7. public function toMail($notifiable)
    8. {
    9.     $url = url('/invoice/'.$this->invoice->id);
    11.     return (new MailMessage)
    12.                 ->greeting('Hello!')
    13.                 ->line('One of your invoices has been paid!')
    14.                 ->action('View Invoice', $url)
    15.                 ->line('Thank you for using our application!');
    16. }

    在这个例子里，我们注册了一个问候，一行文本，一个链接和另一行文本。这些方法由 MailMessage 对象提供，这使格式化简单的事务性的邮件变得简单。然后，邮件频道将把文本转换成一个带有文字的漂亮的响应式 HTML 邮件模板。这是一个由「邮件」频道生成的 email 的样例：

    {tip} 在发送邮件通知时，请确定在你的 config/app.php 配置文件中设置了 name 的值。这个值会在你邮件通知消息的头部和尾部使用。

    其它通知格式选项

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

    1. /**
    2.  *  获取通知的邮件展示方式。
    3.  *
    4.  * @param  mixed  $notifiable
    5.  * @return \Illuminate\Notifications\Messages\MailMessage
    6.  */
    7. public function toMail($notifiable)
    8. {
    9.     return (new MailMessage)->view(
    10.         'emails.name', ['invoice' => $this->invoice]
    11.     );
    12. }

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

    1. use App\Mail\InvoicePaid as Mailable;
    3. /**
    4.  * 获取通知的邮件展示方式。
    5.  *
    6.  * @param  mixed  $notifiable
    7.  * @return Mailable
    8.  */
    9. public function toMail($notifiable)
    10. {
    11.     return (new Mailable($this->invoice))->to($this->user->email);
    12. }

    错误消息

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

    1. /**
    2.  * 获取通知的邮件展示方式。
    3.  *
    4.  * @param  mixed  $notifiable
    5.  * @return \Illuminate\Notifications\Message
    6.  */
    7. public function toMail($notifiable)
    8. {
    9.     return (new MailMessage)
    10.                 ->error()
    11.                 ->subject('Notification Subject')
    12.                 ->line('...');
    13. }

    自定义接收者

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

    1. <?php
    3. namespace App;
    5. use Illuminate\Notifications\Notifiable;
    6. use Illuminate\Foundation\Auth\User as Authenticatable;
    8. class User extends Authenticatable
    9. {
    10.     use Notifiable;
    12.     /**
    13.      * 邮件频道的路由。
    14.      *
    15.      * @param  \Illuminate\Notifications\Notification  $notification
    16.      */
    17.     public function routeNotificationForMail($notification)
    18.     {
    19.         return $this->email_address;
    20.     }
    21. }

    自定义主题

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

    1. /**
    2.  *获取通知的邮件展示方式。
    3.  *
    4.  * @param  mixed  $notifiable
    5.  * @return \Illuminate\Notifications\Messages\MailMessage
    6.  */
    7. public function toMail($notifiable)
    8. {
    9.     return (new MailMessage)
    10.                 ->subject('Notification Subject')
    11.                 ->line('...');
    12. }

    自定义模板

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

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

    Markdown 邮件通知

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

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

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

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

    编写消息

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

    1. @component('mail::message')
    2. # Invoice Paid
    4. Your invoice has been paid!
    6. @component('mail::button', ['url' => $url])
    7. View Invoice
    10. Thanks,<br>
    11. {{ config('app.name') }}
    12. @endcomponent

    按钮组件

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

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

    面板组件

    面板组件在面板中渲染指定的文本块，该面板具有与通知其它部分稍微不同的背景色，使你的文本块更容易吸引注意力：

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

    表格组件

    表格组件帮助你将一个 Markdown 表格转换为 HTML 表格。该组件接受 Markdown 表格作为内容。表格的列对齐遵循默认的 Markdown 对齐语法：

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

    自定义组件

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

    1. 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 展示之中。

    {tip} 如果你喜欢为 Markdown 组件创建一整个新主题，只需要在 html/themes 目录中编写一个新的 CSS 文件，并修改 mail 配置文件中的 theme 选项。

    数据库通知

    先决条件

    database 通知渠道在一张数据库表里存储通知信息。该表以自定义的 JSON 格式，存储如通知类型等描述通知的信息。

    你可以为你的应用提供查询这些表，以显示通知的用户接口。不过，在此之前，你需要先创建一个数据库表来存放这些通知。你可以使用命令 notifications:table 生成包含特定表结构的迁移文件：

    1. php artisan notifications:table
    3. php artisan migrate

    格式化数据库通知

    要让一个通知支持被存储到数据库表中，你需要为通知类定义方法 toDatabase 或者 toArray。这个方法应当接受一个 $notifiable 的实体作为参数，并且可以返回一个普通的 PHP 数组。被返回的数组将被编码为 JSON 并存储在你的 notifications 表的 data 数据列。让我们看一个 toArray 方法的例子：

    1. /**
    2.  * Get the array representation of the notification.
    3.  *
    4.  * @param  mixed  $notifiable
    5.  * @return array
    6.  */
    7. public function toArray($notifiable)
    8. {
    9.     return [
    10.         'invoice_id' => $this->invoice->id,
    11.         'amount' => $this->invoice->amount,
    12.     ];
    13. }

    比较 toDatabase 和 toArray

    toArray 方法也会被 broadcast 渠道用来判断哪些数据会被广播给你的 JavaScript 客户端。如果你希望 database 和 broacast 两个渠道有不同的数组展现方式，你需要定义 toDatabase 以取代定义 toArray 方法。

    存取通知

    一旦通知被存储到数据库之中，你需要一种方便的方式从通知实体中获取它们。Laravel 的默认模型 App\User 已经引入了 Trait Illuminate\Notifications\Notifiable ，它包含了一个 Eloquet 关系 notifications ，可以为实体返回通知。你可以像访问所有其他 Eloquent 关系一样访问这个方法，以获取通知。默认情况下，通知会被以 created_at 时间戳进行排序：

    1. $user = App\User::find(1);
    3. foreach ($user->notifications as $notification) {
    4.     echo $notification->type;
    5. }

    如果你仅仅想检索所有「未读」通知，你需要使用 unreadNotifications 关系。这些通知也是以 created_at 时间戳进行排序的：

    1. $user = App\User::find(1);
    3. foreach ($user->unreadNotifications as $notification) {
    4.     echo $notification->type;
    5. }

    通知标记已读

    通常，你希望一个通知在用户浏览之后就标记为「已读」。Trait Illuminate\Notifications\Notifiable 提供一个 markAsRead 方法，它可以在通知对应的数据库记录中更新 read_at 列：

    1. $user = App\User::find(1);
    3. foreach ($user->unreadNotifications as $notification) {
    4.     $notification->markAsRead();
    5. }

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

    1. $user->unreadNotifications->markAsRead();

    你还可以使用批量更新的查询来标记所有通知为已读，而不用先从数据库中检索到它们：

    1. $user = App\User::find(1);
    3. $user->unreadNotifications()->update(['read_at' => now()]);

    当然，你可以使用 delete 从数据表中完全删除掉通知：

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

    先决条件

    在广播通知之前，你需要配置并熟悉 Laravel 的 事件广播 服务。事件广播提供一种途径，让 JavaScript 客户端可以响应服务端触发的 Laravel 事件端。

    格式化广播通知

    broadcast 渠道使用 Laravel 的 广播通知，允许你的 JavaScript 客户端实时抓取通知。你需要为通知类定义 toBroadcast 方法，以使该通知支持广播。这个方法获取一个 $notifiable 的实体，并需要返回一个 BroadcastMessage 实例。返回的数据会被编码为 JSON，并且广播给你的 JavaScript 客户端。让我们看一个 toBroadcast 方法的示例：

    1. use Illuminate\Notifications\Messages\BroadcastMessage;
    3. /**
    4.  * Get the broadcastable representation of the notification.
    5.  *
    6.  * @param  mixed  $notifiable
    7.  * @return BroadcastMessage
    8.  */
    9. public function toBroadcast($notifiable)
    10. {
    11.     return new BroadcastMessage([
    12.         'invoice_id' => $this->invoice->id,
    13.         'amount' => $this->invoice->amount,
    14.     ]);
    15. }

    广播队列配置

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

    1. return (new BroadcastMessage($data))
    2.                 ->onConnection('sqs')
    3.                 ->onQueue('broadcasts');

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

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

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

    自定义通知通道

    短信通知

    实现前提

    Laravel 的短信通知基于 Nexmo。使用 Nexmo 发送通知前，需要安装 nexmo/client 的 Composer 包并且配置好 config/services.php 文件。可以直接复制以下配置示例：

    1. 'nexmo' => [
    2.     'key' => env('NEXMO_KEY'),
    3.     'secret' => env('NEXMO_SECRET'),
    4.     'sms_from' => '15556666666',
    5. ],

    sms_from 选项代表短信发送者的号码，可以在 Nexmo 控制面板里生成。

    格式化短信通知

    要实现短信通知，需要在通知类里定义 toNexmo 方法。这个方法接受一个 $notifiable 实例，必须返回 Illuminate\Notifications\Messages\NexmoMessage 实例：

    1. /**
    2.  * 获取 Nexmo / 短信通知
    3.  *
    4.  * @param  mixed  $notifiable
    5.  * @return NexmoMessage
    6.  */
    7. public function toNexmo($notifiable)
    8. {
    9.     return (new NexmoMessage)
    10.                 ->content('Your SMS message content');
    11. }

    Unicode 内容

    如果短信包含 unicode 字符，就应在 NexmoMessage 实例上调用 unicode 方法：

    1. /**
    2.  * 获取 Nexmo / 短信通知
    3.  *
    4.  * @param  mixed  $notifiable
    5.  * @return NexmoMessage
    6.  */
    7. public function toNexmo($notifiable)
    8. {
    9.     return (new NexmoMessage)
    10.                 ->content('Your unicode message')
    11.                 ->unicode();
    12. }

    自定义发送者号码

    config/services.php 中的发送者号码与欲使用的发送者号码不一致时，就可以使用 NexmoMessage 实例上的 from 方法：

    1. /**
    2.  * 获取 Nexmo / 短信通知
    3.  *
    4.  * @param  mixed  $notifiable
    5.  * @return NexmoMessage
    6.  */
    7. public function toNexmo($notifiable)
    8. {
    9.     return (new NexmoMessage)
    10.                 ->content('Your SMS message content')
    11.                 ->from('15554443333');
    12. }

    路由短信通知

    当通过 mexmo 渠道发送通知是，通知系统会自动在通知实体中寻找 phone_number 属性。如果你希望自定义通知送达的手机号码，在实体中定义一个 routeNotificationForNexmo 方法：

    1. <?php
    3. namespace App;
    5. use Illuminate\Notifications\Notifiable;
    6. use Illuminate\Foundation\Auth\User as Authenticatable;
    8. class User extends Authenticatable
    9. {
    10.     use Notifiable;
    12.     /**
    14.      *
    15.      * @param  \Illuminate\Notifications\Notification  $notification
    16.      * @return string
    17.      */
    18.     public function routeNotificationForNexmo($notification)
    19.     {
    20.         return $this->phone;
    21.     }

    Slack 通知

    先决条件

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

    1. composer require guzzlehttp/guzzle

    你需要为你的 Slack 组配置 "Incoming Webhook" 集成，它将为你提供 时所需要的 URL。

    格式化 Slack 通知

    要使一个通知支持被发送为一个 Slack 消息，你需要为通知类定义一个 toSlack 方法。该方法应接受一个 $notifiable 实体为参数，并可以返回一个 Illuminate\Notifications\Messages\SlackMessage 实例。 Slack 消息需要包含文本内容，以及一个「attachement」 用来附加额外的文本或者数组字段。让我来看一个基本的 toSlack 示例：

    1. /**
    2.  * Get the Slack representation of the notification.
    3.  *
    4.  * @param  mixed  $notifiable
    5.  * @return SlackMessage
    6.  */
    7. public function toSlack($notifiable)
    8. {
    9.     return (new SlackMessage)
    10.                 ->content('One of your invoices has been paid!');
    11. }

    在这个示例中，我们仅仅发送了一行文本给 Slack，它将创建类似如下的一个消息：

    basic-slack-notification.png

    自定义发送人和收件人

    你可以使用 from 和 to 方法来自定义发送人和收件人。form 方法接受一个用户名和 emoji 标识符，而 to 方法接受一个渠道或者用户名：

    1. /**
    2.  * Get the Slack representation of the notification.
    3.  *
    4.  * @param  mixed  $notifiable
    5.  * @return SlackMessage
    6.  */
    7. public function toSlack($notifiable)
    8. {
    9.     return (new SlackMessage)
    10.                 ->from('Ghost', ':ghost:')
    11.                 ->to('#other')
    12.                 ->content('This will be sent to #other');
    13. }

    你也可以使用图片来代替 emoji：

    1. /**
    2.  * Get the Slack representation of the notification.
    3.  *
    4.  * @param  mixed  $notifiable
    5.  * @return SlackMessage
    6.  */
    7. public function toSlack($notifiable)
    8. {
    9.     return (new SlackMessage)
    10.                 ->from('Laravel')
    11.                 ->image('https://laravel.com/favicon.png')
    12.                 ->content('This will display the Laravel logo next to the message');
    13. }

    Slack 附件

    你也可以为 Slack 消息添加「附件」。附件提供比简单的文本消息更丰富的格式化选项。在如下例子中，你会发送一个有关应用异常的报错通知，它包含一个查看异常详情的链接：

    1. /**
    2.  * Get the Slack representation of the notification.
    3.  *
    4.  * @param  mixed  $notifiable
    5.  * @return SlackMessage
    6.  */
    7. public function toSlack($notifiable)
    8. {
    9.     $url = url('/exceptions/'.$this->exception->id);
    11.     return (new SlackMessage)
    12.                 ->error()
    13.                 ->content('Whoops! Something went wrong.')
    14.                 ->attachment(function ($attachment) use ($url) {
    15.                     $attachment->title('Exception: File Not Found', $url)
    16.                                ->content('File [background.jpg] was not found.');
    17.                 });
    18. }

    该示例将会产生一个类似如下显示的 Slack 消息：

    附件也允许你指定一个展现给用户的数组数据，给定的数据会被格式化为表格样式，以方便阅读：

    1. /**
    2.  * Get the Slack representation of the notification.
    3.  *
    4.  * @param  mixed  $notifiable
    5.  * @return SlackMessage
    6.  */
    7. public function toSlack($notifiable)
    8. {
    9.     $url = url('/invoices/'.$this->invoice->id);
    11.     return (new SlackMessage)
    12.                 ->success()
    13.                 ->content('One of your invoices has been paid!')
    14.                 ->attachment(function ($attachment) use ($url) {
    15.                     $attachment->title('Invoice 1322', $url)
    16.                                ->fields([
    17.                                     'Title' => 'Server Expenses',
    18.                                     'Amount' => '$1,234',
    19.                                     'Via' => 'American Express',
    20.                                     'Was Overdue' => ':-1:',
    21.                                 ]);
    22.                 });
    23. }

    该示例会创建一个类似如下显示的 Slack 消息：

    slack-fields-attachment.png

    Markdown 附件内容

    如果一些附件字段包含 Markdown，你可以使用 markdown 方法通知 Slack 解析并显示给定的附件字段为 Markdown 格式化文本。该方法可以接受的值为： pretext，text，以及或者 fields 。如需获取 Slack 附件格式化的更多信息，请点击 Slack API 文档：

    1. /**
    2.  * Get the Slack representation of the notification.
    3.  *
    4.  * @param  mixed  $notifiable
    5.  * @return SlackMessage
    6.  */
    7. public function toSlack($notifiable)
    8. {
    9.     $url = url('/exceptions/'.$this->exception->id);
    11.     return (new SlackMessage)
    12.                 ->error()
    13.                 ->content('Whoops! Something went wrong.')
    14.                 ->attachment(function ($attachment) use ($url) {
    15.                     $attachment->title('Exception: File Not Found', $url)
    16.                                ->content('File [background.jpg] was *not found*.')
    17.                                ->markdown(['text']);
    18.                 });
    19. }

    路由 Slack 通知

    要把 Slack 通知路由到正确的位置，需要为你的可通知实体定义一个 routeNotificationForSlack 方法。它返回通知将被发送到的 URL 回调地址。回调地址可以在 Slack 组中通过附加「Incoming Webhook」服务来生成：

    1. <?php
    3. namespace App;
    5. use Illuminate\Notifications\Notifiable;
    6. use Illuminate\Foundation\Auth\User as Authenticatable;
    8. class User extends Authenticatable
    9. {
    10.     use Notifiable;
    12.     /**
    13.      * Route notifications for the Slack channel.
    14.      *
    15.      * @param  \Illuminate\Notifications\Notification  $notification
    16.      * @return string
    17.      */
    18.     public function routeNotificationForSlack($notification)
    19.     {
    20.         return $this->slack_webhook_url;
    21.     }
    22. }

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

    1. /**
    2.  * The event listener mappings for the application.
    3.  *
    4.  * @var array
    5.  */
    6. protected $listen = [
    7.     'Illuminate\Notifications\Events\NotificationSent' => [
    8.         'App\Listeners\LogNotification',
    9.     ],
    10. ];

    {tip} 别忘记在 EventServiceProvider 中注册监听器之后，使用 event:generate Artisan 命令快速生成监听器类。

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

    1. /**
    2.  * Handle the event.
    3.  *
    4.  * @param  NotificationSent  $event
    5.  * @return void
    6.  */
    7. public function handle(NotificationSent $event)
    8. {
    9.     // $event->channel
    10.     // $event->notifiable
    11.     // $event->notification
    12. }

    自定义频道

    Laravel 附带少数的通知频道，但你可能需要编写自己的驱动以便通过其它频道发送通知。 Laravel 使得这一步很简单。要开始，需要定义一个包含 send 方法的类。这个方法接收两个参数： $notifiable 和 $notification ：

    1. <?php
    3. namespace App\Channels;
    5. use Illuminate\Notifications\Notification;
    7. class VoiceChannel
    8. {
    9.     /**
    10.      * 发送给定的通知
    11.      *
    12.      * @param  mixed  $notifiable
    13.      * @param  \Illuminate\Notifications\Notification  $notification
    14.      * @return void
    15.      */
    16.     public function send($notifiable, Notification $notification)
    17.     {
    18.         $message = $notification->toVoice($notifiable);
    20.         // 将通知发送到 $notifiable 实例...
    21.     }
    22. }

    一旦定义了通知频道类，你可以从任何通知类的 via 方法得到类名：

    本文章首发在 LearnKu.com 网站上。