访问通知

一旦通知存入数据库，就需要适当的方法自通知实体访问它们。 包含在 Lareval 的默认 AppUser 模型带有 IlluminateNotificationsNotifiable trait，它的 notifications Eloquent 关联方法能返回实体通知。要获取通知，可以像其它  Eloquent 关联方法一样访问此方法。默认情况下，通知按照  created_at 时间戳排序：

/**
 * Get the Slack representation of the notification.
 *
 * @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.');               
                    });
           }

若要只获取 「未读」通知，可以使用 unreadNotifications 关联方法。同样这些通知按照 created_at 时间戳排序：

/**
 * Get the Slack representation of the notification.
 *
 * @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' => ',234',                                    
                        'Via' => 'American Express',                                    
                        'Was Overdue' => ':-1:',                                
                        ]);              
          });
     }

{tip} 若要从 JavaScript 客户端访问通知，需要为应用定义一个通知控制器，它返回可通知实体的通知，比如当前用户。可以从 JavaScript 客户端向该控制器 URI 发送 HTTP 请求。

标记通知已读

通常，在用户阅览一条通知之后，你会想将其标识为「已读」。 IlluminateNotificationsNotifiable trait 提供了 markAsRead 方法，它更新数据库中通知记录的 read_at 列：

/**
 * Get the Slack representation of the notification.
 *
 * @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(['text']);            
              });
       }

可以在通知控制集合上直接使用 markAsRead 方法代替循环调用通知：

<?php
    namespace App;
    use Illuminate\Notifications\Notifiable;
    use Illuminate\Foundation\Auth\User as Authenticatable;
    class User extends Authenticatable{  
      use Notifiable;   
     /**
     * Route notifications for the Slack channel.
     *
     * @param  \Illuminate\Notifications\Notification  $notification
     * @return string
     */   
    public function routeNotificationForSlack($notification) 
       {     
          return 'https://hooks.slack.com/services/...';  
        }
     }

还可以使用指更新将所有的通知标为已读，而不从数据库中读取它们：

$user->notify((new InvoicePaid($invoice))->locale('es'));

可以使用 delete

Notification::locale('es')->send($users, new InvoicePaid($invoice));

toDatabase 대 toArray

use Illuminate\Contracts\Translation\HasLocalePreference;
class User extends Model implements HasLocalePreference{   
    /**
     * Get the user's preferred locale.
     *
     * @return string
     */    
   public function preferredLocale() 
      {      
        return $this->locale;    
      }
    }

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

/**
 * The event listener mappings for the application.
 *
 * @var array
 */
 protected $listen = [ 
    'Illuminate\Notifications\Events\NotificationSent' => [     
       'App\Listeners\LogNotification',  
      ],
  ];

/**
 * Handle the event.
 *
 * @param  NotificationSent  $event
 * @return void
 */
 public function handle(NotificationSent $event){
     // $event->channel    
     // $event->notifiable    
     // $event->notification    
     // $event->response
  }

<?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);        
        // Send notification to the $notifiable instance...   
       }
    }

<?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)  
     {     
        // ...  
      }
   }

형식화된 브로드캐스트 알림

broadcast 채널은 JavaScript 클라이언트가 실시간으로 알림을 캡처할 수 있도록 하는 Laravel의 이벤트 브로드캐스팅 서비스를 사용하여 알림을 브로드캐스트합니다. 알림이 브로드캐스트를 지원하는 경우 알림 클래스에 toBroadcast 메서드를 정의해야 합니다. 이 메소드는 $notifying 엔터티를 매개변수로 받아들이고 BroadcastMessage 인스턴스를 반환합니다. 반환된 데이터는 JSON으로 인코딩되어 JavaScript 클라이언트에 브로드캐스트됩니다. toBroadcast 메소드의 예를 살펴보겠습니다.broadcast 通道使用 Laravel 的 event broadcasting 服务广播通知，它允许 JavaScript 客户端实时捕获通知。如果通知支持广播，你就需要在通知类上定义 toBroadcast 方法。此方法接受 $notifiable 实体作为参数，并返回 BroadcastMessage 实例。返回的数据将被编码为 JSON 并广播给 JavaScript 客户端。我们来看一个 toBroadcast 方法示例

