【PHP8.x】CURLOPT_MAIL_RCPT_ALLLOWFAILS定数の使い方

Copy
1<?php
2
3/**
4 * cURL を使用して SMTP 経由でメールを送信するサンプル関数です。
5 * CURLOPT_MAIL_RCPT_ALLLOWFAILS と CURLOPT_RETURNTRANSFER オプションの使用方法を示します。
6 *
7 * このコードはデモンストレーション目的であり、実際に動作させるには
8 * 有効なSMTPサーバー設定と認証情報（もし必要なら）をコメントアウトされた使用例部分に
9 * 設定する必要があります。
10 *
11 * @param string $to 送信先メールアドレス
12 * @param string $from 送信元メールアドレス
13 * @param string $subject メールの件名
14 * @param string $body メールの本文
15 * @param string $smtpHost SMTPサーバーのホスト名 (例: "smtp.example.com")
16 * @param int $smtpPort SMTPサーバーのポート番号 (例: 587 または 465)
17 * @param string|null $username SMTP認証ユーザー名 (オプション)
18 * @param string|null $password SMTP認証パスワード (オプション)
19 * @return array 処理結果を格納した連想配列。
20 *               成功時は ['success' => true, 'response' => '...', 'error' => null]
21 *               失敗時は ['success' => false, 'response' => null, 'error' => 'エラーメッセージ']
22 */
23function sendSmtpMailWithCurl(
24    string $to,
25    string $from,
26    string $subject,
27    string $body,
28    string $smtpHost,
29    int $smtpPort = 587,
30    ?string $username = null,
31    ?string $password = null
32): array {
33    // 1. cURL ハンドルを初期化します。cURLはネットワーク通信を行うためのPHPの拡張機能です。
34    $ch = curl_init();
35    if ($ch === false) {
36        return ['success' => false, 'response' => null, 'error' => 'cURLの初期化に失敗しました。'];
37    }
38
39    // 2. メールの内容を準備します。
40    // 標準的なメール形式（RFC 822）に従い、ヘッダーと本文を結合します。
41    // 各行はCRLF (\r\n) で区切り、ヘッダーと本文の間には空行が必要です。
42    $mailContent = implode("\r\n", [
43        "From: {$from}",
44        "To: {$to}",
45        "Subject: {$subject}",
46        "MIME-Version: 1.0",
47        "Content-type: text/plain; charset=utf-8",
48        "", // ヘッダーと本文の区切りに必要な空行
49        $body,
50    ]);
51
52    // 3. メールの内容を cURL が読み込むためのメモリストリームを作成します。
53    // 'php://temp' は、メモリ上で一時ファイルのようにデータを扱える便利なストリームです。
54    $fp = fopen('php://temp', 'r+');
55    if ($fp === false) {
56        curl_close($ch);
57        return ['success' => false, 'response' => null, 'error' => 'メールコンテンツのストリーム作成に失敗しました。'];
58    }
59    fwrite($fp, $mailContent); // メール内容をストリームに書き込みます
60    fseek($fp, 0); // ストリームの読み込み位置を先頭に戻します
61
62    // 4. cURL オプションを設定します。
63    // cURL の動作を細かく制御するための設定群です。
64    curl_setopt_array($ch, [
65        CURLOPT_URL => "smtp://{$smtpHost}:{$smtpPort}", // SMTPサーバーのアドレスとポートを指定
66        CURLOPT_UPLOAD => true, // ファイルをアップロードするモードに設定 (メール送信もこれに該当します)
67        CURLOPT_MAIL_FROM => "<{$from}>", // 送信元メールアドレスを指定
68        CURLOPT_MAIL_RCPT => ["<{$to}>"], // 送信先メールアドレスを指定 (配列形式)
69
70        // CURLOPT_RETURNTRANSFER: curl_exec() 関数の戻り値を制御する重要なオプションです。
71        // true に設定すると、cURL は実行結果（サーバーからの応答など）を直接出力せず、
72        // 文字列として curl_exec() の戻り値として返します。
73        // SMTP送信の成功時は通常、空文字列または短い成功応答が返されます。
74        CURLOPT_RETURNTRANSFER => true,
75
76        // CURLOPT_MAIL_RCPT_ALLLOWFAILS: SMTP送信時に受信者メールアドレスの検証に失敗した場合でも、
77        // その失敗を許容し、cURLが即座にエラーで終了しないように設定します。
78        // デフォルトは false で、受信者検証失敗時にリクエスト全体が失敗します。
79        // このオプションは、リスト送信などで一部の受信者が無効でも処理を続行したい場合に有用です。
80        CURLOPT_MAIL_RCPT_ALLLOWFAILS => true,
81
82        CURLOPT_INFILESIZE => strlen($mailContent), // アップロードするデータ（メール内容）の合計サイズ
83        CURLOPT_READDATA => $fp, // アップロードするデータの内容を読み込むファイルポインタ
84    ]);
85
86    // 5. SMTP認証情報がある場合、追加でオプションを設定します。
87    if ($username && $password) {
88        curl_setopt_array($ch, [
89            CURLOPT_USERNAME => $username, // SMTP認証のユーザー名
90            CURLOPT_PASSWORD => $password, // SMTP認証のパスワード
91            CURLOPT_USE_SSL => CURLUSESSL_ALL, // 利用可能な場合にSSL/TLSを有効にする
92            CURLOPT_SMTP_AUTH => CURLSMTP_AUTH_LOGIN, // LOGIN認証方式を使用する
93        ]);
94    }
95
96    // 6. cURL リクエストを実行します。
97    // CURLOPT_RETURNTRANSFER が true のため、$response にサーバーからの応答が文字列で格納されます。
98    $response = curl_exec($ch);
99
100    // 7. cURL 実行後にエラーが発生していないかチェックします。
101    if (curl_errno($ch)) {
102        $error = curl_error($ch); // エラーメッセージを取得
103        curl_close($ch);
104        fclose($fp);
105        return ['success' => false, 'response' => null, 'error' => $error];
106    }
107
108    // 8. cURL ハンドルとファイルポインタを閉じ、リソースを解放します。
109    curl_close($ch);
110    fclose($fp);
111
112    // 9. 成功した場合は、結果とサーバー応答を返します。
113    return ['success' => true, 'response' => $response, 'error' => null];
114}
115
116/*
117// --- サンプル使用例（このままでは動作しません。適切なSMTPサーバー情報が必要です） ---
118
119// ご自身のSMTPサーバー情報 (例: GmailのSMTP設定) に置き換えてください。
120// Gmailなどの一般的なメールサービスでは、セキュリティのために「アプリパスワード」の
121// 設定が必要になる場合があります。
122
123// $smtpHost = 'your_smtp.example.com'; // 例: 'smtp.gmail.com'
124// $smtpPort = 587;                     // または 465 (SSLの場合)
125// $username = 'your_email@example.com'; // 例: 'your_gmail_address@gmail.com'
126// $password = 'your_email_password';   // 例: 'your_app_password'
127
128// $to = 'recipient@example.com';
129// $from = 'sender@example.com';
130// $subject = 'PHP cURL メールテスト';
131// $body = 'このメールは PHP の cURL 拡張機能を使って送信されました。';
132
133// 実際にメールを送信するには、上記のダミー情報を有効な情報に置き換えて、
134// 以下のコードのコメントを解除してください。
135// $result = sendSmtpMailWithCurl($to, $from, $subject, $body, $smtpHost, $smtpPort, $username, $password);
136
137// if (isset($result)) { // $result が設定されている場合のみ表示
138//     if ($result['success']) {
139//         echo "メール送信成功！\n";
140//         // SMTPサーバーからの応答を表示。成功時は通常、短い応答か空文字列です。
141//         echo "SMTPサーバー応答: " . ($result['response'] ?: "(応答なし)") . "\n";
142//     } else {
143//         echo "メール送信失敗: " . $result['error'] . "\n";
144//     }
145// } else {
146//     echo "メール送信関数が呼び出されていません。有効な情報を設定してコメントを解除してください。\n";
147// }
148*/

