バージョン: 9.x

通知 (Notifications)

Introduction
通知の生成
通知の送信
メール通知
マークダウンメール通知
データベース通知
ブロードキャスト通知
SMS通知
- Prerequisites
- SMS 通知のフォーマット
- ショートコード通知のフォーマット
- 「差出人」番号のカスタマイズ
- クライアント参照の追加
- SMS 通知のルーティング
Slack 通知
通知のローカライズ
通知イベント
カスタムチャンネル

導入 (Introduction)

電子メールの送信のサポートに加えて、Laravel は、電子メール、SMS (旧 Nexmo である Vonage 経由)、Slack など、さまざまな配信チャネルで通知を送信するためのサポートを提供します。さらに、数十の異なるチャネルで通知を送信するために、さまざまなコミュニティが構築した通知チャネルが作成されています。通知はデータベースに保存され、Web インターフェイスに表示される場合もあります。

通常、通知は、アプリケーションで発生した何かをユーザーに通知する短い情報メッセージである必要があります。たとえば、請求アプリケーションを作成している場合、電子メールと SMS チャネルを介してユーザーに「請求書支払い済み」通知を送信できます。

通知の生成 (Generating Notifications)

Laravel では、各通知は単一のクラスで表され、通常は app/Notifications ディレクトリに保存されます。アプリケーションにこのディレクトリが表示されなくても心配する必要はありません。make:notification Artisan コマンドを実行すると作成されます。

php artisan make:notification InvoicePaid

このコマンドは、新しい通知クラスを app/Notifications ディレクトリに配置します。各通知クラスには、via メソッドと、通知をその特定のチャネルに合わせたメッセージに変換する toMail や toDatabase などの可変数のメッセージ構築メソッドが含まれています。

通知の送信 (Sending Notifications)

通知可能な特性の使用

通知は 2 つの方法で送信できます。Notifiable 特性の notify メソッドを使用する方法と、Notification facade を使用する方法です。 Notifiable 特性は、デフォルトでアプリケーションの App\Models\User モデルに含まれています。

<?php

namespace App\Models;

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

class User extends Authenticatable
{
    use Notifiable;
}

この特性によって提供される notify メソッドは、通知インスタンスを受信することを想定しています。

use App\Notifications\InvoicePaid;

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

注記どのモデルでも Notifiable トレイトを使用できることに注意してください。 User モデルに含めるだけに限定されるわけではありません。

通知ファサードの使用

あるいは、Notification facade 経由で通知を送信することもできます。このアプローチは、ユーザーのコレクションなど、複数の通知対象エンティティに通知を送信する必要がある場合に便利です。ファサードを使用して通知を送信するには、すべての通知可能なエンティティと通知インスタンスを send メソッドに渡します。

use Illuminate\Support\Facades\Notification;

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

sendNow メソッドを使用して、すぐに通知を送信することもできます。このメソッドは、通知が ShouldQueue インターフェイスを実装している場合でも、通知をすぐに送信します。

Notification::sendNow($developers, new DeploymentCompleted($deployment));

配信チャネルの指定

すべての通知クラスには、通知が配信されるチャネルを決定する via メソッドがあります。通知は、mail、database、broadcast、vonage、および slack チャネルで送信される場合があります。

注記 Telegram や Pusher などの他の配信チャネルを使用したい場合は、コミュニティ主導の Laravel 通知チャネル Web サイトをチェックしてください。

via メソッドは、通知の送信先となるクラスのインスタンスとなる $notifiable インスタンスを受け取ります。 $notifiable を使用して、通知を配信するチャネルを決定できます。

/**
 * Get the notification's delivery channels.
 *
 * @param  mixed  $notifiable
 * @return array
 */
public function via($notifiable)
{
    return $notifiable->prefers_sms ? ['vonage'] : ['mail', 'database'];
}

通知のキューイング

警告通知をキューに入れる前に、キューとワーカーを始めるを設定する必要があります。

特にチャネルが通知を配信するために外部 API 呼び出しを行う必要がある場合、通知の送信には時間がかかることがあります。アプリケーションの応答時間を短縮するには、ShouldQueue インターフェイスと Queueable トレイトをクラスに追加して、通知をキューに入れます。インターフェイスと特性は、make:notification コマンドを使用して生成されたすべての通知に対してすでにインポートされているため、通知クラスにすぐに追加できます。

<?php

namespace App\Notifications;

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

class InvoicePaid extends Notification implements ShouldQueue
{
    use Queueable;

    // ...
}

ShouldQueue インターフェイスが通知に追加されたら、通常どおり通知を送信できます。 Laravel はクラス上の ShouldQueue インターフェイスを検出し、通知の配信を自動的にキューに入れます。

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

通知をキューに入れると、受信者とチャネルの組み合わせごとにキューに入れられたジョブが作成されます。たとえば、通知に 3 人の受信者と 2 つのチャネルがある場合、6 つのジョブがキューにディスパッチされます。

通知の遅延

通知の配信を遅らせたい場合は、通知のインスタンス化に delay メソッドを連鎖させます。

$delay = now()->addMinutes(10);

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

チャネルごとの通知の遅延

配列を delay メソッドに渡して、特定のチャネルの遅延量を指定できます。

$user->notify((new InvoicePaid($invoice))->delay([
    'mail' => now()->addMinutes(5),
    'sms' => now()->addMinutes(10),
]));

あるいは、通知クラス自体に withDelay メソッドを定義することもできます。 withDelay メソッドは、チャネル名と遅延値の配列を返す必要があります。

/**
 * Determine the notification's delivery delay.
 *
 * @param  mixed  $notifiable
 * @return array
 */
public function withDelay($notifiable)
{
    return [
        'mail' => now()->addMinutes(5),
        'sms' => now()->addMinutes(10),
    ];
}

