【PHP8.x】mb_send_mail()関数の使い方

Copy
1<?php
2
3/**
4 * mb_send_mail を使用してメールを送信するサンプル
5 *
6 * SMTP 経由で日本語メールを送信します。
7 * mb_send_mail は内部で適切なエンコード処理を行うため、文字化けを防ぐことができます。
8 *
9 * @param string $to      送信先メールアドレス
10 * @param string $subject 件名
11 * @param string $message 本文
12 * @return bool          送信成功時に true, 失敗時に false
13 */
14function sendMailWithMbSendMail(string $to, string $subject, string $message): bool
15{
16    // 日本語設定 (必須)
17    mb_language("ja");
18    mb_internal_encoding("UTF-8");
19
20    // 追加ヘッダー (From, Content-Type)
21    $additional_headers = [
22        "From: sender@example.com",
23        "Content-Type: text/plain; charset=UTF-8"
24    ];
25
26    // 追加パラメータ (SMTP サーバーの設定)
27    // php.ini で SMTP 設定が済んでいる場合は不要
28    // 例: -f sender@example.com (Return-Path を設定する場合)
29    $additional_params = null;
30
31    // メール送信
32    $result = mb_send_mail($to, $subject, $message, $additional_headers, $additional_params);
33
34    return $result;
35}
36
37// 使用例
38$to = "recipient@example.com";
39$subject = "テストメール";
40$message = "これは日本語のテストメールです。\nmb_send_mail で送信しています。";
41
42if (sendMailWithMbSendMail($to, $subject, $message)) {
43    echo "メールを送信しました。\n";
44} else {
45    echo "メールの送信に失敗しました。\n";
46}
47
48?>

このサンプルコードは、PHPのmb_send_mail関数を使用して、SMTP経由で日本語メールを送信する方法を示しています。mb_send_mail関数は、文字エンコーディングを自動的に処理するため、文字化けを防ぐのに役立ちます。

mb_send_mail関数は、以下の引数を受け取ります。$toは送信先のメールアドレス、$subjectはメールの件名、$messageはメールの本文です。$additional_headersは追加のヘッダー情報（FromやContent-Typeなど）を配列または文字列で指定します。$additional_paramsは追加のパラメータ（SMTPサーバーの設定など）を指定します。php.iniでSMTP設定が済んでいる場合は、nullを指定できます。

サンプルコードでは、まずmb_language関数とmb_internal_encoding関数を使用して、日本語の設定を行います。これは日本語メールを正しく送信するために必須です。次に、$additional_headersでFromアドレスとContent-Type（文字コードを含む）を設定します。最後に、mb_send_mail関数を呼び出してメールを送信し、送信結果（成功または失敗）を返します。

mb_send_mail関数は、メール送信に成功した場合にtrue、失敗した場合にfalseを返します。サンプルコードでは、この戻り値に基づいて、送信結果を画面に表示します。このコードを実行するには、PHPがSMTPサーバーにアクセスできるように設定されている必要があります。