广播队列配置

所有的广播通知都被放入广播队列。想要配置用于广播操作的队列连接或者队列名称，需要使用 BroadcastMessage 的 onConnection 和 onQueue 方法：

{tip} 除了指定的数据，广播通知还包含 type 域，它包括通知类的类名。

监听通知

通知将会以格式化为 {notifiable}.{id} 的形式在私有频道上广播，因此，如果你要发送通知到 ID 为  1 的  AppUser 实例，那么该通知将会在私有频道 App.User.1 上进行广播，如果使用了 Laravel Echo，可以使用辅助函数  notification 轻松在某个频道上监听通知：

自定义通知通道

如果你想要自定义被通知实体在某个通道上接收广播通知，可以在被通知实体上定义一个  receivesBroadcastNotificationsOn 方法：

短信（SMS）通知

预备知识

Laravel 基于 Nexmo 发送短信通知，在使用 Nexmo 发送通知前，需要安装对应 Composer 依赖包 laravel/nexmo-notification-channel ：

下一步，你需要在配置文件 config/services.php 中进行相应配置。你可以参考以下示例配置：

sms_from  配置项就是你用于发送短信消息的手机号码，你需要在 Nexmo 控制面板中为应用生成一个手机号码。

格式化短信通知

如果通知支持以短信方式发送，那么你需要在通知类上定义一个 toNexmo 方法。该方法接收一个 $notifiable 实体并返回  IlluminateNotificationsMessagesNexmoMessage 实例：

Unicode 内容

如果你的短信消息包含 Unicode 字符，需要在构造 NexmoMessage 实例时调用 unicoderrreee

브로드캐스트 대기열 구성

rrreee

{tip} 브로드캐스트 알림에는 지정된 데이터 외에도 알림 클래스의 클래스 이름이 포함된 type 필드도 포함되어 있습니다.

短信通知路由

使用 nexmo 通道发送通知的时候，通知系统会自动在被通知实体上查找 phone_number 属性。如果你想要自定义通知被发送到的手机号码，可以在该实体上定义一个 routeNotificationForNexmo 方法：

Slack 通知

预备知识

在通过 Slack 发送通知前，必须通过 Composer 安装 Slack 通知通道：

此外，你还要为 Slack 组配置一个 "Incoming Webhook" 集成。该集成会在你进行 Slack 通知路由 的时候提供一个 URL。

格式化 Slack 通知

如果通知支持通过 Slack 消息发送，则需要在通知类上定义一个 toSlack 方法，该方法接收一个 $notifiable 实体并返回 IlluminateNotificationsMessagesSlackMessage 实例，该实例包含文本内容以及格式化额外文本或数组字段的 “附件”。让我们来看一个基本的 toSlack 使用示例：

在这个例子中，我们只发送一行简单的文本到 Slack，最终创建的消息如下：

Customizing The Sender & Recipient

你可以使用 from 和 to 方法自定义发送者和接收者， from 方法接收一个用户名和 emoji 标识，而 torrreee

SMS 알림 라우팅 nexmo 채널을 사용하는 경우 알림을 보내면 알림 시스템은 알림을 받은 엔터티에서 phone_number 속성을 ​​자동으로 찾습니다. 알림이 전송되는 휴대폰 번호를 사용자 정의하려면 이 엔터티에 routeNotificationForNexmo 메서드를 정의할 수 있습니다:

Slack 알림

🎜🎜🎜Slack 알림 형식 지정🎜🎜알림이 Slack 메시지를 통한 전송을 지원하는 경우 알림 클래스에서 toSlack 메서드를 정의해야 합니다. 이 메소드는 $notifying 엔터티를 수신하고 텍스트 콘텐츠와 서식이 지정된 추가 텍스트 또는 배열 필드의 "첨부 파일"이 포함된 IlluminateNotificationsMessagesSlackMessage 인스턴스를 반환합니다. toSlack의 기본 사용 예를 살펴보겠습니다. 🎜rrreee🎜이 예에서는 간단한 텍스트 한 줄을 Slack에 보내고 생성된 최종 메시지는 다음과 같습니다. 🎜🎜🎜🎜🎜