通知キュー接続のカスタマイズ

デフォルトでは、キューに入れられた通知は、アプリケーションのデフォルトのキュー接続を使用してキューに入れられます。特定の通知に使用する別の接続を指定したい場合は、通知クラスで $connection プロパティを定義できます。

/**
 * The name of the queue connection to use when queueing the notification.
 *
 * @var string
 */
public $connection = 'redis';

または、通知でサポートされる各通知チャネルに使用する特定のキュー接続を指定したい場合は、通知で viaConnections メソッドを定義できます。このメソッドは、チャネル名とキュー接続名のペアの配列を返す必要があります。

/**
 * Determine which connections should be used for each notification channel.
 *
 * @return array
 */
public function viaConnections()
{
    return [
        'mail' => 'redis',
        'database' => 'sync',
    ];
}

通知チャネルキューのカスタマイズ

通知でサポートされる各通知チャネルに使用する特定のキューを指定したい場合は、通知で viaQueues メソッドを定義できます。このメソッドは、チャネル名とキュー名のペアの配列を返す必要があります。

/**
 * Determine which queues should be used for each notification channel.
 *
 * @return array
 */
public function viaQueues()
{
    return [
        'mail' => 'mail-queue',
        'slack' => 'slack-queue',
    ];
}

キューに入れられた通知とデータベーストランザクション

キューに入れられた通知がデータベーストランザクション内でディスパッチされると、データベーストランザクションがコミットされる前にキューによって通知が処理される場合があります。この問題が発生すると、データベーストランザクション中にモデルまたはデータベースレコードに対して行った更新がまだデータベースに反映されていない可能性があります。さらに、トランザクション内で作成されたモデルやデータベースレコードはデータベースに存在しない可能性があります。通知がこれらのモデルに依存している場合、キューに入れられた通知を送信するジョブの処理時に予期しないエラーが発生する可能性があります。

キュー接続の after_commit 構成オプションが false に設定されている場合でも、通知の送信時に afterCommit メソッドを呼び出すことにより、開いているすべてのデータベーストランザクションがコミットされた後に特定のキューに入れられた通知を送信する必要があることを示すことができます。

use App\Notifications\InvoicePaid;

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

あるいは、通知のコンストラクターから afterCommit メソッドを呼び出すこともできます。

<?php

namespace App\Notifications;

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

class InvoicePaid extends Notification implements ShouldQueue
{
    use Queueable;

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

注記これらの問題の回避方法の詳細については、キューに入れられたジョブとデータベーストランザクションに関するドキュメントを参照してください。

キューに入れられた通知を送信するかどうかの決定

キューに入れられた通知は、バックグラウンド処理のためにキューにディスパッチされた後、通常、キューワーカーによって受け入れられ、目的の受信者に送信されます。

ただし、キューに入れられた通知がキューワーカーによって処理された後に送信するかどうかを最終決定したい場合は、通知クラスで shouldSend メソッドを定義できます。このメソッドが false を返した場合、通知は送信されません。

/**
 * Determine if the notification should be sent.
 *
 * @param  mixed  $notifiable
 * @param  string  $channel
 * @return bool
 */
public function shouldSend($notifiable, $channel)
{
    return $this->invoice->isPaid();
}

オンデマンド通知

場合によっては、アプリケーションの「ユーザー」として保存されていない人に通知を送信する必要がある場合があります。 Notification ファサードの route メソッドを使用すると、通知を送信する前にアドホック通知ルーティング情報を指定できます。

use Illuminate\Broadcasting\Channel;
use Illuminate\Support\Facades\Notification;

Notification::route('mail', '[email protected]')
            ->route('vonage', '5555555555')
            ->route('slack', 'https://hooks.slack.com/services/...')
            ->route('broadcast', [new Channel('channel-name')])
            ->notify(new InvoicePaid($invoice));

オンデマンド通知を mail ルートに送信するときに受信者の名前を指定したい場合は、電子メールアドレスをキーとして、名前を配列の最初の要素の値として含む配列を指定できます。

Notification::route('mail', [
    '[email protected]' => 'Barrett Blair',
])->notify(new InvoicePaid($invoice));

メール通知 (Mail Notifications)

メールメッセージのフォーマット

通知が電子メールとして送信されることをサポートしている場合は、通知クラスで toMail メソッドを定義する必要があります。このメソッドは $notifiable エンティティを受け取り、Illuminate\Notifications\Messages\MailMessage インスタンスを返す必要があります。

MailMessage クラスには、トランザクション電子メールメッセージの作成に役立ついくつかの簡単なメソッドが含まれています。メールメッセージには、テキスト行と「行動喚起」が含まれる場合があります。 toMail メソッドの例を見てみましょう。

/**
 * Get the mail representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\MailMessage
 */
public function toMail($notifiable)
{
    $url = url('/invoice/'.$this->invoice->id);

    return (new MailMessage)
                ->greeting('Hello!')
                ->line('One of your invoices has been paid!')
                ->lineIf($this->amount > 0, "Amount paid: {$this->amount}")
                ->action('View Invoice', $url)
                ->line('Thank you for using our application!');
}

注記 toMail メソッドで $this->invoice->id を使用していることに注意してください。通知がメッセージを生成するために必要なデータを通知のコンストラクターに渡すことができます。

この例では、挨拶、テキスト行、行動喚起、そして別のテキスト行を登録します。 MailMessage オブジェクトによって提供されるこれらのメソッドにより、小規模なトランザクション電子メールのフォーマットが簡単かつ迅速になります。次に、メールチャネルは、メッセージコンポーネントを、対応するプレーンテキストを含む美しく応答性の高い HTML 電子メールテンプレートに変換します。 mail チャネルによって生成された電子メールの例を次に示します。

注記メール通知を送信するときは、config/app.php 構成ファイルで name 構成オプションを必ず設定してください。この値は、メール通知メッセージのヘッダーとフッターで使用されます。

エラーメッセージ

一部の通知は、請求書支払いの失敗などのエラーをユーザーに通知します。メッセージの作成時に error メソッドを呼び出すことで、メールメッセージがエラーに関するものであることを示すことができます。メールメッセージで error メソッドを使用すると、CTA ボタンが黒ではなく赤になります。

/**
 * Get the mail representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\MailMessage
 */
public function toMail($notifiable)
{
    return (new MailMessage)
                ->error()
                ->subject('Invoice Payment Failed')
                ->line('...');
}

その他のメール通知の形式オプション

通知クラスでテキストの「行」を定義する代わりに、view メソッドを使用して、通知電子メールのレンダリングに使用するカスタムテンプレートを指定できます。

/**
 * Get the mail representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\MailMessage
 */
public function toMail($notifiable)
{
    return (new MailMessage)->view(
        'emails.name', ['invoice' => $this->invoice]
    );
}

view メソッドに与えられる配列の 2 番目の要素としてビュー名を渡すことで、メールメッセージのプレーンテキストビューを指定できます。

/**
 * Get the mail representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\MailMessage
 */
public function toMail($notifiable)
{
    return (new MailMessage)->view(
        ['emails.name.html', 'emails.name.plain'],
        ['invoice' => $this->invoice]
    );
}

送信者のカスタマイズ

デフォルトでは、電子メールの送信者/差出人のアドレスは、config/mail.php 構成ファイルで定義されます。ただし、from メソッドを使用して、特定の通知の送信元アドレスを指定できます。

/**
 * Get the mail representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\MailMessage
 */
public function toMail($notifiable)
{
    return (new MailMessage)
                ->from('[email protected]', 'Barrett Blair')
                ->line('...');
}

受信者のカスタマイズ

mail チャネル経由で通知を送信すると、通知システムは通知対象エンティティの email プロパティを自動的に検索します。通知可能なエンティティで routeNotificationForMail メソッドを定義することにより、通知の配信に使用される電子メールアドレスをカスタマイズできます。

<?php

namespace App\Models;

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

class User extends Authenticatable
{
    use Notifiable;

