【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 * メールを送信する（添付ファイル付き）.
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 を実際の添付ファイルのパスに置き換えてください。また、送信先のメールサーバの設定によっては、追加の認証が必要になる場合があります。