발신자 및 수신자 사용자 정의

🎜 from 및 to 메소드를 사용하여 발신자와 수신자를 사용자 정의할 수 있습니다. from 메소드는 사용자 이름과 이모티콘 식별자를 받고, to 메소드는 채널이나 사용자 이름을 받습니다. 🎜rrreee🎜 사진을 로고로 사용하여 이모티콘을 대체할 수도 있습니다. 🎜rrreee 🎜🎜🎜🎜🎜 Slack 첨부 파일🎜🎜 Slack 메시지에 "첨부 파일"을 추가할 수도 있습니다. 단순한 문자 메시지에 비해 첨부 파일은 더 다양한 형식을 선택할 수 있습니다. 이 예에서는 더 많은 예외 세부 정보를 볼 수 있는 링크를 포함하여 애플리케이션에서 발생한 예외 오류에 대한 알림을 보냅니다. 🎜rrreee🎜위 코드는 다음 Slack 메시지를 생성합니다. 🎜🎜🎜🎜🎜🎜

첨부 파일을 사용하면 사용자에게 표시할 배열 데이터를 지정할 수도 있습니다. 가독성을 높이기 위해 주어진 배열은 표 형식으로 표시됩니다.

rrreee

위 코드는 다음 Slack 메시지를 생성합니다.

Markdown 첨부 파일 콘텐츠

일부 첨부 파일 필드에 Markdown이 포함된 경우 markdown 메서드를 사용하여 Slack을 빌드하여 Markdown 형식으로 작성된 첨부 파일 필드를 구문 분석하고 표시할 수 있습니다. 이 값은 지원됩니다. 메소드에는 pretext , text 또는 field가 포함됩니다. Slack의 형식 지정에 대해 자세히 알아보려면 Slack API 문서를 확인하세요. markdown 方法来构建 Slack 用以解析并显示以 Markdown 格式编写的附件字段，该方法支持的值包括  pretext、 text 或 fields。想要了解更多关于 Slack 格式化的信息，查看 Slack API 文档：

Slack 通知路由

要路由 Slack 通知到适当的位置，需要在被通知的实体上定义一个 routeNotificationForSlack 方法，这将会返回通知被发送到的 Webhook URL。Webhook URL 可通过在 Slack 组上添加一个 "Incoming Webhook" 服务来生成：

本地化通知

Laravel 允许您以当前语言环境之外的其他语言发送通知，并且会在通知队列时记住该语言环境。

要实现这一点， IlluminateNotificationsNotification 类提供了一个 locale 方法来设置所需的语言。在格式化通知时，应用程序将更改为此语言设置，然后在格式化完成后还原为以前的语言设置：

多重通知的本地化也可通过 Notification  Facade 实现：

用户首选语言区域设置

有些情况下，应用程序保存了每个用户的首选语言区域设置。通过在模型上实现 HasLocalePreference 契约，可以指定 Laravel 在发送通知时使用用户保存的首选语言设置：

实现接口后，Laravel 将在向模型发送通知和邮件时自动使用首选区域设置。因此，使用此接口时不需要调用 locale 方法：

通知事件

当通知被发送后，通知系统会触发 IlluminateNotificationsEventsNotificationSent 事件，该事件实例包含被通知的实体（如用户）和通知实例本身。你可以在 EventServiceProvider 中为该事件注册监听器：

{提示}  在 EventServiceProvider 中注册监听器之后，使用 Artisan 命令 event:generate 可以快速生成监听器类。

在事件监听器中，可以访问事件的 notifiable、  notification 和  channel 属性了解通知接收者和通知本身的更多信息：

自定义通道

Laravel 为我们提供了多种通知通道，但是尝试编写自定义通道驱动以通过其他通道发送通知，也很简单。首先定义一个包含 send 方法的类，该方法接收两个参数：  $notifiable 和 $notificationrrreee

Slack 알림 라우팅