このPHPサンプルコードは、cURLを利用してSMTP経由でメールを送信するsendSmtpMailWithCurl関数です。ネットワーク通信を扱うcURLを初期化し、メールの宛先、送信元、件名、本文、SMTPサーバー情報などを設定してメール送信を行います。

この関数では、特に二つの重要なcURLオプションに注目してください。CURLOPT_MAIL_RCPT_ALLLOWFAILSオプションは、SMTPサーバーが受信者メールアドレスの検証に失敗した場合でも、その失敗をエラーとせず、処理を続行するかどうかを制御します。これをtrueに設定すると、一部の無効な宛先があっても、送信処理全体が直ちに失敗せず、他の有効な宛先への送信試行を続けることが可能になります。

もう一つのCURLOPT_RETURNTRANSFERオプションは、curl_exec()関数の戻り値を制御します。このオプションをtrueに設定すると、curl_exec()は実行結果を直接出力せず、SMTPサーバーからの応答を文字列として戻り値で返します。これにより、プログラム内でサーバー応答を捕捉し、処理の成否やエラー原因を詳細に判断できます。

sendSmtpMailWithCurl関数は、送信先・送信元メールアドレス、件名、本文、SMTPサーバーのホスト名とポート番号、オプションで認証情報などを引数として受け取ります。戻り値は連想配列で、successキーで成功・失敗、responseキーでサーバー応答、errorキーでエラーメッセージを確認できます。このコードを実際に使用するには、有効なSMTPサーバー設定と認証情報が必要となります。

