MENU
  1. ホーム
  2. PHP
  3. PHPでテキストとHTML形式のマルチパートメール送信方法を解説

PHPでテキストとHTML形式のマルチパートメール送信方法を解説

PHP

PHPでテキスト形式とHTML形式のマルチパートメールを送信する方法は、ユーザーに合わせた柔軟なメール配信が可能になるため、ビジネスや個人プロジェクトでも広く活用されています。テキスト形式のみのメールは一部の環境での可読性に優れる一方、HTML形式のメールは視覚的にリッチな内容が伝えられるという利点があります。マルチパートメールは、この両方の形式を同時に含むため、受信者の環境や設定に合わせて適切な形式で表示されるようになっています。本記事では、PHPを使用してこのマルチパートメールを構成し、実際に送信するための具体的な手順やコード例を紹介します。

目次

マルチパートメールとは


マルチパートメールとは、テキスト形式とHTML形式の両方のコンテンツを一つのメール内に含め、受信者の環境に応じて適切な形式で表示されるようにしたメール形式です。多くのメールクライアントでは、受信者がテキスト形式を好む場合はテキスト部分が表示され、HTML形式を好む場合やサポートしている場合には、リッチなHTML形式が表示されます。この構成により、ユーザーエクスペリエンスを向上させると同時に、さまざまなメール環境に対応可能です。

なぜマルチパートメールが重要なのか


マルチパートメールを送信することで、次のような利点があります：

  • 受信者の設定に適応：HTMLメールが表示できない環境でも、テキスト形式で内容を伝えることが可能です。
  • セキュリティと互換性の向上：テキストとHTMLの両方を含むことで、互換性や読みやすさが向上します。
  • ユーザーエクスペリエンスの向上：画像やリンクを含むHTML形式は視覚的にわかりやすく、伝えたい内容がより効果的に伝えられます。

PHPでのマルチパートメール送信に必要な準備


PHPでマルチパートメールを送信するには、まずいくつかの環境設定や準備が必要です。PHPにはデフォルトでメール送信機能が備わっていますが、特にマルチパートメールの場合は、適切な構成とメールヘッダーの設定が必要になります。

必要なPHP環境の確認


PHPのmail()関数は、標準のメール送信をサポートしていますが、サーバーの設定によってはメールが正常に送信されないこともあります。事前に以下を確認しておきましょう：

  • PHPバージョン：PHPの最新バージョンほど、セキュリティや互換性の向上が図られているため推奨されます。
  • サーバー設定：sendmailやSMTPが正しく設定されているか、特に外部サーバーを利用する場合は注意が必要です。
  • PHPのメール送信設定：php.iniでsendmail_pathやSMTPなどが適切に設定されていることを確認してください。

マルチパートメール送信に必要なヘッダー設定


マルチパートメールの送信には、通常のメールとは異なる追加のヘッダー設定が必要です。具体的には、Content-Typeをmultipart/alternativeとして指定し、テキストとHTMLの両方のパートを含む構成が必要になります。また、ユニークなバウンダリー（境界線）を設定することで、メールクライアントがテキストとHTMLの各パートを区別できるようにします。

以上の準備を整えることで、PHPによるマルチパートメールの送信がスムーズに行える環境が構築されます。

メールのヘッダー設定方法


PHPでマルチパートメールを送信する際には、適切なヘッダーを設定することが非常に重要です。ヘッダーは、メールの形式やエンコーディング、送り元や受け取り先に関する情報を定義し、特にマルチパートメールではContent-Typeやboundary（バウンダリー）がメールの構成を管理します。

基本的なヘッダー情報の設定


まず、メールのヘッダー情報として以下を設定します：

  • From：送信者のメールアドレス
  • Reply-To：返信先のメールアドレス
  • MIME-Version：バージョン指定（通常は1.0）

以下のコード例で、基本的なヘッダー情報を設定します：

$headers = "From: example@example.com\r\n";
$headers .= "Reply-To: reply@example.com\r\n";
$headers .= "MIME-Version: 1.0\r\n";

マルチパートメール用のヘッダー設定


マルチパートメールを構成するためには、Content-Typeをmultipart/alternativeに設定し、各パートを識別するためのバウンダリーを指定します。バウンダリーは任意の文字列ですが、ユニークなものを指定します。

