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

Copy
1<?php
2
3/**
4 * 指定されたURLにPOSTリクエストを送信し、そのレスポンスを返します。
5 *
6 * @param string $url リクエストを送信するターゲットURL。
7 * @param array $data POST送信するデータ (キーと値の配列)。
8 * @return string|false 成功した場合はレスポンスボディ、失敗した場合は false。
9 */
10function sendCurlPostRequest(string $url, array $data)
11{
12    // cURLセッションを初期化
13    $ch = curl_init();
14
15    // cURLオプションを設定
16    curl_setopt_array($ch, [
17        CURLOPT_URL            => $url,                // リクエストを送信するURL
18        CURLOPT_POST           => true,                // POSTリクエストであることを示す
19        CURLOPT_POSTFIELDS     => http_build_query($data), // POSTするデータ（URLエンコード）
20        CURLOPT_RETURNTRANSFER => true,                // サーバーからの結果を文字列で返す
21        CURLOPT_HEADER         => false,               // レスポンスヘッダを含めない
22        CURLOPT_FAILONERROR    => true,                // HTTPステータスコードが400以上の場合にFALSEを返す
23        CURLOPT_TIMEOUT        => 30,                  // タイムアウト秒数
24    ]);
25
26    // cURLセッションを実行し、レスポンスを取得
27    $response = curl_exec($ch);
28
29    // エラーチェック
30    if (curl_errno($ch)) {
31        // エラーが発生した場合
32        $error_msg = curl_error($ch);
33        error_log("cURL POST request failed: " . $error_msg); // エラーログに出力
34        $response = false;
35    }
36
37    // cURLセッションを閉じる
38    curl_close($ch);
39
40    return $response;
41}
42
43// --- サンプルコードの利用例 ---
44
45// 仮のAPIエンドポイント（実際には存在するURLを指定してください）
46// 例: 'https://example.com/api/submit-form'
47$targetUrl = 'http://localhost:8000/post_receiver.php'; // 開発環境などでのテスト用URL
48
49// POSTで送信するデータ
50$postData = [
51    'name'  => 'PHP User',
52    'email' => 'php_user@example.com',
53    'message' => 'Hello from PHP cURL!',
54];
55
56echo "Sending POST request to: " . $targetUrl . "\n";
57echo "Data to send: " . json_encode($postData) . "\n\n";
58
59// POSTリクエストを送信
60$apiResponse = sendCurlPostRequest($targetUrl, $postData);
61
62if ($apiResponse !== false) {
63    echo "--- API Response ---\n";
64    echo $apiResponse . "\n";
65} else {
66    echo "Failed to get API response.\n";
67}
68
69/*
70// [補足] 開発環境で上記のコードをテストするための簡単なPHPファイル (post_receiver.php) の例
71// このファイルを上記の $targetUrl で指定した場所に配置し、PHPのウェブサーバーで実行すると、
72// このサンプルコードからのPOSTリクエストを受け取ることができます。
73//
74// post_receiver.php の内容:
75// ----------------------------------------------------
76// <?php
77// header('Content-Type: application/json');
78//
79// if ($_SERVER['REQUEST_METHOD'] === 'POST') {
80//     $data = $_POST; // POSTデータを受け取る
81//     echo json_encode([
82//         'status'  => 'success',
83//         'message' => 'Data received successfully!',
84//         'received_data' => $data
85//     ]);
86// } else {
87//     echo json_encode([
88//         'status'  => 'error',
89//         'message' => 'Only POST requests are allowed.'
90//     ]);
91// }
92// ?>
93// ----------------------------------------------------
94//
95// 実行方法例 (post_receiver.php を配置したディレクトリで):
96// php -S localhost:8000
97//
98// その後、上記のサンプルコードを実行すると、`post_receiver.php` からのレスポンスが表示されます。
99*/

このPHPサンプルコードは、cURLライブラリを利用して、指定されたURLへPOSTリクエストを送信する方法を示すものです。sendCurlPostRequest関数は、リクエストを送信するターゲットURL（$url）と、POST送信するデータ（$data）を配列形式で引数として受け取ります。成功した場合はサーバーからのレスポンスボディを文字列として返し、失敗した場合はfalseを返します。

このコードの中心となるのがCURLOPT_POSTFIELDSオプションです。このオプションは、POSTリクエストでサーバーに送りたいデータを設定するために使用されます。サンプルでは、POSTするデータをPHPの連想配列で用意し、http_build_query()関数を使って「キー=値&キー=値」のようなURLエンコードされた文字列に変換してからCURLOPT_POSTFIELDSに設定しています。これにより、Webフォームからデータを送信するのと同じ形式で、サーバー側が受け取りやすい形でデータを渡すことができます。

関数内では、まずcurl_init()でcURLセッションを初期化し、curl_setopt_array()を使ってCURLOPT_URL（送信先URL）、CURLOPT_POST（POSTリクエストの指定）、CURLOPT_RETURNTRANSFER（レスポンスを文字列として取得）など複数のオプションを一括で設定しています。その後、curl_exec()でリクエストを実行し、サーバーからの応答を取得します。通信エラーが発生した場合はcurl_errno()で検知し、最終的にcurl_close()でセッションを閉じます。提供された利用例では、仮のAPIエンドポイントに対し、特定のデータをPOST送信し、その結果を表示しています。

