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

Copy
1<?php
2
3/**
4 * HTTPS経由で指定されたURLにPOSTリクエストを送信し、レスポンスを返します。
5 *
6 * @param string $url POSTリクエストを送信するターゲットURL。
7 * @param array $data 送信するPOSTデータの連想配列。
8 * @return string|false レスポンス本文（成功時）、またはfalse（エラー発生時）。
9 */
10function sendHttpsPostRequest(string $url, array $data): string|false
11{
12    // cURLセッションを初期化
13    $ch = curl_init();
14
15    if ($ch === false) {
16        error_log("cURL初期化に失敗しました。");
17        return false;
18    }
19
20    // cURLオプションを設定
21    // ターゲットURLを設定
22    curl_setopt($ch, CURLOPT_URL, $url);
23    // POSTリクエストを有効にする
24    curl_setopt($ch, CURLOPT_POST, true);
25    // 送信するPOSTデータを設定 (URLエンコード形式)
26    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
27    // レスポンスを文字列として受け取るように設定 (画面に出力しない)
28    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
29
30    // SSL/TLS証明書の検証を有効にする (セキュリティのため本番環境では必須)
31    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
32    // ホスト名が証明書と一致するか検証する (セキュリティのため本番環境では必須)
33    // 2は一般的な検証レベル。0は検証を無効にするが非推奨。
34    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
35
36    // プロトコルビットマスクの例としてCURLPROTO_SMBSを使用できますが、
37    // HTTPS POSTリクエストには直接関係がないため、ここではコメントアウトします。
38    // 例: 特定のプロトコルのみを許可する場合 (CURLPROTO_HTTPSは通常デフォルトで有効)
39    // curl_setopt($ch, CURLOPT_PROTOCOLS, CURLPROTO_HTTPS | CURLPROTO_HTTP);
40    // CURLPROTO_SMBS はSMB/CIFSプロトコルを許可する定数で、値は整数です。
41    // var_dump(CURLPROTO_SMBS); // int(2048) のような値
42
43    // リクエストを実行し、レスポンスを取得
44    $response = curl_exec($ch);
45
46    if (curl_errno($ch)) {
47        // cURL実行中にエラーが発生した場合
48        $error_msg = curl_error($ch);
49        error_log("cURLエラー: " . $error_msg);
50        curl_close($ch);
51        return false;
52    }
53
54    // cURLセッションを閉じる
55    curl_close($ch);
56
57    return $response;
58}
59
60// --------------------------------------------------------------------------------
61// 使用例
62// --------------------------------------------------------------------------------
63
64// テスト用のダミーAPIエンドポイント (POSTリクエストを受け付け、送信されたデータをJSONで返す)
65$targetUrl = 'https://httpbin.org/post';
66// 送信するPOSTデータ
67$postData = [
68    'username' => 'system_engineer_beginner',
69    'id' => 12345,
70    'message' => 'Hello from PHP cURL HTTPS POST!',
71];
72
73echo "HTTPS POSTリクエストを送信中...\n";
74$result = sendHttpsPostRequest($targetUrl, $postData);
75
76if ($result !== false) {
77    echo "成功: レスポンスを受信しました。\n";
78    echo "---------------------------------\n";
79    // 受信したJSONレスポンスを整形して表示
80    echo json_encode(json_decode($result), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE) . "\n";
81    echo "---------------------------------\n";
82} else {
83    echo "失敗: POSTリクエストの送信中にエラーが発生しました。\n";
84}

このPHPサンプルコードは、cURLライブラリを用いてHTTPS（SSL/TLS暗号化されたHTTP）経由で指定のURLへPOSTリクエストを送信する手順を示しています。sendHttpsPostRequest関数は、ターゲットURLと送信するデータを連想配列で受け取り、リクエストが成功すればサーバーからのレスポンス本文を文字列で、失敗した場合はfalseを返します。

関数内では、まずcurl_init()でcURLセッションを初期化し、その後curl_setopt()関数で様々なオプションを設定します。CURLOPT_URLでリクエストの送信先URLを指定し、CURLOPT_POSTをtrueに設定してPOSTリクエストを有効にします。送信するデータはhttp_build_query()でURLエンコード形式に変換され、CURLOPT_POSTFIELDSにセットされます。CURLOPT_RETURNTRANSFERをtrueにすることで、サーバーからのレスポンスを直接出力せず、関数の戻り値として文字列で取得できるようになります。

