Laravel にはメールや slack の通知などを行う為に Notification クラスが用意されています。メールの送信に Notification クラスを用いると記述もシンプルになってとても使いやすいのでおすすめです。

Laravel でのメール送信を Notification クラスを利用してシンプルに実装する

Laravel では、メールや slackの通知などを行う為に Notification クラスが用意されています。
今回は Notification クラスを利用してメール送信を行います。
<h2 id="contents">Contents</h2>
<ol>
<li><a href="#%E9%96%8B%E7%99%BA%E7%92%B0%E5%A2%83">開発環境</a></li>
<li><a href="#notification-%E3%82%AF%E3%83%A9%E3%82%B9%E3%81%A8-blade-%E3%83%86%E3%83%B3%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88%E3%81%AE%E4%BD%9C%E6%88%90">Notification クラスと Blade テンプレートの作成</a></li>
<li><a href="#notification-%E3%82%AF%E3%83%A9%E3%82%B9">Notification クラス</a></li>
<li><a href="#%E3%82%B3%E3%83%B3%E3%83%88%E3%83%AD%E3%83%BC%E3%83%A9">コントローラ</a></li>
<li><a href="#%E3%83%AB%E3%83%BC%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0">ルーティング</a></li>
<li><a href="#%E5%8B%95%E4%BD%9C%E7%A2%BA%E8%AA%8D">動作確認</a></li>
<li><a href="#html-%E3%83%A1%E3%83%BC%E3%83%AB%E3%81%AE%E3%83%97%E3%83%AC%E3%83%93%E3%83%A5%E3%83%BC%E7%94%BB%E9%9D%A2%E3%82%92%E4%BD%9C%E6%88%90%E3%81%99%E3%82%8B">HTML メールのプレビュー画面を作成する</a></li>
</ol>
<h2 id="開発環境">開発環境</h2>
今回の開発環境は以下の通りです。
<ul>
<li>Laravel 7</li>
</ul>
ブラウザからは http://localhost で Laravel の welcome ページが表示される状態で進めていくので、ドメインは適宜置き換えてください。
メールを送信する部分があるので、受信可能なメールアドレスを用意する、もしくは <a href="https://mailcatcher.me/" rel="noopener noreferrer" target="_blank">MailCatcher</a> や <a href="https://github.com/mailhog/MailHog" rel="noopener noreferrer" target="_blank">MailHog</a> などの、開発用の SMTP サーバ（localhostに送信して表示してくれる）の用意が必要な部分があります。
<h2 id="notification-クラスと-blade-テンプレートの作成">Notification クラスと Blade テンプレートの作成</h2>
まずは通知を行うための Notification クラスと Blade テンプレートを作成します。以下の artisan コマンドを実行します。
<pre><code class="hljs language-shell"># Notification クラスと Blade テンプレートを作成
php artisan make:notification SampleNotification --markdown=mail.sample
</code></pre>
今回、メールは Markdown で記述するのでオプションを指定しています。（今回ここには触れないのでお好きなやつで進めてください）
artisan コマンドを実行すると、以下のファイルが作成されます。
<ul>
<li>app/Notifications/SampleNotification.php</li>
<li>resources/views/mail/sample.blade.php</li>
</ul>
<pre><code class="hljs language-shell">app
├─ Notifications
│   └─ SampleNotification.php

resources
├─ views
   ├─ mail
   │   └─ sample.blade.php
</code></pre>
<dl class="description_setting">
<dt>app/Notifications/SampleNotification.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php

namespace App\Notifications;

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

class SampleNotification extends Notification
{
 use Queueable;

 /**
 * Create a new notification instance.
 *
 * @return void
 */
 public function __construct()
 {
 //
 }

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

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

 /**
 * Get the array representation of the notification.
 *
 * @param mixed $notifiable
 * @return array
 */
 public function toArray($notifiable)
 {
 return [
 //
 ];
 }
}
</code></pre>
</dd>
</dl>
<dl class="description_setting">
<dt>resources/views/mail/sample.blade.php</dt>
<dd>
<pre><code class="hljs language-php">@component('mail::message')
# Introduction