$boundary = md5(uniqid(time())); // ユニークなバウンダリーを生成
$headers .= "Content-Type: multipart/alternative; boundary=\"$boundary\"\r\n";

エンコード方式の設定


メールのエンコード方式はContent-Transfer-Encodingで指定します。通常、7bitまたはquoted-printableを指定しますが、HTMLメールにはquoted-printableが推奨されます。

以上の設定を加えたヘッダーが完成すれば、PHPでテキストとHTMLの両方を含むマルチパートメールを送信する準備が整います。

テキスト部分の作成方法


マルチパートメールにおけるテキスト部分は、HTML形式のメールを表示できない環境や、テキストメールを優先的に表示する設定にしている受信者に向けた内容です。この部分を適切に作成することで、受信者全員に確実に情報を届けることができます。

テキスト部分の基本的な作成方法


テキスト部分はシンプルで読みやすい内容にすることが重要です。HTMLタグやスタイルを含めず、純粋なテキストで表現します。改行は\r\nで設定し、視覚的に情報が伝わりやすい構成にします。

// テキスト形式のメール内容
$textContent = "こんにちは、\r\n";
$textContent .= "このメールはPHPから送信されています。\r\n";
$textContent .= "HTML対応メールを表示できない場合、このテキスト内容をご覧ください。\r\n";
$textContent .= "お問い合わせは、example@example.comまでご連絡ください。\r\n";

テキスト部分の注意点


テキスト形式のメールには、次のような点に注意して作成します。

  • リンクの明記：URLなどを含む場合は、「https://example.com」のように完全なURLを明記します。
  • 可読性の確保：長い行は適宜改行を入れ、段落ごとに空行を挟むと読みやすくなります。
  • シンプルな表現：視覚的な効果は期待できないため、簡潔で分かりやすい表現を心がけましょう。

テキスト部分は、HTML形式と同じ情報を含めつつ、見やすさとシンプルさを重視することで、より多くの受信者に対応できるようにします。

HTML部分の作成方法


HTML部分は、画像やリンク、文字装飾などを利用して視覚的に訴求力のあるメールを作成するために用いられます。HTML形式のメールは受信者にリッチな情報を提供できる一方で、デザインやコードが複雑になるため、特に慎重に作成することが求められます。

HTML部分の基本的な構成


HTML形式のメールは、メールクライアントに依存しないよう、スタイルをインラインで指定し、外部のCSSファイルは使用しないのが一般的です。また、テーブルレイアウトを用いることで、レイアウトの崩れを防ぎます。

// HTML形式のメール内容
$htmlContent = "<html><body>";
$htmlContent .= "<h1 style='color: #333;'>こんにちは</h1>";
$htmlContent .= "<p>このメールはPHPから送信されています。<br>";
$htmlContent .= "HTML形式のメールをお楽しみください。</p>";
$htmlContent .= "<p><a href='https://example.com' style='color: #1a73e8;'>こちら</a>から詳細をご覧ください。</p>";
$htmlContent .= "<p>お問い合わせは、<a href='mailto:example@example.com'>example@example.com</a>までご連絡ください。</p>";
$htmlContent .= "</body></html>";

HTMLメールの作成時のポイント


HTML形式のメールを作成する際には、以下のポイントに注意します：

  • インラインスタイル：メールクライアントによってCSSサポートが異なるため、スタイルはインラインで指定します。
  • テーブルレイアウト：レイアウトの安定性を確保するため、基本的にテーブルタグを用いて構成します。
  • 画像の使用：画像は外部URLを使用するか、ベース64エンコードすることで表示させます。ただし、すべてのメールクライアントが画像を自動的に表示するわけではないため、画像が表示されないことを想定してテキストでの代替表現も検討します。
  • リンクの明確化：リンクの色やデザインを調整し、クリックしやすくします。

HTML形式の内容を適切に作成することで、より魅力的で情報量の多いメールを送信することができ、受信者にインパクトを与えることができます。

テキストとHTMLを組み合わせたマルチパートメールの構成