    /**
     * Route notifications for the mail channel.
     *
     * @param  \Illuminate\Notifications\Notification  $notification
     * @return array|string
     */
    public function routeNotificationForMail($notification)
    {
        // Return email address only...
        return $this->email_address;

        // Return email address and name...
        return [$this->email_address => $this->name];
    }
}

件名のカスタマイズ

デフォルトでは、電子メールの件名は、「Title Case」にフォーマットされた通知のクラス名です。したがって、通知クラスの名前が InvoicePaid の場合、電子メールの件名は Invoice Paid になります。メッセージに別の件名を指定したい場合は、メッセージの作成時に subject メソッドを呼び出すことができます。

/**
 * Get the mail representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\MailMessage
 */
public function toMail($notifiable)
{
    return (new MailMessage)
                ->subject('Notification Subject')
                ->line('...');
}

メーラーのカスタマイズ

デフォルトでは、電子メール通知は、config/mail.php 構成ファイルで定義されたデフォルトのメーラーを使用して送信されます。ただし、メッセージの作成時に mailer メソッドを呼び出すことで、実行時に別のメーラーを指定できます。

/**
 * Get the mail representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\MailMessage
 */
public function toMail($notifiable)
{
    return (new MailMessage)
                ->mailer('postmark')
                ->line('...');
}

テンプレートのカスタマイズ

通知パッケージのリソースを公開することで、メール通知で使用される HTML およびプレーンテキストのテンプレートを変更できます。このコマンドを実行すると、メール通知テンプレートが resources/views/vendor/notifications ディレクトリに配置されます。

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

添付ファイル

電子メール通知に添付ファイルを追加するには、メッセージの作成時に attach メソッドを使用します。 attach メソッドは、最初の引数としてファイルへの絶対パスを受け入れます。

/**
 * Get the mail representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\MailMessage
 */
public function toMail($notifiable)
{
    return (new MailMessage)
                ->greeting('Hello!')
                ->attach('/path/to/file');
}

注記通知メールメッセージによって提供される attach メソッドは、取り付け可能なオブジェクトも受け入れます。詳細については、包括的なアタッチ可能なオブジェクトのドキュメントを参照してください。

メッセージにファイルを添付するときは、array を attach メソッドの 2 番目の引数として渡すことで、表示名や MIME タイプを指定することもできます。

/**
 * Get the mail representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\MailMessage
 */
public function toMail($notifiable)
{
    return (new MailMessage)
                ->greeting('Hello!')
                ->attach('/path/to/file', [
                    'as' => 'name.pdf',
                    'mime' => 'application/pdf',
                ]);
}

メール可能オブジェクトにファイルを添付する場合とは異なり、attachFromStorage を使用してストレージディスクからファイルを直接添付することはできません。むしろ、ストレージディスク上のファイルへの絶対パスを指定して attach メソッドを使用する必要があります。あるいは、toMail メソッドから mailable を返すこともできます。

use App\Mail\InvoicePaid as InvoicePaidMailable;

/**
 * Get the mail representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return Mailable
 */
public function toMail($notifiable)
{
    return (new InvoicePaidMailable($this->invoice))
                ->to($notifiable->email)
                ->attachFromStorage('/path/to/file');
}

必要に応じて、attachMany メソッドを使用して複数のファイルをメッセージに添付できます。

/**
 * Get the mail representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\MailMessage
 */
public function toMail($notifiable)
{
    return (new MailMessage)
                ->greeting('Hello!')
                ->attachMany([
                    '/path/to/forge.svg',
                    '/path/to/vapor.svg' => [
                        'as' => 'Logo.svg',
                        'mime' => 'image/svg+xml',
                    ],
                ]);
}

生データの添付ファイル

attachData メソッドを使用して、生のバイト文字列を添付ファイルとして添付できます。 attachData メソッドを呼び出すときは、添付ファイルに割り当てるファイル名を指定する必要があります。

/**
 * Get the mail representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\MailMessage
 */
public function toMail($notifiable)
{
    return (new MailMessage)
                ->greeting('Hello!')
                ->attachData($this->pdf, 'name.pdf', [
                    'mime' => 'application/pdf',
                ]);
}

タグとメタデータの追加

Mailgun や Postmark などの一部のサードパーティ電子メールプロバイダは、メッセージの「タグ」と「メタデータ」をサポートしています。これらは、アプリケーションによって送信された電子メールをグループ化し、追跡するために使用される場合があります。 tag および metadata メソッドを使用して、電子メールメッセージにタグとメタデータを追加できます。

/**
 * Get the mail representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\MailMessage
 */
public function toMail($notifiable)
{
    return (new MailMessage)
                ->greeting('Comment Upvoted!')
                ->tag('upvote')
                ->metadata('comment_id', $this->comment->id);
}

アプリケーションが Mailgun ドライバを使用している場合、tags および metadata の詳細については、Mailgun のドキュメントを参照してください。同様に、tags および metadata のサポートの詳細については、消印のドキュメントを参照することもできます。

アプリケーションが Amazon SES を使用して E メールを送信している場合は、metadata メソッドを使用してメッセージに SESの「タグ」を添付する必要があります。

Symfony メッセージのカスタマイズ

MailMessage クラスの withSymfonyMessage メソッドを使用すると、メッセージを送信する前に Symfony Message インスタンスで呼び出されるクロージャを登録できます。これにより、メッセージを配信する前に詳細にカスタマイズする機会が得られます。

use Symfony\Component\Mime\Email;

/**
 * Get the mail representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\MailMessage
 */
public function toMail($notifiable)
{
    return (new MailMessage)
                ->withSymfonyMessage(function (Email $message) {
                    $message->getHeaders()->addTextHeader(
                        'Custom-Header', 'Header Value'
                    );
                });
}

メール可能ファイルの使用

必要に応じて、通知の toMail メソッドから完全な郵送可能なオブジェクトを返すことができます。 MailMessage の代わりに Mailable を返す場合は、メール可能オブジェクトの to メソッドを使用してメッセージ受信者を指定する必要があります。

use App\Mail\InvoicePaid as InvoicePaidMailable;

/**
 * Get the mail representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return Mailable
 */
public function toMail($notifiable)
{
    return (new InvoicePaidMailable($this->invoice))
                ->to($notifiable->email);
}

メール可能アイテムとオンデマンド通知

オンデマンド通知を送信する場合、toMail メソッドに指定される $notifiable インスタンスは、オンデマンド通知の送信先となる電子メールアドレスを取得するために使用できる routeNotificationFor メソッドを提供する Illuminate\Notifications\AnonymousNotifiable のインスタンスになります。

use App\Mail\InvoicePaid as InvoicePaidMailable;
use Illuminate\Notifications\AnonymousNotifiable;

/**
 * Get the mail representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return Mailable
 */
public function toMail($notifiable)
{
    $address = $notifiable instanceof AnonymousNotifiable
            ? $notifiable->routeNotificationFor('mail')
            : $notifiable->email;

    return (new InvoicePaidMailable($this->invoice))
                ->to($address);
}

メール通知のプレビュー

メール通知テンプレートを設計する場合、一般的な Blade テンプレートと同様に、レンダリングされたメールメッセージをブラウザですばやくプレビューできると便利です。このため、Laravel では、メール通知によって生成されたメールメッセージをルートクロージャーまたはコントローラから直接返すことができます。 MailMessage が返されると、ブラウザーにレンダリングされて表示されるため、実際の電子メールアドレスに送信しなくても、そのデザインをすばやくプレビューできます。

use App\Models\Invoice;
use App\Notifications\InvoicePaid;

Route::get('/notification', function () {
    $invoice = Invoice::find(1);

    return (new InvoicePaid($invoice))
                ->toMail($invoice->user);
});

マークダウンメール通知 (Markdown Mail Notifications)

マークダウンメール通知を使用すると、メール通知の事前に構築されたテンプレートを利用できると同時に、カスタマイズされた長いメッセージをより自由に作成できるようになります。メッセージは Markdown で記述されているため、Laravel はメッセージ用の美しく応答性の高い HTML テンプレートをレンダリングできると同時に、対応するプレーンテキストも自動的に生成します。

メッセージの生成

対応するマークダウンテンプレートで通知を生成するには、make:notification Artisan コマンドの --markdown オプションを使用できます。

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

他のすべてのメール通知と同様、Markdown テンプレートを使用する通知は、通知クラスで toMail メソッドを定義する必要があります。ただし、line メソッドと action メソッドを使用して通知を作成する代わりに、markdown メソッドを使用して、使用する必要がある Markdown テンプレートの名前を指定します。テンプレートで使用できるようにしたいデータの配列は、メソッドの 2 番目の引数として渡すことができます。

/**
 * Get the mail representation of the notification.
 *
 * @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 の事前に作成された通知コンポーネントを活用しながら、通知を簡単に構築できます。

<x-mail::message>
# Invoice Paid

Your invoice has been paid!

<x-mail::button :url="$url">
View Invoice
</x-mail::button>

Thanks,<br>
{{ config('app.name') }}
</x-mail::message>

ボタンコンポーネント

ボタンコンポーネントは、中央にボタンリンクをレンダリングします。このコンポーネントは、url とオプションの color の 2 つの引数を受け入れます。サポートされている色は、primary、green、および red です。ボタンコンポーネントは必要なだけ通知に追加できます。

<x-mail::button :url="$url" color="green">
View Invoice
</x-mail::button>

パネルコンポーネント

パネルコンポーネントは、通知の残りの部分とはわずかに異なる背景色を持つパネルに指定されたテキストブロックをレンダリングします。これにより、特定のテキストブロックに注意を向けることができます。

<x-mail::panel>
This is the panel content.
</x-mail::panel>

テーブルコンポーネント

table コンポーネントを使用すると、Markdown テーブルを HTML テーブルに変換できます。コンポーネントは、Markdown テーブルをコンテンツとして受け入れます。テーブル列の配置は、デフォルトの Markdown テーブル配置構文を使用してサポートされます。

<x-mail::table>
| Laravel       | Table         | Example  |
| ------------- |:-------------:| --------:|
| Col 2 is      | Centered      | $10      |
| Col 3 is      | Right-Aligned | $20      |
</x-mail::table>

コンポーネントのカスタマイズ

すべての Markdown 通知コンポーネントを独自のアプリケーションにエクスポートしてカスタマイズできます。コンポーネントをエクスポートするには、vendor:publish Artisan コマンドを使用して、laravel-mail アセットタグを公開します。

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

このコマンドは、Markdown メールコンポーネントを resources/views/vendor/mail ディレクトリに公開します。 mail ディレクトリには、html ディレクトリと text ディレクトリが含まれ、それぞれに使用可能なすべてのコンポーネントのそれぞれの表現が含まれます。これらのコンポーネントは自由にカスタマイズできます。

CSS のカスタマイズ

コンポーネントをエクスポートすると、resources/views/vendor/mail/html/themes ディレクトリに default.css ファイルが含まれます。このファイルの CSS をカスタマイズすると、スタイルは Markdown 通知の HTML 表現内に自動的にインラインで組み込まれます。

Laravel の Markdown コンポーネント用にまったく新しいテーマを構築したい場合は、CSS ファイルを html/themes ディレクトリ内に配置できます。 CSS ファイルに名前を付けて保存した後、mail 構成ファイルの theme オプションを新しいテーマの名前と一致するように更新します。

個々の通知のテーマをカスタマイズするには、通知のメールメッセージを作成するときに theme メソッドを呼び出すことができます。 theme メソッドは、通知の送信時に使用するテーマの名前を受け入れます。

/**
 * Get the mail representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\MailMessage
 */
public function toMail($notifiable)
{
    return (new MailMessage)
                ->theme('invoice')
                ->subject('Invoice Paid')
                ->markdown('mail.invoice.paid', ['url' => $url]);
}

データベース通知 (Database Notifications)

前提条件

database 通知チャネルは、通知情報をデータベーステーブルに保存します。このテーブルには、通知タイプや通知を説明する JSON データ構造などの情報が含まれます。

テーブルをクエリして、アプリケーションのユーザーインターフェイスに通知を表示できます。ただし、その前に、通知を保持するデータベーステーブルを作成する必要があります。 notifications:table コマンドを使用して、適切なテーブルスキーマを持つ migration を生成できます。

php artisan notifications:table

php artisan migrate

データベース通知のフォーマット

通知がデータベーステーブルへの保存をサポートしている場合は、通知クラスで toDatabase メソッドまたは toArray メソッドを定義する必要があります。このメソッドは $notifiable エンティティを受け取り、プレーンな PHP 配列を返す必要があります。返された配列は JSON としてエンコードされ、notifications テーブルの data 列に保存されます。 toArray メソッドの例を見てみましょう。

/**
 * Get the array representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return array
 */
public function toArray($notifiable)
{
    return [
        'invoice_id' => $this->invoice->id,
        'amount' => $this->invoice->amount,
    ];
}

`toDatabase` vs. `toArray`

toArray メソッドは、JavaScript を利用したフロントエンドにブロードキャストするデータを決定するために、broadcast チャネルでも使用されます。 database チャネルと broadcast チャネルに 2 つの異なる配列表現を使用したい場合は、toArray メソッドの代わりに toDatabase メソッドを定義する必要があります。

通知へのアクセス

通知がデータベースに保存されたら、通知対象エンティティから通知にアクセスする便利な方法が必要になります。 Laravel のデフォルトの App\Models\User モデルに含まれる Illuminate\Notifications\Notifiable トレイトには、エンティティの通知を返す notifications Eloquent リレーションが含まれています。通知を取得するには、他の Eloquent 関係と同様に、このメソッドにアクセスできます。デフォルトでは、通知は created_at タイムスタンプによって並べ替えられ、最新の通知がコレクションの先頭に表示されます。

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

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

「未読」通知のみを取得したい場合は、unreadNotifications 関係を使用できます。繰り返しますが、これらの通知は created_at タイムスタンプによって並べ替えられ、最新の通知がコレクションの先頭に表示されます。

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

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

注記 JavaScript クライアントから通知にアクセスするには、現在のユーザーなどの通知可能なエンティティに通知を返すアプリケーションの通知コントローラを定義する必要があります。その後、JavaScript クライアントからそのコントローラの URL に対して HTTP リクエストを行うことができます。

通知を既読としてマークする

通常、ユーザーが通知を表示したときに、通知を「既読」としてマークする必要があります。 Illuminate\Notifications\Notifiable トレイトは、通知のデータベースレコードの read_at 列を更新する markAsRead メソッドを提供します。

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

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

ただし、各通知をループする代わりに、通知のコレクションに対して markAsRead メソッドを直接使用することもできます。

$user->unreadNotifications->markAsRead();

一括更新クエリを使用して、データベースから通知を取得せずに、すべての通知を既読としてマークすることもできます。

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

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

通知を delete してテーブルから完全に削除できます。

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

ブロードキャスト通知 (Broadcast Notifications)

前提条件

通知をブロードキャストする前に、Laravel のイベント放送サービスを設定し、よく理解しておく必要があります。イベントブロードキャストは、JavaScript を利用したフロントエンドからサーバーサイドの Laravel イベントに反応する方法を提供します。

ブロードキャスト通知のフォーマット

broadcast チャネルは、Laravel のイベント放送サービスを使用して通知をブロードキャストし、JavaScript を利用したフロントエンドがリアルタイムで通知をキャッチできるようにします。通知がブロードキャストをサポートしている場合は、通知クラスで toBroadcast メソッドを定義できます。このメソッドは $notifiable エンティティを受け取り、BroadcastMessage インスタンスを返す必要があります。 toBroadcast メソッドが存在しない場合は、ブロードキャストするデータを収集するために toArray メソッドが使用されます。返されたデータは JSON としてエンコードされ、JavaScript を利用したフロントエンドにブロードキャストされます。 toBroadcast メソッドの例を見てみましょう。

use Illuminate\Notifications\Messages\BroadcastMessage;

/**
 * Get the broadcastable representation of the notification.
 *
 * @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 フィールドもあります。通知 type をカスタマイズしたい場合は、通知クラスで broadcastType メソッドを定義できます。

use Illuminate\Notifications\Messages\BroadcastMessage;

/**
 * Get the type of the notification being broadcast.
 *
 * @return string
 */
public function broadcastType()
{
    return 'broadcast.message';
}

通知をリッスンする

通知は、{notifiable}.{id} 規則を使用してフォーマットされたプライベートチャネルでブロードキャストされます。したがって、1 の ID を持つ App\Models\User インスタンスに通知を送信する場合、通知は App.Models.User.1 プライベートチャネルでブロードキャストされます。 Laravel Echo を使用する場合、notification メソッドを使用してチャネル上の通知を簡単にリッスンできます。

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

通知チャネルのカスタマイズ

エンティティのブロードキャスト通知がどのチャネルでブロードキャストされるかをカスタマイズしたい場合は、通知可能なエンティティで receivesBroadcastNotificationsOn メソッドを定義できます。

<?php

namespace App\Models;

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

class User extends Authenticatable
{
    use Notifiable;