The body of your message.

@component('mail::button', ['url' => ''])
Button Text
@endcomponent

Thanks,&#x3C;br>
{{ config('app.name') }}
@endcomponent
</code></pre>
</dd>
</dl>
<h2 id="notification-クラス">Notification クラス</h2>
Notification クラスを定義します。toMail() メソッドを以下のように実装します。
<dl class="description_setting">
<dt>app/Notifications/SampleNotification.php</dt>
<dd>
<pre><code class="hljs language-php">use App\Models\User; // &#x3C;- use しておく


public function toMail(User $user)
{
 return (new MailMessage)
 ->from(config('mail.from.address'))
 ->subject('送信テスト')
 ->markdown('mail.sample');
}
</code></pre>
</dd>
</dl>
<ul>
<li>User モデル（laravel にデフォルトで作成されている User モデルです）を use しておきます。
<ul>
<li>このあとで、送信対象を User として送信するので、このメソッドには User が渡ってくる想定です。</li>
</ul>
</li>
<li>from() で渡しているのは、config から取得した From メールアドレスです。.env の MAIL_FROM_ADDRESS にメールアドレスを設定しましょう。その値が使用されます。
<ul>
<li>キャッシュの状況次第では送信者のメールアドレスがないとエラーが出るので、その場合はキャッシュを削除します。</li>
</ul>
</li>
<li>markdown() でテンプレート名を渡しています。先程の artisan コマンドで生成した Blade ファイルです。ディレクトリが切られている場合は例のようにドット記法で記述できます。
<ul>
<li>Markdown 記法ではない場合は適宜ここを置き換えてください。</li>
</ul>
</li>
</ul>
<h2 id="コントローラ">コントローラ</h2>
次に、コントローラを作成します。以下の artisan コマンドを実行して、SampleController を作成します。
<pre><code class="hljs language-shell"># Sample コントローラ作成
php artisan make:controller SampleController
</code></pre>
artisan コマンドを実行すると、以下のファイルが作成されます。
-app/Http/Controllers/SampleController.php
<pre><code class="hljs language-shell">app
├─ Http
│   ├─ Controllers
│   │   ├─ SampleController.php
</code></pre>
コントローラにメールでの通知を実装します。
<dl class="description_setting">
<dt>app/Http/Controllers/SampleController.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php

declare(strict_types=1);

namespace App\Http\Controllers;

use App\Models\User;
use App\Notifications\SampleNotification;

class SampleController extends Controller
{
 public function index()
 {
 // ユーザーデータを取得したつもり
 $user = new User([
 'name' => 'Test User',
 'email' => 'test_user@example.com',
 ]);

 // 通知
 $user->notify(new SampleNotification());
 }
}
</code></pre>
</dd>
</dl>
<ul>
<li>通知する対象のモデルから notify() を実行する事で、その対象へ（もしくはその対象に関する）通知を行う事ができます。</li>
<li>引数には、先程作成した SampleNotification をインスタンス化して渡してあげます。</li>
</ul>
なお、今回はデフォルトで存在している User モデルを使用していますが、もし別のモデルを使用する場合は、Notifiable トレイト をモデル内で use しておく必要があります。
<pre><code class="hljs language-php">use Illuminate\Notifications\Notifiable;