Copy
1<?php
2
3/**
4 * HTTP POST リクエストを送信し、そのレスポンスを返します。
5 *
6 * この関数はcURLライブラリを使用して指定されたURLにPOSTリクエストを送信します。
7 * 送信するデータは連想配列として渡すことができます。
8 *
9 * @param string $url POSTリクエストを送信するターゲットURL（HTTPSを推奨）。
10 * @param array $data 送信するPOSTデータ（キーと値の連想配列）。
11 * @return string|false リクエストが成功した場合はレスポンス本文、失敗した場合はfalse。
12 */
13function sendPostRequest(string $url, array $data)
14{
15    // 1. cURLセッションを初期化
16    $ch = curl_init();
17
18    // 2. cURLオプションを設定
19    curl_setopt_array($ch, [
20        CURLOPT_URL => $url,                            // リクエストを送信するURLを設定
21        CURLOPT_POST => true,                           // HTTP POST リクエストを有効にする
22        CURLOPT_POSTFIELDS => http_build_query($data),  // 送信するPOSTデータをURLエンコード形式で設定
23
24        // レスポンスの挙動設定
25        CURLOPT_RETURNTRANSFER => true,                 // レスポンスを文字列として関数から返す（trueの場合）
26        CURLOPT_HEADER => false,                        // レスポンスヘッダーを含めない
27
28        // セキュリティオプション
29        // HTTPS Strict Transport Security (HSTS) を有効にするオプション（PHP 8以降で利用可能）。
30        // HTTPS接続のセキュリティを強化するために使用され、cURLがサーバーからHSTSポリシーを
31        // 受信した際の動作を制御します。
32        CURLOPT_HSTS => true,
33
34        // HTTPS通信の場合、SSL証明書の検証を有効にすることが推奨されます。
35        // これにより、通信相手が信頼できるサーバーであることを確認し、中間者攻撃を防ぎます。
36        // 自己署名証明書など特殊な環境では一時的に無効にする場合がありますが、本番環境では必ず有効にしてください。
37        CURLOPT_SSL_VERIFYPEER => true,
38        CURLOPT_SSL_VERIFYHOST => 2, // ホスト名の検証を厳密に行う
39    ]);
40
41    // 3. リクエストを実行し、レスポンスを取得
42    $response = curl_exec($ch);
43
44    // 4. エラーチェック
45    if (curl_errno($ch)) {
46        // エラーが発生した場合、エラーメッセージを出力
47        echo 'cURLエラー: ' . curl_error($ch) . "\n";
48        $response = false; // 失敗としてfalseを返す
49    }
50
51    // 5. cURLセッションを閉じる
52    curl_close($ch);
53
54    return $response; // レスポンス本文、または失敗の場合はfalseを返す
55}
56
57// --- サンプル使用例 ---
58// テスト用の公開APIエンドポイント（jsonplaceholder.typicode.comはダミーデータを返すサービス）
59$targetUrl = 'https://jsonplaceholder.typicode.com/posts';
60
61// 送信するPOSTデータ
62$postData = [
63    'title' => 'PHP cURLのサンプル投稿',
64    'body' => 'これはPHPのcURLとCURLOPT_POSTを使ったデータ送信の例です。',
65    'userId' => 101,
66];
67
68echo "ターゲットURL: " . $targetUrl . "\n";
69echo "送信データ:\n";
70print_r($postData);
71echo "\n";
72
73// sendPostRequest関数を呼び出してPOSTリクエストを送信
74$result = sendPostRequest($targetUrl, $postData);
75
76// 結果の表示
77if ($result !== false) {
78    echo "POSTリクエスト成功！\n";
79    echo "レスポンス:\n" . $result . "\n";
80} else {
81    echo "POSTリクエスト失敗。\n";
82}
83
84?>

このサンプルコードは、PHPのcURLライブラリを使用して、指定されたURLにHTTP POSTリクエストを送信し、その結果を取得する方法を解説しています。

sendPostRequest関数は、引数としてPOSTリクエストのターゲットとなる$url（HTTPSが推奨されます）と、送信したいデータを連想配列形式で指定する$dataを受け取ります。リクエストが成功した場合はサーバーからのレスポンス本文を文字列として返し、失敗した場合はfalseを返します。

cURLオプションの設定では、CURLOPT_POSTをtrueにすることでPOSTリクエストを有効にし、CURLOPT_POSTFIELDSで送信するデータをURLエンコード形式で指定しています。CURLOPT_RETURNTRANSFERは、サーバーからのレスポンスを直接出力せずに、関数の戻り値として取得するためにtrueに設定されています。

特に注目すべきは、PHP 8で導入されたCURLOPT_HSTSオプションです。これをtrueに設定することで、HTTPS Strict Transport Security（HSTS）の適用を有効にします。これにより、cURLがHSTSポリシーを受信した際、将来のHTTP接続試行を自動的にHTTPSに切り替えるようになり、HTTPS接続のセキュリティを強化します。また、CURLOPT_SSL_VERIFYPEERとCURLOPT_SSL_VERIFYHOSTは、HTTPS通信の信頼性を確保し、中間者攻撃を防ぐために非常に重要なセキュリティ設定です。

このサンプルコードは、単にPOSTデータを送信するだけでなく、現代のウェブアプリケーションにおけるセキュリティ設定も考慮した、cURLの基本的な使用方法を学ぶのに役立ちます。