Copy
1<?php
2
3/**
4 * PHPのmb_send_mail関数を使用してメールを送信するサンプルコード。
5 * 日本語の文字化けを防ぐための設定を特に強調しています。
6 *
7 * このスクリプトはメールサーバー（sendmail, Postfix, SSMTPなど）が適切に設定された環境で動作します。
8 * 設定がない場合、メールは実際には送信されません。
9 */
10
11// 内部エンコーディングをUTF-8に設定
12// mb_send_mailは内部的にmb_internal_encodingの設定を使用するため、
13// これを設定することで日本語のテキストが正しく処理されるようになります。
14mb_internal_encoding("UTF-8");
15
16// 送信先メールアドレス
17$to = "recipient@example.com";
18
19// 件名（日本語を含む場合、MIMEエンコードが必要です）
20$subject_raw = "mb_send_mail 日本語テストメール";
21// mb_encode_mimeheaderでMIMEエンコードすることで、メールクライアントでの文字化けを防ぎます。
22// 引数: string $str, string $charset = null, string $encoding = "B", string $LE = "\n"
23// B: Base64エンコード (通常はこれで十分)
24// Q: Quoted-Printableエンコード
25$subject = mb_encode_mimeheader($subject_raw, "UTF-8", "B", "\n");
26
27// メッセージ本文（日本語を含む）
28$message = "このメールはPHPのmb_send_mail関数を使って送信されました。\n";
29$message .= "日本語の文字が正しく表示されるか確認してください。\n";
30$message .= "特殊文字の例: こんにちは世界！ Café de la Poste です。\n";
31
32// 送信元情報
33$from_email = "sender@example.com";
34$from_name = "システム通知";
35// Fromヘッダーも日本語を含む可能性があるためMIMEエンコードします。
36$from = mb_encode_mimeheader($from_name, "UTF-8", "B", "") . " <" . $from_email . ">";
37
38// 追加ヘッダーの構築（文字化け対策の重要な部分）
39$additional_headers = [
40    "From: " . $from,
41    "MIME-Version: 1.0",
42    // Content-TypeでcharsetをUTF-8に指定することが、本文の文字化けを防ぐ上で最も重要です。
43    "Content-Type: text/plain; charset=UTF-8",
44    // Content-Transfer-Encodingは8bitで問題ない場合が多いですが、
45    // より安全にする場合は"base64"を選択することもできます。
46    "Content-Transfer-Encoding: 8bit",
47];
48
49// mb_send_mail 関数でメールを送信
50// PHP 7.2以降では、追加ヘッダーを配列で渡すことができます。
51$mail_sent = mb_send_mail(
52    $to,
53    $subject,
54    $message,
55    $additional_headers
56);
57
58// 送信結果の表示
59if ($mail_sent) {
60    echo "メールが正常に送信されました。\n";
61    echo "宛先: " . $to . "\n";
62    echo "件名（オリジナル）: " . $subject_raw . "\n";
63} else {
64    echo "メールの送信に失敗しました。以下の点を確認してください。\n";
65    echo "- PHPのエラーログ（php.iniで設定）\n";
66    echo "- メールサーバー（sendmail/Postfixなど）の設定と稼働状況\n";
67    echo "- mbstring拡張が有効になっているか\n";
68}
69

PHPのmb_send_mail関数は、日本語のような多バイト文字を含むメールを安全に送信するために使用される機能です。この関数は、メールの宛先を$to、件名を$subject、本文を$messageとして受け取ります。さらに、$additional_headers引数で追加のヘッダー情報、$additional_params引数でPHPのsendmail設定を上書きするパラメータを指定できます。

特に日本語のメールで文字化けを防ぐためには、いくつかの設定が重要です。まず、mb_internal_encoding("UTF-8");でPHPの内部エンコーディングをUTF-8に設定し、文字コードの統一を図ります。次に、件名や差出人名のように日本語を含む部分には、mb_encode_mimeheader関数を使用してMIMEエンコードを施します。これにより、受信側のメールクライアントで正しく表示されるようになります。

最も重要な文字化け対策の一つとして、$additional_headers引数にContent-Type: text/plain; charset=UTF-8というヘッダーを含めることが挙げられます。これは、メール本文がUTF-8でエンコードされていることを明示的に伝える役割を果たします。また、Content-Transfer-Encoding: 8bitを指定することで、テキストデータが正しく転送されます。

mb_send_mail関数は、これらの設定に基づいてメールの送信を試み、成功した場合はtrue、失敗した場合はfalseを戻り値として返します。この戻り値を確認することで、プログラム内でメール送信の成否を判断できます。なお、この関数が実際にメールを送信するためには、PHPが動作するサーバーにsendmailやPostfixなどのメールサーバーが適切に設定され、稼働している必要があります。

Copy
1<?php
2
3/**
4 * メールを送信する（添付ファイル付き）.
5 *
6 * @param string $to      送信先メールアドレス
7 * @param string $subject 件名
8 * @param string $message 本文
9 * @param string $attachment_path 添付ファイルのパス
10 *
11 * @return bool 送信成功時にtrue、失敗時にfalse
12 */
13function send_mail_with_attachment(string $to, string $subject, string $message, string $attachment_path): bool
14{
15    $boundary = "--" . md5(uniqid(rand(), true)); // バウンダリ文字列を生成
16
17    // ヘッダー情報を設定
18    $headers = [
19        "MIME-Version: 1.0",
20        "Content-Type: multipart/mixed; boundary=\"{$boundary}\"",
21        "Content-Transfer-Encoding: 7bit",
22        "X-Mailer: PHP/" . phpversion()
23    ];
24
25    // 本文の作成
26    $body = "--{$boundary}\n";
27    $body .= "Content-Type: text/plain; charset=UTF-8\n";
28    $body .= "Content-Transfer-Encoding: 8bit\n\n";
29    $body .= $message . "\n\n";
30
31    // 添付ファイルの処理
32    if (file_exists($attachment_path)) {
33        $file_name = basename($attachment_path);
34        $file_size = filesize($attachment_path);
35        $file_data = file_get_contents($attachment_path);
36        $file_data = base64_encode($file_data);
37
38        $body .= "--{$boundary}\n";
39        $body .= "Content-Type: application/octet-stream; name=\"{$file_name}\"\n";
40        $body .= "Content-Disposition: attachment; filename=\"{$file_name}\"\n";
41        $body .= "Content-Transfer-Encoding: base64\n\n";
42        $body .= chunk_split($file_data) . "\n\n";
43    }
44
45    $body .= "--{$boundary}--\n";
46
47    // mb_send_mail でメールを送信
48    return mb_send_mail($to, $subject, $body, implode("\r\n", $headers));
49}
50
51// 使用例
52$to = "recipient@example.com";
53$subject = "添付ファイル付きのメール";
54$message = "これは添付ファイル付きのメールのサンプルです。";
55$attachment_path = "path/to/your/attachment.txt"; // 添付ファイルのパスを指定
56
57// 添付ファイルを送信
58$result = send_mail_with_attachment($to, $subject, $message, $attachment_path);
59
60if ($result) {
61    echo "メールを送信しました。\n";
62} else {
63    echo "メールの送信に失敗しました。\n";
64}
65
66?>