セキュリティを確保するため、CURLOPT_SSL_VERIFYPEERとCURLOPT_SSL_VERIFYHOSTを有効に設定し、SSL/TLS証明書の検証を行うようにしています。これは、通信相手が信頼できるサーバーであることを確認するために本番環境では非常に重要です。

CURLPROTO_SMBSはSMB/CIFSプロトコルを許可するための整数定数であり、プロトコルビットマスクを設定する際の一例としてコード中にコメントアウトで示されていますが、このHTTPS POSTリクエストの処理には直接関係ありません。

オプション設定後、curl_exec()でリクエストを実行し、レスポンスを取得します。エラーが発生した場合はcurl_errno()とcurl_error()で詳細を確認し、適切にエラー処理を行います。最後にcurl_close()でcURLセッションを閉じます。提供された使用例では、テスト用のエンドポイントにデータを送信し、その結果を表示しています。

Copy
1<?php
2
3/**
4 * cURL を使用して SMTP 経由でメールを送信します。
5 *
6 * この関数は、指定されたプロトコル定数 CURLPROTO_SMBS を含めて、
7 * cURL のプロトコル許可リストを設定する例を示します。
8 * CURLPROTO_SMBS は SMB プロトコルに関連し、直接 SMTP 通信には使用されません。
9 * 実際のプロトコルは CURLOPT_URL で指定されたスキーム (smtp:// または smtps://) によって決定されます。
10 *
11 * @param string      $smtpHost   SMTPサーバーのホスト名 (例: "smtp.example.com")
12 * @param int         $smtpPort   SMTPサーバーのポート番号 (例: 587 for STARTTLS, 465 for SMTPS)
13 * @param string      $fromEmail  送信元メールアドレス
14 * @param string      $toEmail    宛先メールアドレス
15 * @param string      $subject    メールの件名
16 * @param string      $body       メールの本文
17 * @param string|null $username   SMTP認証ユーザー名 (オプション)
18 * @param string|null $password   SMTP認証パスワード (オプション)
19 * @param bool        $useSsl     SMTPS (Port 465) または STARTTLS (Port 587) を使用するかどうか
20 * @return bool メール送信が成功した場合は true、それ以外は false
21 */
22function sendEmailViaCurlSmtp(
23    string $smtpHost,
24    int $smtpPort,
25    string $fromEmail,
26    string $toEmail,
27    string $subject,
28    string $body,
29    ?string $username = null,
30    ?string $password = null,
31    bool $useSsl = true
32): bool {
33    $ch = curl_init();
34
35    if ($ch === false) {
36        error_log('cURL の初期化に失敗しました。');
37        return false;
38    }
39
40    // RFC 822 形式のメール本文を構築
41    $emailContent = "From: <" . $fromEmail . ">\r\n"
42                  . "To: <" . $toEmail . ">\r\n"
43                  . "Subject: " . $subject . "\r\n"
44                  . "Content-Type: text/plain; charset=UTF-8\r\n"
45                  . "\r\n"
46                  . $body;
47
48    // メモリ上でストリームを作成し、メール本文を書き込む
49    $uploadHandle = fopen('php://temp', 'r+');
50    if ($uploadHandle === false) {
51        error_log('メール本文のストリーム作成に失敗しました。');
52        curl_close($ch);
53        return false;
54    }
55    fwrite($uploadHandle, $emailContent);
56    rewind($uploadHandle); // ポインタを先頭に戻す
57
58    // cURL オプションの設定
59    // curl_setopt($ch, CURLOPT_VERBOSE, true); // デバッグ用に詳細な出力を有効にする場合はコメントを解除
60
61    // SMTPサーバーのURLを設定
62    $scheme = $useSsl ? 'smtps://' : 'smtp://';
63    curl_setopt($ch, CURLOPT_URL, $scheme . $smtpHost . ':' . $smtpPort);
64
65    // 送信元と宛先のアドレスを設定
66    curl_setopt($ch, CURLOPT_MAIL_FROM, '<' . $fromEmail . '>');
67    curl_setopt($ch, CURLOPT_MAIL_RCPT, ['<' . $toEmail . '>']);
68
69    // SMTP認証情報の設定
70    if ($username !== null && $password !== null) {
71        curl_setopt($ch, CURLOPT_USERNAME, $username);
72        curl_setopt($ch, CURLOPT_PASSWORD, $password);
73        curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_PLAIN); // PLAIN認証を試行
74    }
75
76    // メールデータをアップロードモードで送信
77    curl_setopt($ch, CURLOPT_UPLOAD, true);
78    curl_setopt($ch, CURLOPT_READDATA, $uploadHandle);
79    curl_setopt($ch, CURLOPT_INFILESIZE, strlen($emailContent));
80
81    // プロトコル許可リストの設定
82    // CURLPROTO_SMBS は SMB プロトコルに関連し、SMTP 通信には直接使用されません。
83    // リファレンス情報に沿って定数の使用例として、他のプロトコルと共に許可リストに含めます。
84    // 実際のプロトコルは CURLOPT_URL で指定されたスキームによって選択されます。
85    curl_setopt($ch, CURLOPT_PROTOCOLS, CURLPROTO_SMBS | CURLPROTO_SMTP | CURLPROTO_SMTPS);
86
87    // SSL/TLS 設定
88    if ($useSsl) {
89        curl_setopt($ch, CURLOPT_USE_SSL, CURLUSESSL_ALL); // STARTTLS を試行
90        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);    // サーバー証明書の検証を有効化
91        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);       // ホスト名の検証を有効化
92        // curl_setopt($ch, CURLOPT_CAINFO, '/path/to/cacert.pem'); // 必要に応じてCA証明書パスを指定
93    } else {
94        curl_setopt($ch, CURLOPT_USE_SSL, CURLUSESSL_NONE);
95    }
96
97    // cURL 実行
98    $response = curl_exec($ch);
99    $success = false;
100
101    if ($response === false) {
102        error_log('cURL エラー: ' . curl_error($ch));
103    } else {
104        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
105        // SMTP の成功応答は通常 2xx (例: 250 OK)
106        if ($httpCode >= 200 && $httpCode < 400) {
107            $success = true;
108        } else {
109            error_log('SMTP サーバーからの応答エラー (' . $httpCode . '): ' . curl_error($ch));
110        }
111    }
112
113    // リソースの解放
114    curl_close($ch);
115    fclose($uploadHandle);
116
117    return $success;
118}
119
120// --- 使用例 (コメントアウトされており、実際の実行には有効なSMTPサーバー設定が必要です) ---
121/*
122$smtpHost = 'your.smtp.host'; // 例: 'smtp.gmail.com'
123$smtpPort = 587;              // 例: 587 (STARTTLS), 465 (SMTPS)
124$fromEmail = 'your_email@example.com';
125$toEmail = 'recipient@example.com';
126$subject = 'PHP cURL SMTP テスト';
127$body = 'これは PHP と cURL を使って送信されたテストメールです。';
128$username = 'your_smtp_username';
129$password = 'your_smtp_password';
130
131if (sendEmailViaCurlSmtp(
132    $smtpHost,
133    $smtpPort,
134    $fromEmail,
135    $toEmail,
136    $subject,
137    $body,
138    $username,
139    $password,
140    true // SSL/TLS を使用する場合 true
141)) {
142    echo "メールは正常に送信されました。\n";
143} else {
144    echo "メールの送信に失敗しました。エラーログを確認してください。\n";
145}
146*/

