Mailpit は、偽の電子メール配信を処理するためのツールで、アプリケーション開発時に役立ちます。このチュートリアルでは、SMTP と UI 構成を使用して MacOS 上で Mailpit をセットアップして実行する方法を説明します。

ステップ 1: Mailpit をインストールする
公式 GitHub リポジトリから Mailpit をダウンロードしてインストールします。 MacOS に適切なバイナリを選択してください。

ステップ 2: Mailpit を実行する
Mailpit を起動するには、次のコマンドを使用します:

mailpit --smtp 0.0.0.0:1025 --listen 0.0.0.0:8025

このコマンドは、ポート 1025 で SMTP サーバーを起動し、ポート 8025 で Web UI を起動します。

SMTP: 0.0.0.0:1025 は電子メール配信を処理します。
UI: 0.0.0.0:8025 では、送信されたメールを表示できます。
アドレスがすでに使用されているというエラーが発生した場合は、同じポートで他のサービスが実行されていないことを確認してください。必要に応じてコマンドを調整することで、別のポートを使用できます。

ステップ 3: Laravel メール設定を構成する
Laravel .env ファイルで、メール設定を構成します:

環境

MAIL_MAILER=smtp
MAIL_HOST=127.0.0.1
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS="[email protected]"
MAIL_FROM_NAME="${APP_NAME}"

この設定は、Laravel が Mailpit の SMTP サーバー経由で電子メールを送信するように指示します。

ステップ 4: 電子メール送信のテスト
アプリケーションが電子メールを送信すると、

http://localhost:8025
これにより、アプリケーションによって送信されたすべての電子メールが表示されます。

トラブルシューティング
接続が拒否されました: Mailpit が正しいポート (SMTP の場合は 1025) で実行されていることを確認してください。
ポートの競合: 「bind: アドレスはすでに使用されています」エラーが発生した場合は、コマンドのポートを変更するか、競合しているサービスを停止してください。
それでおしまい！開発環境で偽の電子メール配信を処理および表示するように Mailpit を正常に設定しました。