class User extends Authenticatable
{
 use Notifiable; // &#x3C;- use する
</code></pre>
<h2 id="ルーティング">ルーティング</h2>
通知を送信するためにルーティングを定義します。
<dl class="description_setting">
<dt>routes/web.php</dt>
<dd>
<pre><code class="hljs language-php">// 追加
Route::get('/sample', 'SampleController@index');
</code></pre>
</dd>
</dl>
<h2 id="動作確認">動作確認</h2>
これで一連の流れは実装したので、ブラウザから http://localhost/sample にアクセスするか、GET でリクエストを行えばメールが送信されます。
<div class="img_wrap"><amp-img layout="responsive" src="/images/posts/210/s6YXvugwtgbj7wDykTIJ.png" width="800" height="499" alt="メール受信画面"></div>
これでメールの送信を実装できました。
<h2 id="html-メールのプレビュー画面を作成する">HTML メールのプレビュー画面を作成する</h2>
メールの本文を作成している際に、毎回メールを送信して本文の HTML 表示を確認するのは手間がかかります。
そこで、ブラウザ上で HTML メールのビューを確認できるようにします。
先ほどの通知の場合、例えばルーティングを以下のように記述します。
<dl class="description_setting">
<dt>routes/web.php</dt>
<dd>
<pre><code class="hljs language-php">// 追加
Route::get('/preview', function () {
 // データを取得したつもり
 $user = new User([
 'name' => 'Test User',
 'email' => 'test_user@example.com',
 ]);

 return (new \App\Notifications\SampleNotification())->toMail($user);
});
</code></pre>
</dd>
</dl>
<ul>
<li>ルーティングで Notification クラスの toMail() 結果を返してあげるとブラウザ上でメール本文 HTML のプレビューを行う事ができます。</li>
<li>Notification クラスのインスタンス生成時の名前空間は use して省略できますが、一時的なプレビューなのでこのルーティングはビューが出来上がったら削除するということで直接指定しています。</li>
</ul>
http://localhost/preview へアクセスします。
<div class="img_wrap"><amp-img layout="responsive" src="/images/posts/210/Kyj9Dgz29aVT6arFhOXb.png" width="800" height="524" alt="メール本文HTMLのプレビュー画面"></div>
これでメールを実際に送信しなくても HTML メールのビューを確認できるようになりました。
<h2 id="まとめ">まとめ</h2>
メールの送信に Notification クラスを用いると記述もシンプルになってとても使いやすいのでおすすめです。
ぜひ試してみてください。

Laravel では、メールや slackの通知などを行う為に Notification クラスが用意されています。
今回は Notification クラスを利用してメール送信を行います。
<h2 id="contents">Contents</h2>
<ol>
<li><a href="#%E9%96%8B%E7%99%BA%E7%92%B0%E5%A2%83">開発環境</a></li>
<li><a href="#notification-%E3%82%AF%E3%83%A9%E3%82%B9%E3%81%A8-blade-%E3%83%86%E3%83%B3%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88%E3%81%AE%E4%BD%9C%E6%88%90">Notification クラスと Blade テンプレートの作成</a></li>
<li><a href="#notification-%E3%82%AF%E3%83%A9%E3%82%B9">Notification クラス</a></li>
<li><a href="#%E3%82%B3%E3%83%B3%E3%83%88%E3%83%AD%E3%83%BC%E3%83%A9">コントローラ</a></li>
<li><a href="#%E3%83%AB%E3%83%BC%E3%83%86%E3%82%A3%E3%83%B3%E3%82%B0">ルーティング</a></li>
<li><a href="#%E5%8B%95%E4%BD%9C%E7%A2%BA%E8%AA%8D">動作確認</a></li>
<li><a href="#html-%E3%83%A1%E3%83%BC%E3%83%AB%E3%81%AE%E3%83%97%E3%83%AC%E3%83%93%E3%83%A5%E3%83%BC%E7%94%BB%E9%9D%A2%E3%82%92%E4%BD%9C%E6%88%90%E3%81%99%E3%82%8B">HTML メールのプレビュー画面を作成する</a></li>
</ol>
<h2 id="開発環境">開発環境</h2>
今回の開発環境は以下の通りです。
<ul>
<li>Laravel 7</li>
</ul>
ブラウザからは http://localhost で Laravel の welcome ページが表示される状態で進めていくので、ドメインは適宜置き換えてください。
メールを送信する部分があるので、受信可能なメールアドレスを用意する、もしくは <a href="https://mailcatcher.me/" rel="noopener noreferrer" target="_blank">MailCatcher</a> や <a href="https://github.com/mailhog/MailHog" rel="noopener noreferrer" target="_blank">MailHog</a> などの、開発用の SMTP サーバ（localhostに送信して表示してくれる）の用意が必要な部分があります。
<h2 id="notification-クラスと-blade-テンプレートの作成">Notification クラスと Blade テンプレートの作成</h2>
まずは通知を行うための Notification クラスと Blade テンプレートを作成します。以下の artisan コマンドを実行します。
<pre><code class="hljs language-shell"># Notification クラスと Blade テンプレートを作成
php artisan make:notification SampleNotification --markdown=mail.sample
</code></pre>
今回、メールは Markdown で記述するのでオプションを指定しています。（今回ここには触れないのでお好きなやつで進めてください）
artisan コマンドを実行すると、以下のファイルが作成されます。
<ul>
<li>app/Notifications/SampleNotification.php</li>
<li>resources/views/mail/sample.blade.php</li>
</ul>
<pre><code class="hljs language-shell">app
├─ Notifications
│   └─ SampleNotification.php

resources
├─ views
   ├─ mail
   │   └─ sample.blade.php
</code></pre>
<dl class="description_setting">
<dt>app/Notifications/SampleNotification.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php

namespace App\Notifications;

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

class SampleNotification extends Notification
{
 use Queueable;