テキストとHTMLの両方の形式を持つマルチパートメールは、multipart/alternative形式で送信されます。この形式は、テキスト形式とHTML形式の両方の内容を含むため、受信者のメールクライアントが対応している形式で最適な表示が可能になります。

マルチパートメールの構成例


マルチパートメールを構成するには、まず「バウンダリー」を定義し、メールの各部分（テキストとHTML）をそのバウンダリーで区切ります。以下に、PHPコードを用いた構成例を示します。

// ユニークなバウンダリーを生成
$boundary = md5(uniqid(time()));

// ヘッダー設定
$headers = "MIME-Version: 1.0\r\n";
$headers .= "Content-Type: multipart/alternative; boundary=\"$boundary\"\r\n";

// テキスト部分
$textContent = "こんにちは、\r\n";
$textContent .= "このメールはPHPから送信されています。\r\n";
$textContent .= "HTML対応メールを表示できない場合、このテキスト内容をご覧ください。\r\n";

// HTML部分
$htmlContent = "<html><body>";
$htmlContent .= "<h1 style='color: #333;'>こんにちは</h1>";
$htmlContent .= "<p>このメールはPHPから送信されています。<br>";
$htmlContent .= "HTML形式のメールをお楽しみください。</p>";
$htmlContent .= "<p><a href='https://example.com' style='color: #1a73e8;'>こちら</a>から詳細をご覧ください。</p>";
$htmlContent .= "<p>お問い合わせは、<a href='mailto:example@example.com'>example@example.com</a>までご連絡ください。</p>";
$htmlContent .= "</body></html>";

// メール本文（マルチパート構成）
$body = "--$boundary\r\n";
$body .= "Content-Type: text/plain; charset=\"UTF-8\"\r\n";
$body .= "Content-Transfer-Encoding: 7bit\r\n\r\n";
$body .= $textContent . "\r\n";
$body .= "--$boundary\r\n";
$body .= "Content-Type: text/html; charset=\"UTF-8\"\r\n";
$body .= "Content-Transfer-Encoding: 7bit\r\n\r\n";
$body .= $htmlContent . "\r\n";
$body .= "--$boundary--";

マルチパート構成の仕組み


この構成では、$boundaryで定義した文字列を利用して、テキスト部分とHTML部分を区切っています。それぞれのパートの前にはContent-TypeとContent-Transfer-Encodingを設定し、メールクライアントが適切に解釈できるようにします。

  • テキスト部分：最初のパートにはプレーンテキストが格納され、Content-Typeをtext/plainに指定します。
  • HTML部分：次のパートにはHTML内容を格納し、Content-Typeをtext/htmlに指定します。

この構成により、マルチパートメールが正常に機能し、受信者の環境に応じた形式で表示されるようになります。

添付ファイル付きマルチパートメールの作成方法


テキストとHTML形式のメールに添付ファイルを追加するには、multipart/mixed形式を用いてメールを構成します。この形式では、テキスト部分とHTML部分に加えて、ファイルデータを別のパートとして含めることができ、ファイルを受信者がダウンロード可能な形で送信できます。

添付ファイルを追加するための基本構成


添付ファイル付きのメールでは、まずメインのバウンダリーを生成し、その内部にテキストとHTML形式のバウンダリーとファイルバウンダリーを含めて構成します。

// メインのバウンダリー生成
$boundary_main = md5(uniqid(time()));
// テキストとHTML用のサブバウンダリー
$boundary_alt = md5(uniqid(time()));

// ヘッダー設定
$headers = "MIME-Version: 1.0\r\n";
$headers .= "Content-Type: multipart/mixed; boundary=\"$boundary_main\"\r\n";

// テキストとHTML部分
$textContent = "こんにちは、\r\n";
$textContent .= "このメールはPHPから送信されています。\r\n";
$htmlContent = "<html><body>";
$htmlContent .= "<h1 style='color: #333;'>こんにちは</h1>";
$htmlContent .= "<p>このメールはPHPから送信されています。<br>";
$htmlContent .= "HTML形式のメールをお楽しみください。</p>";
$htmlContent .= "</body></html>";

// 添付ファイルの読み込み
$file_path = "/path/to/your/file.pdf"; // ファイルパスを指定
$file_name = basename($file_path);
$file_data = chunk_split(base64_encode(file_get_contents($file_path))); // ファイルのエンコード