Copy
1<?php
2
3/**
4 * 指定されたURLにHTTPS GETリクエストを送信し、SSL証明書を検証します。
5 *
6 * この関数は、CURLOPT_CAINFO オプションを使用して、サーバーのSSL証明書を
7 * 指定されたCA証明書バンドル（cacert.pemなど）に対して検証する方法を示します。
8 * システムエンジニアを目指す方にとって、HTTPS通信のセキュリティ確保は重要な概念です。
9 *
10 * @param string $url リクエストを送信するURL。
11 * @param string $caInfoPath CA証明書バンドルファイルへのパス。
12 *                          通常は信頼できるCA証明書チェーンが格納されたPEM形式のファイルです。
13 * @return string|false 成功した場合はレスポンス本文、失敗した場合はfalseを返します。
14 */
15function fetchDataWithSslVerification(string $url, string $caInfoPath): string|false
16{
17    // cURLセッションを初期化します。
18    $ch = curl_init();
19
20    if ($ch === false) {
21        echo "エラー: cURLセッションの初期化に失敗しました。\n";
22        return false;
23    }
24
25    // cURLオプションを設定します。
26    // リクエスト先のURLを設定
27    curl_setopt($ch, CURLOPT_URL, $url);
28    // 実行結果を文字列として取得するように設定 (trueにするとcurl_exec()が結果を返す)
29    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
30    // SSL証明書のピア検証を有効にします。HTTPS通信のセキュリティに不可欠です。
31    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
32    // ホスト名の検証を有効にします。証明書のCN (Common Name) やSAN (Subject Alternative Name) とホスト名が一致するか確認します。
33    // 通常は2（厳密な検証）に設定します。
34    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
35    // CA証明書バンドルのファイルパスを指定します。
36    // cURLはこのファイルを使用して、サーバーから提示されたSSL証明書が信頼できるか検証します。
37    // このパスは、信頼できるCA証明書（通常はPEM形式）を含むファイルである必要があります。
38    // 例えば、Linuxでは '/etc/ssl/certs/ca-certificates.crt' など、
39    // WindowsではcURL公式サイトからダウンロードした 'cacert.pem' などがあります。
40    curl_setopt($ch, CURLOPT_CAINFO, $caInfoPath);
41
42    // リクエストを実行し、レスポンスを取得します。
43    $response = curl_exec($ch);
44
45    // cURL実行中にエラーが発生したか確認します。
46    if (curl_errno($ch)) {
47        echo 'cURLエラー (' . curl_errno($ch) . '): ' . curl_error($ch) . "\n";
48        $response = false;
49    }
50
51    // cURLセッションを閉じ、リソースを解放します。
52    curl_close($ch);
53
54    return $response;
55}
56
57// --- 使用例 ---
58
59// 対象とするHTTPS URLを指定します。実際のサイトに変更してください。
60$targetUrl = 'https://www.google.com';
61
62// CA証明書バンドルのパスを指定します。
63// このサンプルを簡単に試せるように、スクリプトと同じディレクトリにダミーファイルを作成します。
64// 本番環境では、必ず信頼できるCA証明書ファイル（例: cacert.pem）への正しいパスを指定してください。
65// ファイルは https://curl.se/docs/caextract.html からダウンロードできます。
66$caBundlePath = __DIR__ . '/cacert.pem';
67
68// もしCA証明書ファイルが存在しない場合、サンプル用にダミーファイルを作成します。
69// 注意: このダミーファイルは検証を行わないため、セキュリティ上は意味がありません。
70// 実際の利用では、正しいCA証明書ファイルを配置する必要があります。
71if (!file_exists($caBundlePath)) {
72    echo "注意: CA証明書ファイル '" . $caBundlePath . "' が見つかりませんでした。\n";
73    echo "サンプル実行のため、ダミーファイルを一時的に作成します。本番環境では使用しないでください。\n";
74    file_put_contents($caBundlePath, "# Dummy CA Certificate for Sample (NOT for Production)\n");
75}
76
77echo "URL: " . $targetUrl . " からデータを取得しています...\n";
78$data = fetchDataWithSslVerification($targetUrl, $caBundlePath);
79
80if ($data !== false) {
81    echo "データ取得に成功しました。最初の200文字:\n";
82    echo substr($data, 0, 200) . "...\n";
83} else {
84    echo "データ取得に失敗しました。\n";
85}
86
87// サンプル用に作成したダミーファイルをクリーンアップします。
88if (file_exists($caBundlePath) && str_contains(file_get_contents($caBundlePath), "# Dummy CA Certificate for Sample")) {
89    unlink($caBundlePath);
90    echo "ダミーのCA証明書ファイルを削除しました。\n";
91}
92
93?>