PHP 8.4 の mb_send_mail 関数を使って、添付ファイル付きのメールを送信するサンプルコードです。mb_send_mail は、マルチバイト文字列を扱う場合に便利なメール送信関数です。

このサンプルでは、send_mail_with_attachment という関数を定義しています。この関数は、宛先 ($to)、件名 ($subject)、本文 ($message)、そして添付ファイルのパス ($attachment_path) を引数として受け取ります。

まず、メールのContent-Typeを multipart/mixed に設定し、バウンダリ文字列を生成します。次に、ヘッダー情報を作成し、メール本文を作成します。添付ファイルが存在する場合は、ファイルの内容を読み込み、Base64エンコードしてメール本文に追加します。

mb_send_mail 関数には、宛先、件名、メール本文、追加ヘッダーを文字列として渡します。追加ヘッダーは、改行文字 (\r\n) で連結した文字列として渡す必要があります。

mb_send_mail 関数は、メールの送信に成功した場合に true、失敗した場合に false を返します。サンプルコードでは、返り値を確認して、メール送信の成否をメッセージとして表示します。

このサンプルコードを使用する際は、$attachment_path を実際の添付ファイルのパスに置き換えてください。また、送信先のメールサーバの設定によっては、追加の認証が必要になる場合があります。

Copy
1<?php
2
3/**
4 * 日本語対応のメールを送信するサンプル関数。
5 *
6 * mb_send_mail は、PHPがメールをMTA (Mail Transfer Agent) に引き渡すことに成功したかどうかを返します。
7 * 実際にメールが受信者に届くかどうかは、MTAの設定やネットワーク、スパムフィルターなどに依存します。
8 * 「送信できない」という問題の多くは、PHPの設定ではなく、MTAの設定やメール内容に起因します。
9 * このサンプルでは、mb_send_mailの基本的な使い方と、文字化けや送信失敗の原因になりにくいヘッダーの設定方法を示します。
10 *
11 * @param string $to 送信先メールアドレス
12 * @param string $subject メールの件名
13 * @param string $message メール本文
14 * @param string $fromName 送信元名
15 * @param string $fromEmail 送信元メールアドレス
16 * @param string|null $replyToEmail 返信先メールアドレス (省略可能、指定しない場合は$fromEmailが使用される)
17 * @return bool メール送信のPHP側での成否 (MTAへの引き渡し成功ならtrue)
18 */
19function sendJapaneseEmail(
20    string $to,
21    string $subject,
22    string $message,
23    string $fromName,
24    string $fromEmail,
25    ?string $replyToEmail = null
26): bool {
27    // 1. 文字エンコーディングの設定
28    // 日本語を使用する場合、mb_languageとmb_internal_encodingは必須です。
29    mb_language('Japanese');
30    mb_internal_encoding('UTF-8');
31
32    // 2. 件名のエンコード
33    // 件名に日本語を含む場合、mb_encode_mimeheaderでMIMEエンコードする必要があります。
34    // 第3引数 'B' はBase64エンコーディングを意味します。
35    $encodedSubject = mb_encode_mimeheader($subject, 'UTF-8', 'B');
36
37    // 3. 追加ヘッダーの準備
38    // Fromヘッダーの送信元名もMIMEエンコードします。
39    // 追加ヘッダーは配列で渡すのがPHPの推奨です。PHPが内部的に各ヘッダーをCRLFで結合してMTAに渡します。
40    $additionalHeaders = [
41        "From: " . mb_encode_mimeheader($fromName, 'UTF-8', 'B') . " <{$fromEmail}>",
42        "MIME-Version: 1.0",
43        "Content-Type: text/plain; charset=UTF-8", // 日本語対応のためにUTF-8を指定
44        "Content-Transfer-Encoding: 8bit", // 8bitエンコーディングを指定
45    ];
46
47    // 返信先アドレスの設定
48    if ($replyToEmail !== null) {
49        $additionalHeaders[] = "Reply-To: {$replyToEmail}";
50    } else {
51        $additionalHeaders[] = "Reply-To: {$fromEmail}";
52    }
53
54    // 4. 追加のパラメータ設定
55    // `-f` オプションは、Return-Path (バウンスメールの送り先) を指定します。
56    // これは多くのシステムで推奨される設定であり、メールの信頼性向上に役立ちます。
57    $additionalParams = "-f{$fromEmail}";
58
59    // 5. メール送信
60    // mb_send_mail の引数: 宛先, エンコード済み件名, 本文, 追加ヘッダー(配列), 追加パラメータ
61    $isSent = mb_send_mail($to, $encodedSubject, $message, $additionalHeaders, $additionalParams);
62
63    // 6. 送信結果の表示
64    if ($isSent) {
65        echo "メールがMTAに正常に引き渡されました。実際にメールが届くか確認してください。\n";
66    } else {
67        echo "メールの送信に失敗しました（PHP側での引き渡し失敗）。\n";
68        echo "PHPの `error_log` やウェブサーバーのログ、MTA (Mail Transfer Agent) の設定を確認してください。\n";
69    }
70
71    return $isSent;
72}
73
74// --- 使用例 ---
75// 実際にメールを送信するには、`recipient@example.com` と `sender@example.com` を有効なメールアドレスに置き換え、
76// サーバーでMTA（例: Postfix, Sendmail, またはPHPの`php.ini`で設定されたSMTPサーバー）が適切に設定されている必要があります。
77$recipientEmail = 'recipient@example.com'; // 送信先のメールアドレス
78$senderName = 'テスト送信者'; // 送信元名
79$senderEmail = 'sender@example.com'; // 送信元のメールアドレス
80$mailSubject = 'PHP mb_send_mail テストメール - 日本語対応'; // 件名
81$mailBody = "こんにちは、\n\nこれはPHPのmb_send_mail関数を使用したテストメールです。\n日本語が正しく表示されるか確認してください。\n\nよろしくお願いいたします。\n"; // メール本文
82
83// メールを送信
84sendJapaneseEmail($recipientEmail, $mailSubject, $mailBody, $senderName, $senderEmail);
85
86// 返信先アドレスを別途指定する場合の例
87// sendJapaneseEmail(
88//     'another_recipient@example.com',
89//     '別のテストメール',
90//     '返信先アドレスを指定したテストです。',
91//     '別テスト送信者',
92//     'another_sender@example.com',
93//     'custom_reply_to@example.com' // カスタム返信先アドレス
94// );