// メール本文（マルチパート構成）
$body = "--$boundary_main\r\n";
$body .= "Content-Type: multipart/alternative; boundary=\"$boundary_alt\"\r\n\r\n";

// テキスト部分
$body .= "--$boundary_alt\r\n";
$body .= "Content-Type: text/plain; charset=\"UTF-8\"\r\n";
$body .= "Content-Transfer-Encoding: 7bit\r\n\r\n";
$body .= $textContent . "\r\n";

// HTML部分
$body .= "--$boundary_alt\r\n";
$body .= "Content-Type: text/html; charset=\"UTF-8\"\r\n";
$body .= "Content-Transfer-Encoding: 7bit\r\n\r\n";
$body .= $htmlContent . "\r\n";
$body .= "--$boundary_alt--\r\n";

// 添付ファイル部分
$body .= "--$boundary_main\r\n";
$body .= "Content-Type: application/pdf; name=\"$file_name\"\r\n";
$body .= "Content-Disposition: attachment; filename=\"$file_name\"\r\n";
$body .= "Content-Transfer-Encoding: base64\r\n\r\n";
$body .= $file_data . "\r\n";
$body .= "--$boundary_main--";

添付ファイル付きマルチパート構成の仕組み


この構成では、以下のようにパートを分けてメールを構成しています：

  • メインバウンダリー（$boundary_main）：メール全体をラップし、サブバウンダリー（テキストとHTML部分）および添付ファイル部分を含めます。
  • サブバウンダリー（$boundary_alt）：テキスト部分とHTML部分を含めるためのパートで、multipart/alternativeで指定します。
  • 添付ファイル部分：ファイルをbase64でエンコードし、Content-Typeを指定してファイル名も設定します。

この方法により、受信者にテキストおよびHTML形式のメールと添付ファイルを一度に送信でき、視覚的な情報とファイルを一緒に届けられます。

メール送信に使うPHPコード例


ここでは、PHPを使用してテキストとHTML形式のマルチパートメールに添付ファイルを加えたメールを送信するための完全なコード例を紹介します。このコードは、上記の内容を統合し、メール送信プロセスを実行します。

<?php
// 送信先メールアドレス
$to = "recipient@example.com";
// メール件名
$subject = "テキストとHTML形式のマルチパートメール例";
// 送信元メールアドレス
$from = "sender@example.com";

// ユニークなバウンダリーを生成
$boundary_main = md5(uniqid(time()));
$boundary_alt = md5(uniqid(time()));

// ヘッダー設定
$headers = "From: $from\r\n";
$headers .= "Reply-To: $from\r\n";
$headers .= "MIME-Version: 1.0\r\n";
$headers .= "Content-Type: multipart/mixed; boundary=\"$boundary_main\"\r\n";

// テキスト部分のコンテンツ
$textContent = "こんにちは、\r\n";
$textContent .= "このメールはPHPから送信されています。\r\n";
$textContent .= "HTML対応メールを表示できない場合、このテキスト内容をご覧ください。\r\n";

// HTML部分のコンテンツ
$htmlContent = "<html><body>";
$htmlContent .= "<h1 style='color: #333;'>こんにちは</h1>";
$htmlContent .= "<p>このメールはPHPから送信されています。<br>";
$htmlContent .= "HTML形式のメールをお楽しみください。</p>";
$htmlContent .= "<p><a href='https://example.com' style='color: #1a73e8;'>こちら</a>から詳細をご覧ください。</p>";
$htmlContent .= "<p>お問い合わせは、<a href='mailto:example@example.com'>example@example.com</a>までご連絡ください。</p>";
$htmlContent .= "</body></html>";

// 添付ファイルの設定
$file_path = "/path/to/your/file.pdf"; // 添付ファイルのパスを指定
$file_name = basename($file_path);
$file_data = chunk_split(base64_encode(file_get_contents($file_path))); // 添付ファイルのエンコード

// メール本文の構成（マルチパート構成）
$body = "--$boundary_main\r\n";
$body .= "Content-Type: multipart/alternative; boundary=\"$boundary_alt\"\r\n\r\n";