このPHPのサンプルコードは、cURLライブラリを使用してHTTPS通信を行う際に、サーバーのSSL証明書を検証する方法を示しています。システムエンジニアにとって、安全なデータ通信は非常に重要であり、その基盤となるSSL/TLSプロトコルの理解は不可欠です。

特に注目すべきは、CURLOPT_CAINFOオプションです。このオプションは、信頼できる認証局（CA）の証明書がバンドルされたファイルへのパスを指定します。cURLはこのファイルに格納された情報を用いて、接続先のサーバーが提示するSSL証明書が本物であるか、改ざんされていないかを確認します。これにより、中間者攻撃などによる通信の盗聴や偽装を防ぎ、安全な接続が保証されます。

このコードでは、fetchDataWithSslVerification関数が定義されており、$url引数でアクセスする対象のURLを、$caInfoPath引数でCA証明書バンドルファイルのパスを受け取ります。内部ではCURLOPT_SSL_VERIFYPEERとCURLOPT_SSL_VERIFYHOSTも有効にすることで、SSL証明書のピア検証とホスト名検証を厳格に行い、セキュリティをさらに強化しています。関数の戻り値は、通信が成功した場合は取得したウェブページのコンテンツを文字列として、失敗した場合はfalseを返します。この機能を通じて、ウェブアプリケーションにおけるセキュアな外部連携処理を実装する基礎を学ぶことができます。