MAMPとMailHogで簡単、Macのローカル環境でメール送信テスト

MailHogとmb_send_mail関数
- 必要なもの
Mailhogをインストール
php.iniの設定変更
- sendmail_pathを変更
メール送信用のコードを用意する
MailHogの起動とMAMPの再起動
- MailHogの起動
- MAMP再起動（PHPの設定再読み込み）
MailHogでメール送信を確認する
- メール送信後

Macで何か開発中の初期段階で、ローカル環境でメール送信テストしたいな！なんて時ありますよね。

Googleでのローカルメール送信の設定は面倒になったようだし、わざわざMailChimpのAPIを使ってやるようなこともない…、そんなあなたに！

MailHogとmb_send_mail関数

紹介するのは、開発環境でのメール送信を捕捉してくれるオープンソースツール「MailHog」と、PHPのmb_send_mail関数、またはmail関数を使う方法です。

はじめに言っておくと、この方法ではメールは実際には送信されません。

メール送受信のエミュレーターを使うようなもので、Gmailなどの外部SMTPサーバーを使用せずに、ローカル環境でメール送信のテストが可能になります。

送受信内容はツール画面かターミナルから確認することができます。

開発中のアプリケーションでちょっとしたメール送信機能をテストする際に便利です。

必要なもの

材料は以下の通りです。

Mailhog（オープンソースツール）
php.iniファイル（MAMP内）
メール送信用PHPコード

前提として、MAMPとHomebrewが入っていること。

実態はPHPのiniファイル変更とツールインストールしかやらないので、MAMPもHomebrewもいらないんですが。

Mailhogをインストール

まずはじめにMailHogをインストールします。

MailHogは、開発環境でのメール送受信を捕捉してくれるオープンソースツールです。実際にメールを送信することなく、送信したメールをWeb画面で確認できます。

MailHogのインストール

Homebrewを使ってMailHogをインストールしましょう。

ターミナルを開いて、以下のコマンドを入力します。

brew install mailhog

MailHogの起動

インストール後、以下のコマンドでMailHogを起動します。

mailhog

MailHogを終了

起動が確認できたら、一旦ターミナル上でMailHogを終了しておきます。

ターミナルで「Ctrl + C」を押して、MailHogプロセスを終了させます。

php.iniの設定変更

次に、MAMPのphp.iniファイルを編集します。

MAMPには複数バージョンのPHPが入っているので、バージョンに合わせて以下の場所を確認しましょう。

/Applications/MAMP/bin/php/php[バージョン]/conf/php.ini

場所がわかったらphp.iniファイルを開きます。

sendmail_pathを変更

sendmail_pathの設定を変更します。

僕はMAMPではPHP8.2.0を使っているので、一部iniファイルの中を抜き出すと下記のようなコードになってます（してます）。

/Applications/MAMP/bin/php/php8.2.0/conf/php.ini

[mail function]
; For Win32 only.
; http://php.net/smtp
SMTP = localhost
; http://php.net/smtp-port
;smtp_port = 25

; For Win32 only.
; http://php.net/sendmail-from
;sendmail_from = ほにゃほにゃ@gmail.com

; For Unix only.  You may supply arguments as well (default: "sendmail -t -i").
; http://php.net/sendmail-path
sendmail_path = "/opt/homebrew/bin/mailhog sendmail"

; Force the addition of the specified parameters to be passed as extra parameters
; to the sendmail binary. These parameters will always replace the value of
; the 5th parameter to mail().
;mail.force_extra_parameters =

; Add X-PHP-Originating-Script: that will include uid of the script followed by the filename
mail.add_x_header = On

; The path to a log file that will log all mail() calls. Log entries include
; the full path of the script, line number, To address and headers.
;mail.log =
; Log mail to syslog (Event Log on Windows).
mail.log = syslog

変更するのは「sendmail_path 」の部分です。

ターミナルから下記コマンドを実行してMailHogのインストールパスを確認してください。

which mailhog

僕の場合は「/opt/homebrew/bin/mailhog sendmail」と出るので、sendmail_pathの部分は以下のようになります。

sendmail_path = "/opt/homebrew/bin/mailhog sendmail"

php.iniのsendmail_pathをMailHogのSMTPサーバーに設定することで、mb_send_mail()関数、またはmail()関数からのすべてのメールをMailHogが捕捉します。

また、MailHogはデフォルトでポート1025にてSMTPサーバーを起動します。

php.iniの初期設定はsmtp_port = 25とありますが、MailHogと競合はしません。上の例ではコメントアウトしてますが、特に使うこともないのでそのままでも大丈夫です。

変更が終わったら保存します。

メール送信用のコードを用意する

メール送信をおこなう登録フォームと処理コードを用意します。

form.php：登録フォーム
send_mail.php：メール送信処理

form.php

<form action="send_mail.php" method="POST">

<label for="name">ユーザー名</label>
<input type="text" id="name" name="name">

<label for="email">メールアドレス</label>
<input type="email" id="email" name="email">

<label for="password">パスワード</label>
<input type="password" id="password" name="password">

<button type="submit">登録する</button>

</form>

send_mail.php

if ($_SERVER["REQUEST_METHOD"] === "POST") {
	$name = $_POST["name”];
	$email = $_POST["email”];
	$password = $_POST["password"];

	// 言語設定
        mb_language('ja');
        mb_internal_encoding('UTF-8');

        // メール送信内容
        $subject = '仮登録の確認';
        $message = "キミはいま仮登録の状態なんだ！\n以下のリンクをクリックして登録を完了してくれよな！”;
        $mailfrom = 'noreply@example.com';

        // ヘッダーの設定
        $headers = ['From' => $mailfrom, 'Content-Type' => 'text/plain; charset=UTF-8', 'Content-Transfer-Encoding' => '8bit'];

        // メール送信
        if (!mb_send_mail($email, $subject, $message, $headers, '-f' . $mail from)) {
            // メール送信失敗時のエラーハンドリング
            $errors[] = "認証メールの送信に失敗したぜ。”;
            error_log("メール送信に失敗したぜ。チェだぜ。”);
        }
}