    /**
     * The channels the user receives notification broadcasts on.
     *
     * @return string
     */
    public function receivesBroadcastNotificationsOn()
    {
        return 'users.'.$this->id;
    }
}

SMS通知 (SMS Notifications)

前提条件

Laravel での SMS 通知の送信は、Vonage (旧名 Nexmo) を利用しています。 Vonage 経由で通知を送信する前に、laravel/vonage-notification-channel および guzzlehttp/guzzle パッケージをインストールする必要があります。

composer require laravel/vonage-notification-channel guzzlehttp/guzzle

パッケージには設定ファイルが含まれています。ただし、この構成ファイルを独自のアプリケーションにエクスポートする必要はありません。 VONAGE_KEY および VONAGE_SECRET 環境変数を使用するだけで、Vonage の公開キーと秘密キーを定義できます。

キーを定義した後、デフォルトで SMS メッセージの送信元となる電話番号を定義する VONAGE_SMS_FROM 環境変数を設定する必要があります。この電話番号は、Vonage コントロールパネル内で生成できます。

VONAGE_SMS_FROM=15556666666

SMS 通知のフォーマット

通知が SMS としての送信をサポートしている場合は、通知クラスで toVonage メソッドを定義する必要があります。このメソッドは $notifiable エンティティを受け取り、Illuminate\Notifications\Messages\VonageMessage インスタンスを返す必要があります。

/**
 * Get the Vonage / SMS representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\VonageMessage
 */
public function toVonage($notifiable)
{
    return (new VonageMessage)
                ->content('Your SMS message content');
}

Unicode コンテンツ

SMS メッセージに Unicode 文字が含まれる場合は、VonageMessage インスタンスを構築するときに unicode メソッドを呼び出す必要があります。

/**
 * Get the Vonage / SMS representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\VonageMessage
 */
public function toVonage($notifiable)
{
    return (new VonageMessage)
                ->content('Your unicode message')
                ->unicode();
}

「差出人」番号のカスタマイズ

VONAGE_SMS_FROM 環境変数で指定された電話番号とは異なる電話番号から通知を送信したい場合は、VonageMessage インスタンスで from メソッドを呼び出すことができます。

/**
 * Get the Vonage / SMS representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\VonageMessage
 */
public function toVonage($notifiable)
{
    return (new VonageMessage)
                ->content('Your SMS message content')
                ->from('15554443333');
}

クライアント参照の追加

ユーザー、チーム、またはクライアントごとのコストを追跡したい場合は、通知に「クライアント参照」を追加できます。 Vonage では、このクライアントリファレンスを使用してレポートを生成できるため、特定の顧客の SMS の使用状況をよりよく理解できます。クライアント参照には、最大 40 文字の任意の文字列を指定できます。

/**
 * Get the Vonage / SMS representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\VonageMessage
 */
public function toVonage($notifiable)
{
    return (new VonageMessage)
                ->clientReference((string) $notifiable->id)
                ->content('Your SMS message content');
}

SMS 通知のルーティング

Vonage 通知を適切な電話番号にルーティングするには、通知対象エンティティで routeNotificationForVonage メソッドを定義します。

<?php

namespace App\Models;

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

class User extends Authenticatable
{
    use Notifiable;

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

Slack 通知 (Slack Notifications)

前提条件

Slack 経由で通知を送信するには、Composer 経由で Slack 通知チャネルをインストールする必要があります。

composer require laravel/slack-notification-channel

チーム用にスラックアプリを作成する必要もあります。アプリを作成した後、ワークスペースの「受信 Webhook」を構成する必要があります。 Slack は、Slack 通知のルーティングのときに使用できる Webhook URL を提供します。

Slack 通知の書式設定

通知が Slack メッセージとしての送信をサポートしている場合は、通知クラスで toSlack メソッドを定義する必要があります。このメソッドは $notifiable エンティティを受け取り、Illuminate\Notifications\Messages\SlackMessage インスタンスを返す必要があります。 Slack メッセージには、テキストコンテンツに加えて、追加のテキストやフィールドの配列をフォーマットする「添付ファイル」が含まれる場合があります。基本的な toSlack の例を見てみましょう。

/**
 * Get the Slack representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\SlackMessage
 */
public function toSlack($notifiable)
{
    return (new SlackMessage)
                ->content('One of your invoices has been paid!');
}

スラックアタッチメント

Slack メッセージに「添付ファイル」を追加することもできます。添付ファイルには、単純なテキストメッセージよりも豊富な書式設定オプションが用意されています。この例では、アプリケーションで発生した例外に関するエラー通知を、例外の詳細を表示するリンクを含めて送信します。

/**
 * Get the Slack representation of the notification.
 *
 * @param  mixed  $notifiable
 * @return \Illuminate\Notifications\Messages\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.');
                });
}

添付ファイルを使用すると、ユーザーに表示するデータの配列を指定することもできます。指定されたデータは、読みやすいように表形式で表示されます。

/**
 * 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' => '$1,234',
                                    'Via' => 'American Express',
                                    'Was Overdue' => ':-1:',
                                ]);
                });
}

マークダウン添付ファイルのコンテンツ

添付ファイルフィールドの一部に Markdown が含まれている場合は、markdown メソッドを使用して、指定された添付フィールドを解析して Markdown 形式のテキストとして表示するように Slack に指示できます。このメソッドで受け入れられる値は、pretext、text、および/または fields です。 Slack の添付ファイルの形式の詳細については、Slack API ドキュメントを確認してください。

/**
 * 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']);
                });
}

Slack 通知のルーティング

Slack 通知を適切な Slack チームとチャネルにルーティングするには、通知対象エンティティで routeNotificationForSlack メソッドを定義します。これにより、通知の配信先となる Webhook URL が返されます。 Webhook URL は、Slack チームに「Incoming Webhook」サービスを追加することで生成できます。

<?php

namespace App\Models;

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

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/...';
    }
}

通知のローカライズ (Localizing Notifications)

Laravel では、HTTP リクエストの現在のロケール以外のロケールで通知を送信することができ、通知がキューに入れられている場合でもこのロケールを記憶します。

これを実現するために、Illuminate\Notifications\Notification クラスは、希望の言語を設定するための locale メソッドを提供します。アプリケーションは、通知の評価中にこのロケールに変更され、評価が完了すると前のロケールに戻ります。

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

複数の通知可能なエントリのローカライズは、Notification ファサードを介して実現することもできます。

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

ユーザーの優先ロケール

場合によっては、アプリケーションが各ユーザーの優先ロケールを保存することがあります。通知可能モデルに HasLocalePreference コントラクトを実装することで、通知を送信するときにこの保存されたロケールを使用するように Laravel に指示できます。

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;
    }
}

インターフェースを実装すると、Laravel は通知とメール可能ファイルをモデルに送信するときに優先ロケールを自動的に使用します。したがって、このインターフェイスを使用する場合は、locale メソッドを呼び出す必要はありません。

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

通知イベント (Notification Events)

通知送信イベント

通知の送信中に、通知システムによって Illuminate\Notifications\Events\NotificationSending event がディスパッチされます。これには、「通知可能な」エンティティと通知インスタンス自体が含まれます。アプリケーションの EventServiceProvider でこのイベントのリスナを登録できます。

use App\Listeners\CheckNotificationStatus;
use Illuminate\Notifications\Events\NotificationSending;

/**
 * The event listener mappings for the application.
 *
 * @var array
 */
protected $listen = [
    NotificationSending::class => [
        CheckNotificationStatus::class,
    ],
];

NotificationSending イベントのイベントリスナが handle メソッドから false を返した場合、通知は送信されません。

use Illuminate\Notifications\Events\NotificationSending;

/**
 * Handle the event.
 *
 * @param  \Illuminate\Notifications\Events\NotificationSending  $event
 * @return void
 */
public function handle(NotificationSending $event)
{
    return false;
}

イベントリスナ内で、イベントの notifiable、notification、および channel プロパティにアクセスして、通知受信者または通知自体の詳細を確認できます。

/**
 * Handle the event.
 *
 * @param  \Illuminate\Notifications\Events\NotificationSending  $event
 * @return void
 */
public function handle(NotificationSending $event)
{
    // $event->channel
    // $event->notifiable
    // $event->notification
}

通知送信イベント

通知が送信されると、通知システムによって Illuminate\Notifications\Events\NotificationSent event がディスパッチされます。これには、「通知可能な」エンティティと通知インスタンス自体が含まれます。 EventServiceProvider でこのイベントのリスナを登録できます。

use App\Listeners\LogNotification;
use Illuminate\Notifications\Events\NotificationSent;

/**
 * The event listener mappings for the application.
 *
 * @var array
 */
protected $listen = [
    NotificationSent::class => [
        LogNotification::class,
    ],
];

注記 EventServiceProvider にリスナを登録した後、event:generate Artisan コマンドを使用してリスナクラスをすばやく生成します。

イベントリスナ内で、イベントの notifiable、notification、channel、および response プロパティにアクセスして、通知受信者または通知自体の詳細を確認できます。

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

カスタムチャンネル (Custom Channels)

Laravel にはいくつかの通知チャネルが付属していますが、他のチャネル経由で通知を配信する独自のドライバを作成することもできます。 Laravel を使えば簡単になります。まず、send メソッドを含むクラスを定義します。このメソッドは、$notifiable と $notification の 2 つの引数を受け取る必要があります。

send メソッド内で、通知のメソッドを呼び出して、チャネルによって理解されるメッセージオブジェクトを取得し、通知を $notifiable インスタンスに送信することができます。

<?php

namespace App\Notifications;

use Illuminate\Notifications\Notification;

class VoiceChannel
{
    /**
     * Send the given notification.
     *
     * @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...
    }
}

通知チャネルクラスを定義したら、任意の通知の via メソッドからクラス名を返すことができます。この例では、通知の toVoice メソッドは、音声メッセージを表すために選択したオブジェクトを返すことができます。たとえば、次のメッセージを表す独自の VoiceMessage クラスを定義できます。

<?php

namespace App\Notifications;

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

class InvoicePaid extends Notification
{
    use Queueable;

    /**
     * Get the notification channels.
     *
     * @param  mixed  $notifiable
     * @return array|string
     */
    public function via($notifiable)
    {
        return [VoiceChannel::class];
    }