このPHPコードは、cURLライブラリを使用してSMTPプロトコル経由でメールを送信する関数sendEmailViaCurlSmtpのサンプルです。CURLPROTO_SMBS定数は、cURLが通信に許可するプロトコル群を指定するCURLOPT_PROTOCOLSオプションで使用されます。この定数自体はSMB（Server Message Block）プロトコルに関連しており、SMTP通信に直接は使用されませんが、cURLのプロトコル許可リストを設定する際の定数使用例として、他のプロトコルと共に含められています。

sendEmailViaCurlSmtp関数は、SMTPサーバーのホスト名、ポート番号、送信元・宛先メールアドレス、件名、本文といった情報を引数として受け取ります。関数内では、cURLを初期化し、CURLOPT_URLでSMTPサーバーのアドレスを指定します。送信元と宛先のアドレスはCURLOPT_MAIL_FROMとCURLOPT_MAIL_RCPTで設定され、CURLOPT_USERNAMEとCURLOPT_PASSWORDによりSMTP認証も行えます。メール本文はメモリ上に一時的に保存され、CURLOPT_UPLOADオプションを通じてcURLで送信されます。CURLOPT_USE_SSLなどを用いてSSL/TLSによるセキュアな通信も可能です。メール送信が成功した場合はtrue、失敗した場合はfalseを戻り値として返します。