mb_send_mail関数は、PHPから多バイト文字（日本語など）を含むメールを送信するために使用される重要な関数です。この関数は、宛先（$to）、件名（$subject）、本文（$message）を主な引数として受け取ります。特に日本語メールを扱う際は、文字化けを防ぐため、mb_languageとmb_internal_encodingで適切なエンコーディングを設定し、件名や送信元名にはmb_encode_mimeheaderを使用してMIMEエンコードを施す必要があります。追加ヘッダー（$additional_headers）には、FromやReply-To、Content-Typeといった詳細情報を配列形式で指定し、メールの形式や送信元を明示します。また、$additional_paramsには、メールの送信元アドレスをバウンスメールの戻り先として指定する-fオプションなどを設定し、メールの信頼性を高めることが推奨されます。

この関数の戻り値はbool型で、PHPがメールをMTA (Mail Transfer Agent) と呼ばれる外部のメールシステムに引き渡すことに成功したかどうかを示します。trueは引き渡し成功を意味しますが、実際にメールが受信者に届くかどうかは、MTAの設定、ネットワーク状況、またはスパムフィルターなど、PHPの制御外の要因に大きく依存します。「送信できない」という問題の多くは、PHP側の処理ではなく、サーバーのMTA設定やメール内容に起因することが多いため、サンプルコードでは文字化けや送信失敗の原因になりにくい、実践的な日本語メール送信の基本設定を示しています。メールの安定した送信には、PHPの設定に加えて、サーバーで利用しているMTA（例：Postfix, Sendmail）の適切な設定が不可欠です。