 /**
 * Create a new notification instance.
 *
 * @return void
 */
 public function __construct()
 {
 //
 }

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

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

 /**
 * Get the array representation of the notification.
 *
 * @param mixed $notifiable
 * @return array
 */
 public function toArray($notifiable)
 {
 return [
 //
 ];
 }
}
</code></pre>
</dd>
</dl>
<dl class="description_setting">
<dt>resources/views/mail/sample.blade.php</dt>
<dd>
<pre><code class="hljs language-php">@component('mail::message')
# Introduction

The body of your message.

@component('mail::button', ['url' => ''])
Button Text
@endcomponent

Thanks,&#x3C;br>
{{ config('app.name') }}
@endcomponent
</code></pre>
</dd>
</dl>
<h2 id="notification-クラス">Notification クラス</h2>
Notification クラスを定義します。toMail() メソッドを以下のように実装します。
<dl class="description_setting">
<dt>app/Notifications/SampleNotification.php</dt>
<dd>
<pre><code class="hljs language-php">use App\Models\User; // &#x3C;- use しておく


public function toMail(User $user)
{
 return (new MailMessage)
 ->from(config('mail.from.address'))
 ->subject('送信テスト')
 ->markdown('mail.sample');
}
</code></pre>
</dd>
</dl>
<ul>
<li>User モデル（laravel にデフォルトで作成されている User モデルです）を use しておきます。
<ul>
<li>このあとで、送信対象を User として送信するので、このメソッドには User が渡ってくる想定です。</li>
</ul>
</li>
<li>from() で渡しているのは、config から取得した From メールアドレスです。.env の MAIL_FROM_ADDRESS にメールアドレスを設定しましょう。その値が使用されます。
<ul>
<li>キャッシュの状況次第では送信者のメールアドレスがないとエラーが出るので、その場合はキャッシュを削除します。</li>
</ul>
</li>
<li>markdown() でテンプレート名を渡しています。先程の artisan コマンドで生成した Blade ファイルです。ディレクトリが切られている場合は例のようにドット記法で記述できます。
<ul>
<li>Markdown 記法ではない場合は適宜ここを置き換えてください。</li>
</ul>
</li>
</ul>
<h2 id="コントローラ">コントローラ</h2>
次に、コントローラを作成します。以下の artisan コマンドを実行して、SampleController を作成します。
<pre><code class="hljs language-shell"># Sample コントローラ作成
php artisan make:controller SampleController
</code></pre>
artisan コマンドを実行すると、以下のファイルが作成されます。
-app/Http/Controllers/SampleController.php
<pre><code class="hljs language-shell">app
├─ Http
│   ├─ Controllers
│   │   ├─ SampleController.php
</code></pre>
コントローラにメールでの通知を実装します。
<dl class="description_setting">
<dt>app/Http/Controllers/SampleController.php</dt>
<dd>
<pre><code class="hljs language-php">&#x3C;?php

declare(strict_types=1);

namespace App\Http\Controllers;

use App\Models\User;
use App\Notifications\SampleNotification;

class SampleController extends Controller
{
 public function index()
 {
 // ユーザーデータを取得したつもり
 $user = new User([
 'name' => 'Test User',
 'email' => 'test_user@example.com',
 ]);

 // 通知
 $user->notify(new SampleNotification());
 }
}
</code></pre>
</dd>
</dl>
<ul>
<li>通知する対象のモデルから notify() を実行する事で、その対象へ（もしくはその対象に関する）通知を行う事ができます。</li>
<li>引数には、先程作成した SampleNotification をインスタンス化して渡してあげます。</li>
</ul>
なお、今回はデフォルトで存在している User モデルを使用していますが、もし別のモデルを使用する場合は、Notifiable トレイト をモデル内で use しておく必要があります。
<pre><code class="hljs language-php">use Illuminate\Notifications\Notifiable;

class User extends Authenticatable
{
 use Notifiable; // &#x3C;- use する
</code></pre>
<h2 id="ルーティング">ルーティング</h2>
通知を送信するためにルーティングを定義します。
<dl class="description_setting">
<dt>routes/web.php</dt>
<dd>
<pre><code class="hljs language-php">// 追加
Route::get('/sample', 'SampleController@index');
</code></pre>
</dd>
</dl>
<h2 id="動作確認">動作確認</h2>
これで一連の流れは実装したので、ブラウザから http://localhost/sample にアクセスするか、GET でリクエストを行えばメールが送信されます。
<div class="img_wrap"><img src="/images/posts/210/s6YXvugwtgbj7wDykTIJ.png" width="800" height="499" alt="メール受信画面"></div>
これでメールの送信を実装できました。
<h2 id="html-メールのプレビュー画面を作成する">HTML メールのプレビュー画面を作成する</h2>
メールの本文を作成している際に、毎回メールを送信して本文の HTML 表示を確認するのは手間がかかります。
そこで、ブラウザ上で HTML メールのビューを確認できるようにします。
先ほどの通知の場合、例えばルーティングを以下のように記述します。
<dl class="description_setting">
<dt>routes/web.php</dt>
<dd>
<pre><code class="hljs language-php">// 追加
Route::get('/preview', function () {
 // データを取得したつもり
 $user = new User([
 'name' => 'Test User',
 'email' => 'test_user@example.com',
 ]);

 return (new \App\Notifications\SampleNotification())->toMail($user);
});
</code></pre>
</dd>
</dl>
<ul>
<li>ルーティングで Notification クラスの toMail() 結果を返してあげるとブラウザ上でメール本文 HTML のプレビューを行う事ができます。</li>
<li>Notification クラスのインスタンス生成時の名前空間は use して省略できますが、一時的なプレビューなのでこのルーティングはビューが出来上がったら削除するということで直接指定しています。</li>
</ul>
http://localhost/preview へアクセスします。
<div class="img_wrap"><img src="/images/posts/210/Kyj9Dgz29aVT6arFhOXb.png" width="800" height="524" alt="メール本文HTMLのプレビュー画面"></div>
これでメールを実際に送信しなくても HTML メールのビューを確認できるようになりました。
<h2 id="まとめ">まとめ</h2>
メールの送信に Notification クラスを用いると記述もシンプルになってとても使いやすいのでおすすめです。
ぜひ試してみてください。

Author