    /**
     * Get the voice representation of the notification.
     *
     * @param  mixed  $notifiable
     * @return VoiceMessage
     */
    public function toVoice($notifiable)
    {
        // ...
    }
}

導入 (Introduction)​

通知の生成 (Generating Notifications)​

通知の送信 (Sending Notifications)​

通知可能な特性の使用​

通知ファサードの使用​

配信チャネルの指定​

通知のキューイング​

通知の遅延​

チャネルごとの通知の遅延​

通知キュー接続のカスタマイズ​

通知チャネルキューのカスタマイズ​

キューに入れられた通知とデータベーストランザクション​

キューに入れられた通知を送信するかどうかの決定​

オンデマンド通知​

メール通知 (Mail Notifications)​

メールメッセージのフォーマット​

エラーメッセージ​

その他のメール通知の形式オプション​

送信者のカスタマイズ​

受信者のカスタマイズ​

件名のカスタマイズ​

メーラーのカスタマイズ​

テンプレートのカスタマイズ​

添付ファイル​

生データの添付ファイル​

タグとメタデータの追加​

Symfony メッセージのカスタマイズ​

メール可能ファイルの使用​

メール可能アイテムとオンデマンド通知​

メール通知のプレビュー​

マークダウンメール通知 (Markdown Mail Notifications)​

メッセージの生成​

メッセージを書く​

ボタンコンポーネント​

パネルコンポーネント​

テーブルコンポーネント​

コンポーネントのカスタマイズ​

CSS のカスタマイズ​

データベース通知 (Database Notifications)​

前提条件​

データベース通知のフォーマット​

toDatabase vs. toArray​

通知へのアクセス​

通知を既読としてマークする​

ブロードキャスト通知 (Broadcast Notifications)​

前提条件​

ブロードキャスト通知のフォーマット​

ブロードキャストキューの設定​

通知タイプのカスタマイズ​

通知をリッスンする​

通知チャネルのカスタマイズ​

SMS通知 (SMS Notifications)​

前提条件​

SMS 通知のフォーマット​

Unicode コンテンツ​

「差出人」番号のカスタマイズ​

クライアント参照の追加​

SMS 通知のルーティング​

Slack 通知 (Slack Notifications)​

前提条件​

Slack 通知の書式設定​

スラックアタッチメント​

マークダウン添付ファイルのコンテンツ​

Slack 通知のルーティング​

通知のローカライズ (Localizing Notifications)​

ユーザーの優先ロケール​

通知イベント (Notification Events)​

通知送信イベント​

通知送信イベント​

カスタムチャンネル (Custom Channels)​

導入 (Introduction)

通知の生成 (Generating Notifications)

通知の送信 (Sending Notifications)

通知可能な特性の使用

通知ファサードの使用

配信チャネルの指定

通知のキューイング

通知の遅延

チャネルごとの通知の遅延

通知キュー接続のカスタマイズ

通知チャネルキューのカスタマイズ

キューに入れられた通知とデータベーストランザクション

キューに入れられた通知を送信するかどうかの決定

オンデマンド通知

メール通知 (Mail Notifications)

メールメッセージのフォーマット

エラーメッセージ

その他のメール通知の形式オプション

送信者のカスタマイズ

受信者のカスタマイズ

件名のカスタマイズ

メーラーのカスタマイズ

テンプレートのカスタマイズ

添付ファイル

生データの添付ファイル

タグとメタデータの追加

Symfony メッセージのカスタマイズ

メール可能ファイルの使用

メール可能アイテムとオンデマンド通知

メール通知のプレビュー

マークダウンメール通知 (Markdown Mail Notifications)

メッセージの生成

メッセージを書く

ボタンコンポーネント

パネルコンポーネント

テーブルコンポーネント

コンポーネントのカスタマイズ

CSS のカスタマイズ

データベース通知 (Database Notifications)

前提条件

データベース通知のフォーマット

`toDatabase` vs. `toArray`

通知へのアクセス

通知を既読としてマークする

ブロードキャスト通知 (Broadcast Notifications)

前提条件

ブロードキャスト通知のフォーマット

ブロードキャストキューの設定

通知タイプのカスタマイズ

通知をリッスンする

通知チャネルのカスタマイズ

SMS通知 (SMS Notifications)

前提条件

SMS 通知のフォーマット

Unicode コンテンツ

「差出人」番号のカスタマイズ

クライアント参照の追加

SMS 通知のルーティング

Slack 通知 (Slack Notifications)

前提条件

Slack 通知の書式設定

スラックアタッチメント

マークダウン添付ファイルのコンテンツ

Slack 通知のルーティング

通知のローカライズ (Localizing Notifications)

ユーザーの優先ロケール

通知イベント (Notification Events)

通知送信イベント

通知送信イベント

カスタムチャンネル (Custom Channels)