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

Copy
1<?php
2
3/**
4 * CURLSSLOPT_NATIVE_CA 定数を使用してcURL HTTPSリクエストを実行する例。
5 *
6 * この関数は、cURLリクエストのSSLオプションとしてCURLSSLOPT_NATIVE_CA定数を設定する方法を示します。
7 * CURLSSLOPT_NATIVE_CA は、Windows環境において、cURLがシステムに組み込まれた
8 * 信頼済みルート証明機関ストアを使用するように指示するためのものです。
9 * これはphp.iniで設定するものではなく、cURL関数の実行時に動的に設定するオプションです。
10 *
11 * @param string $url リクエストを送信するHTTPS URL。
12 * @return string|false リクエストの応答ボディ、またはエラーが発生した場合はfalse。
13 */
14function fetchContentWithNativeCA(string $url): 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
32    // ホスト名の検証を有効にします。
33    // アクセス先のホスト名が証明書と一致するかを確認します。
34    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
35
36    // CURLOPT_SSL_OPTIONS を設定し、CURLSSLOPT_NATIVE_CA を指定します。
37    // Windows環境では、この設定によりOSの証明書ストアが信頼されたCAとして使用されます。
38    // 通常、CURLOPT_CAINFOでCA証明書ファイルを指定する代わりに利用できます。
39    curl_setopt($ch, CURLOPT_SSL_OPTIONS, CURLSSLOPT_NATIVE_CA);
40
41    // リクエストを実行します。
42    $response = curl_exec($ch);
43
44    // エラーが発生した場合は、エラーメッセージを記録します。
45    if (curl_errno($ch)) {
46        $error_msg = curl_error($ch);
47        error_log("cURLエラーが発生しました: {$error_msg}");
48        curl_close($ch);
49        return false;
50    }
51
52    // cURLセッションを閉じます。
53    curl_close($ch);
54
55    return $response;
56}
57
58// --- サンプル使用例 ---
59// CURLSSLOPT_NATIVE_CA は主にWindows環境で効果を発揮します。
60// 他のOS（Linuxなど）では、通常システムが管理するCA証明書が自動的に利用されるため、
61// このオプションを設定しても効果がないか、あるいは予期しない動作をする場合があります。
62
63// テスト用のHTTPS URL (実際にアクセス可能なサイトを指定してください)
64$targetUrl = 'https://httpbin.org/get';
65
66// CURLSSLOPT_NATIVE_CA 定数の値を確認 (この定数は整数値です)
67echo "CURLSSLOPT_NATIVE_CA 定数の値: " . CURLSSLOPT_NATIVE_CA . "\n\n";
68
69echo "URL '{$targetUrl}' へのリクエストを試行します。\n";
70
71$content = fetchContentWithNativeCA($targetUrl);
72
73if ($content !== false) {
74    echo "リクエスト成功！\n";
75    echo "取得したコンテンツの最初の500文字:\n";
76    echo substr($content, 0, 500) . "...\n";
77} else {
78    echo "リクエスト失敗。\n";
79    echo "エラーログを確認してください（CLI実行時は標準エラー出力）。\n";
80}

CURLSSLOPT_NATIVE_CAは、PHPのcURL拡張機能で利用される定数です。この定数は整数値を持ち、HTTPS通信時にSSL/TLS証明書の検証方法を制御するために使用されます。特にWindows環境において効果を発揮し、cURLがオペレーティングシステムに組み込まれた信頼済みルート証明機関ストアを利用して、サーバー証明書の正当性を検証するように指示します。これにより、別途CA証明書ファイルを指定する手間を省き、システムが信頼する証明書チェーンを簡単に利用できるようになります。

サンプルコードでは、curl_initでcURLセッションを初期化後、curl_setopt関数を用いてCURLOPT_SSL_OPTIONSオプションにCURLSSLOPT_NATIVE_CA定数を設定し、セキュアなHTTPSリクエストを実行しています。また、CURLOPT_SSL_VERIFYPEERとCURLOPT_SSL_VERIFYHOSTをtrueに設定することで、通信相手の正当性を厳密に確認しています。

この定数は引数を持ちません。curl_setopt関数に渡すことで、cURLの挙動を変更します。戻り値は定数そのものが持つ整数値であり、設定が成功したかどうかはcurl_setopt関数の戻り値で確認します。なお、この設定はphp.iniファイルで変更するものではなく、プログラムの実行時に動的に指定するオプションです。Windows以外のOSでは、通常システムがCA証明書を管理しているため、このオプションを設定しても効果がない場合があります。