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

Copy
1<?php
2
3/**
4 * SSLクライアント証明書を使用してHTTPSリクエストを送信するサンプル関数。
5 *
6 * この関数はCURLOPT_SSLKEYオプションの使用方法を示します。
7 * 実際に動作させるには、有効なクライアント証明書ファイルと秘密鍵ファイルが必要です。
8 *
9 * @param string $url       リクエストを送信するHTTPS URL。
10 * @param string $certPath  クライアント証明書ファイルへのパス (.crt, .pemなど)。
11 * @param string $keyPath   クライアント秘密鍵ファイルへのパス (.key, .pemなど)。
12 * @return string|false     リクエストのレスポンス文字列、またはエラー時にfalse。
13 */
14function sendHttpsRequestWithClientCert(string $url, string $certPath, string $keyPath): string|false
15{
16    // cURLセッションを初期化
17    $ch = curl_init();
18
19    if ($ch === false) {
20        error_log('cURL初期化に失敗しました。');
21        return false;
22    }
23
24    // 基本的なcURLオプションを設定
25    curl_setopt($ch, CURLOPT_URL, $url);                 // リクエスト先のURL
26    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);      // レスポンスを文字列として取得する
27
28    // SSL/TLS関連のオプションを設定
29    // サーバー証明書の検証を有効にする（本番環境では強く推奨）
30    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
31    // ホスト名の検証を有効にする（2は共通名とSANを検証。本番環境では強く推奨）
32    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
33
34    // クライアント証明書ファイルへのパスを設定
35    // CURLOPT_SSLCERT はクライアント証明書ファイルのパスを指定します。
36    curl_setopt($ch, CURLOPT_SSLCERT, $certPath);
37
38    // クライアント秘密鍵ファイルへのパスを設定
39    // CURLOPT_SSLKEY はクライアント証明書の秘密鍵ファイルのパスを指定します。
40    // この定数を使用することで、PHPは指定されたパスから秘密鍵を読み込み、SSL/TLSハンドシェイクに使用します。
41    curl_setopt($ch, CURLOPT_SSLKEY, $keyPath);
42
43    // cURLリクエストを実行
44    $response = curl_exec($ch);
45
46    // エラーチェック
47    if (curl_errno($ch)) {
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// 以下のパスとURLは仮のものです。実際に動作させるには、ご自身の環境に合わせて置き換えてください。
62// クライアント証明書を要求するHTTPSエンドポイント
63$targetUrl = 'https://example.com/';
64// クライアント証明書ファイルへの絶対パス
65$clientCertPath = '/path/to/your/client_certificate.crt';
66// クライアント秘密鍵ファイルへの絶対パス
67$clientKeyPath = '/path/to/your/client_private_key.key';
68
69echo "CURLOPT_SSLKEY を使用したHTTPSリクエストを送信します。\n";
70echo "ターゲットURL: " . $targetUrl . "\n";
71echo "証明書パス: " . $clientCertPath . "\n";
72echo "秘密鍵パス: " . $clientKeyPath . "\n\n";
73
74// 関数を呼び出してリクエストを送信
75$result = sendHttpsRequestWithClientCert($targetUrl, $clientCertPath, $clientKeyPath);
76
77if ($result !== false) {
78    echo "リクエストが成功しました。\n";
79    // レスポンスが長い場合があるので、必要に応じてコメントを解除して表示してください。
80    // echo "レスポンス:\n" . $result . "\n";
81} else {
82    echo "リクエストが失敗しました。ログを確認してください。\n";
83    echo "ヒント: 証明書や秘密鍵のファイルパス、またはパーミッションを確認してください。\n";
84}

PHP 8におけるこのサンプルコードは、SSLクライアント証明書を用いてHTTPSリクエストを送信する方法を示しています。ウェブアプリケーションが特定のサーバーに対して安全な認証付き通信を行う際に利用される、基本的な処理です。

核となるのはCURLOPT_SSLKEY定数で、これはcurl_setopt関数で指定するcURLオプションの一つです。この定数を使用すると、クライアント証明書に対応する秘密鍵ファイルへのパスをPHPに伝えることができます。これにより、cURLはSSL/TLSハンドシェイク時に指定された秘密鍵を用いて自身を認証し、安全な通信路を確立します。同様に、CURLOPT_SSLCERTオプションではクライアント証明書ファイル自体のパスを指定します。これら二つのオプションは、クライアント認証型SSL/TLS通信においてペアで利用されます。

提供されたsendHttpsRequestWithClientCert関数は、指定された$urlに対し、$certPathで示されるクライアント証明書と$keyPathで示される秘密鍵を使用してHTTPSリクエストを送信します。引数$urlはリクエスト先のHTTPSアドレス、$certPathは証明書ファイルのパス、$keyPathは秘密鍵ファイルのパスをそれぞれ文字列で受け取ります。処理が成功した場合はレスポンス文字列を、失敗した場合はfalseを返します。実際にこのコードを動作させるには、有効なクライアント証明書と秘密鍵ファイルを用意し、パスを適切に設定する必要があります。エラー発生時にはログに出力されるため、問題解決の手がかりとなります。