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

Copy
1<?php
2
3/**
4 * プロキシ経由で指定されたURLにアクセスし、プロキシのSSL証明書の発行元CA証明書を検証するサンプル関数です。
5 *
6 * この関数は、`CURLOPT_PROXY_ISSUERCERT` 定数を使用して、プロキシへのSSL接続の信頼性を高める方法を示します。
7 * プロキシのSSL証明書が特定の信頼できるCAによって署名されていることを確認するために利用されます。
8 *
9 * @param string $url アクセスするターゲットURL。
10 * @param string $proxyUrl 使用するプロキシサーバーのURL (例: 'http://localhost:8888')。
11 * @param string $proxyIssuerCertPath プロキシのSSL証明書を発行したCA証明書ファイルへのパス (例: '/path/to/proxy_issuer_cert.pem')。
12 * @return string|false リクエストが成功した場合はレスポンス文字列、失敗した場合は false を返します。
13 */
14function fetchDataViaProxyWithIssuerCert(
15    string $url,
16    string $proxyUrl,
17    string $proxyIssuerCertPath
18): string|false {
19    // cURLセッションを初期化します。
20    $ch = curl_init();
21
22    if ($ch === false) {
23        // 初期化に失敗した場合、エラーログに出力し false を返します。
24        error_log("CURLセッションの初期化に失敗しました。");
25        return false;
26    }
27
28    // ターゲットURLを設定します。
29    curl_setopt($ch, CURLOPT_URL, $url);
30
31    // 使用するプロキシサーバーのURLを設定します。
32    curl_setopt($ch, CURLOPT_PROXY, $proxyUrl);
33
34    // プロキシへのSSL接続の際に、その証明書が信頼できるか検証を有効にします。
35    curl_setopt($ch, CURLOPT_PROXY_SSL_VERIFYPEER, true);
36    // プロキシのSSL証明書のホスト名が正しいか検証します。
37    curl_setopt($ch, CURLOPT_PROXY_SSL_VERIFYHOST, 2);
38
39    // プロキシのSSL証明書を発行したCA証明書ファイルへのパスを指定します。
40    // `CURLOPT_PROXY_ISSUERCERT` は、プロキシ証明書が特定のCAによって発行されたものであることを
41    // 検証するために使用されます。このファイルはPEM形式である必要があります。
42    curl_setopt($ch, CURLOPT_PROXY_ISSUERCERT, $proxyIssuerCertPath);
43
44    // 実行結果を文字列として返すように設定します。
45    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
46
47    // リクエストを実行します。
48    $response = curl_exec($ch);
49
50    // エラーが発生したか確認します。
51    if (curl_errno($ch)) {
52        // エラーが発生した場合、エラーメッセージとエラーコードをログに出力します。
53        error_log("CURLエラー (" . curl_errno($ch) . "): " . curl_error($ch));
54        $response = false;
55    }
56
57    // cURLセッションを閉じ、リソースを解放します。
58    curl_close($ch);
59
60    return $response;
61}
62
63// --- サンプル使用例 ---
64// 以下の値は、ご自身の環境に合わせて変更してください。
65// 実際にこのコードを動作させるには、有効なプロキシサーバー、プロキシのSSL証明書、
66// およびその発行元CA証明書ファイル（.pem形式）が必要となります。
67//
68// $targetUrl = 'https://www.example.com';
69// $proxyUrl = 'http://your-proxy-host:8080'; // 例: 'http://localhost:8888' など
70// $proxyIssuerCertFile = __DIR__ . '/path/to/your_proxy_issuer_cert.pem'; // 実際のファイルパスに置き換える
71//
72// $result = fetchDataViaProxyWithIssuerCert($targetUrl, $proxyUrl, $proxyIssuerCertFile);
73//
74// if ($result === false) {
75//     // リクエストが失敗した場合の処理をここに記述します。
76//     // 詳細なエラーはPHPのエラーログを確認してください。
77// } else {
78//     // リクエストが成功した場合の処理をここに記述します。
79//     // $result にはターゲットURLからのレスポンスが含まれます。
80//     // 例: var_dump(substr($result, 0, 500)); // レスポンスの一部を表示
81// }
82
83?>

このサンプルコードは、PHPのcURLライブラリを用いて、プロキシサーバー経由で外部のURLに安全にアクセスする方法を示しています。特に、CURLOPT_PROXY_ISSUERCERT定数を使用することで、プロキシサーバーとのSSL/TLS通信のセキュリティを強化する目的があります。この定数は、プロキシのSSL証明書が、事前に指定された特定のCA（認証局）によって発行されたものであることを検証するために利用されます。これにより、信頼できないプロキシからの接続や、中間者攻撃のリスクを効果的に軽減し、通信の信頼性を高めることができます。

サンプル関数fetchDataViaProxyWithIssuerCertは、アクセス対象の$url、利用する$proxyUrl、そしてプロキシのSSL証明書を発行したCA証明書へのファイルパスである$proxyIssuerCertPathの3つの引数を取ります。この関数は、cURLセッションを通じて指定されたURLにアクセスを試み、成功した場合はターゲットURLからのレスポンス内容を文字列として返します。もしcURLの初期化や実行中に何らかのエラーが発生した場合は、falseを戻り値として返します。この設定は、プロキシ環境下でのセキュアな通信を確立し、システム間のデータ交換における信頼性を確保する上で重要な役割を果たします。