// テキスト部分
$body .= "--$boundary_alt\r\n";
$body .= "Content-Type: text/plain; charset=\"UTF-8\"\r\n";
$body .= "Content-Transfer-Encoding: 7bit\r\n\r\n";
$body .= $textContent . "\r\n";

// HTML部分
$body .= "--$boundary_alt\r\n";
$body .= "Content-Type: text/html; charset=\"UTF-8\"\r\n";
$body .= "Content-Transfer-Encoding: 7bit\r\n\r\n";
$body .= $htmlContent . "\r\n";
$body .= "--$boundary_alt--\r\n";

// 添付ファイル部分
$body .= "--$boundary_main\r\n";
$body .= "Content-Type: application/pdf; name=\"$file_name\"\r\n";
$body .= "Content-Disposition: attachment; filename=\"$file_name\"\r\n";
$body .= "Content-Transfer-Encoding: base64\r\n\r\n";
$body .= $file_data . "\r\n";
$body .= "--$boundary_main--";

// メールを送信
if (mail($to, $subject, $body, $headers)) {
    echo "メールが送信されました。";
} else {
    echo "メール送信に失敗しました。";
}
?>

コード解説


このコードのポイントは、メールの各パートを正しい形式で構成し、バウンダリーで区切ることです。

  • ヘッダー設定：From、Reply-Toなど基本的な情報を設定し、multipart/mixed形式を指定。
  • テキストとHTMLのバウンダリー：multipart/alternativeでテキストとHTMLのパートを構成。
  • 添付ファイルの設定：添付ファイルをbase64でエンコードし、Content-Typeとファイル名を指定。

このようにして、テキスト、HTML、添付ファイルの各部分をまとめたマルチパートメールをPHPで送信できます。

実装時のトラブルシューティング


マルチパートメールの送信では、設定のミスやサーバー側の制限によってエラーが発生することがあります。ここでは、よくあるエラーとその解決方法について説明します。

メールが送信されない


最もよくある問題は、メール自体が送信されないケースです。この場合、以下の点を確認しましょう：

  • サーバーのメール送信設定：sendmailまたはSMTPが適切に設定されているか確認します。php.iniでの設定も見直しましょう。
  • PHPのエラーログ確認：PHPのエラーログに「メール送信エラー」や「sendmailエラー」などの記録が残されていることがあります。これにより、問題の原因が特定できることもあります。
  • 送信先メールアドレスの有効性：メールアドレスが間違っていないか確認します。

添付ファイルが正しく表示されない


添付ファイルが破損したり、正しく表示されない場合は、エンコード設定に原因があるかもしれません：

  • Content-Typeとエンコードの設定：ファイルのContent-Typeを正しく指定することが重要です。例えば、PDFの場合はapplication/pdfと指定し、エンコードはbase64を使用します。
  • ファイルパスの確認：ファイルのパスが正しいか、読み取り可能であるか確認しましょう。ファイルパスが間違っているとファイルが正しく取得できず、添付されません。

テキストとHTMLの表示が意図通りでない


マルチパートメールを送信しても、テキスト部分とHTML部分が正しく表示されない場合があります。

  • バウンダリーの重複チェック：バウンダリーが重複していないか確認してください。同じバウンダリー文字列が他の部分で使われていると、メールクライアントが内容を正しく認識できないことがあります。
  • ヘッダーと本文の区切り：各パートの前後に適切な区切り（\r\n）が入っているか確認します。特に、--バウンダリーの記述後には必ず改行が必要です。

メールが迷惑メールフォルダに入る


メールが迷惑メールフォルダに入ってしまう場合、次の対策を試しましょう：

  • SPFやDKIMの設定：サーバー側でSPFやDKIMを設定することで、送信元の信頼性を高められます。
  • 適切な件名と送信元アドレス：迷惑メールとして認識されやすい内容を避け、送信元のアドレスも信頼性が高いドメインから送るようにします。

PHPエラーのデバッグ方法


問題が発生した場合、以下のようなPHPデバッグ方法を活用しましょう：

  • error_reporting(E_ALL);とini_set('display_errors', 1);を利用し、実行時のエラーを画面に表示します。
  • mail()関数の返り値を確認し、送信結果がfalseの場合はエラー内容を調査します。

上記のトラブルシューティングを行うことで、メール送信の問題解決がスムーズに進み、マルチパートメールが適切に配信できるようになります。

応用編：PHPMailerでのマルチパートメール送信


PHPのmail()関数は基本的なメール送信には便利ですが、カスタマイズ性や信頼性が不足している場合もあります。PHPMailerライブラリを使うと、SMTP認証や添付ファイルの追加が簡単に行え、より堅牢でセキュアなメール送信が可能です。ここでは、PHPMailerを用いてテキストとHTML形式のマルチパートメールを送信する方法を紹介します。

PHPMailerのインストール


PHPMailerを利用するために、まずインストールを行います。以下のコマンドでComposerを用いてインストールできます：

composer require phpmailer/phpmailer

PHPMailerを使ったマルチパートメール送信のコード例


インストール後、以下のコードでPHPMailerを使用したマルチパートメールの送信ができます。ここでは、SMTPを使ってテキストとHTML形式のメールを送信し、添付ファイルを追加します。

<?php
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

require 'vendor/autoload.php'; // ComposerでインストールしたPHPMailerを読み込み

$mail = new PHPMailer(true);

try {
    // SMTP設定
    $mail->isSMTP();
    $mail->Host = 'smtp.example.com'; // SMTPサーバーのホスト名
    $mail->SMTPAuth = true;
    $mail->Username = 'your-email@example.com'; // SMTPユーザー名
    $mail->Password = 'your-password'; // SMTPパスワード
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS; // TLS暗号化
    $mail->Port = 587;

    // メールの送信元と送信先
    $mail->setFrom('sender@example.com', 'Sender Name');
    $mail->addAddress('recipient@example.com', 'Recipient Name');

    // 添付ファイルを追加
    $mail->addAttachment('/path/to/your/file.pdf'); // 添付ファイルのパスを指定

    // マルチパートメッセージの設定
    $mail->isHTML(true);
    $mail->Subject = 'PHPMailerでのマルチパートメール送信例';

    // HTMLメールの本文
    $htmlContent = "<h1>こんにちは</h1><p>このメールはPHPMailerから送信されています。</p>";
    $mail->Body = $htmlContent;

    // テキストメールの本文
    $textContent = "こんにちは、\nこのメールはPHPMailerから送信されています。";
    $mail->AltBody = $textContent;

    // メールを送信
    $mail->send();
    echo "メールが送信されました。";
} catch (Exception $e) {
    echo "メール送信に失敗しました: {$mail->ErrorInfo}";
}
?>

コード解説

  • SMTP設定：SMTPサーバーの情報や認証設定を行います。SMTPを使用することで、メール配信の信頼性が向上します。
  • 送信先と送信元の設定：setFrom()とaddAddress()で送信元と受信者の情報を設定します。
  • マルチパート設定：isHTML(true)を指定し、BodyにHTML本文、AltBodyにテキスト本文を設定することでマルチパートメールを構成します。
  • 添付ファイル：addAttachment()でファイルを添付します。

PHPMailerの利点


PHPMailerを使用すると、SMTP経由での送信やエラーの詳細なログ取得、SSL/TLS暗号化の設定が簡単にでき、セキュリティや配信率の向上につながります。また、HTMLとテキストのマルチパートメールやファイル添付などの操作も簡単です。

PHPMailerを活用することで、より安全で柔軟なメール送信を実現し、プロジェクトのメール配信要件を効率的に満たせます。

まとめ


本記事では、PHPでテキスト形式とHTML形式のマルチパートメールを送信する方法について、基礎から応用まで解説しました。PHPの標準のmail()関数を用いたマルチパートメールの送信手順や、ファイル添付の実装方法、PHPMailerを使用したSMTPメール送信の応用例も紹介しました。

マルチパートメールの作成と適切なヘッダー設定により、受信者のメールクライアントに応じた柔軟な表示が可能になります。PHPMailerを活用することで、セキュリティや信頼性を向上させ、ビジネス用途やプロジェクトの要件に適したメール配信が実現できます。

PHP
メール送信 HTMLメール PHP マルチパート

コメント

コメントする

目次