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

Copy
1<?php
2
3/**
4 * cURLがSSL/TLSサポート付きでコンパイルされているかを確認する関数。
5 * CURL_VERSION_SSL定数を使用して、curl_version()関数の結果から判断します。
6 *
7 * @return void
8 */
9function checkCurlSslSupport(): void
10{
11    // cURLのバージョン情報と機能の詳細を取得します。
12    // この情報には、cURLがサポートする機能のビットマスクが含まれています。
13    $curlVersion = curl_version();
14
15    // cURLの機能フラグを取得します。
16    // 'features'キーが存在しない可能性（非常に古いPHPバージョンなど）に備え、
17    // null合体演算子を使ってデフォルト値0を設定します。
18    $features = $curlVersion['features'] ?? 0;
19
20    // CURL_VERSION_SSL定数と取得した機能フラグをビットAND演算子で比較し、
21    // cURLがSSL/TLSサポート付きでコンパイルされているかを確認します。
22    // ビットマスクとして定数が使用されるため、比較結果が定数自身と一致するかどうかで判断します。
23    if (($features & CURL_VERSION_SSL) === CURL_VERSION_SSL) {
24        echo "cURLはSSL/TLSサポート付きでコンパイルされています。\n";
25        // 使用しているSSL/TLSライブラリのバージョンも表示します。
26        // 'ssl_version'キーも存在しない場合に備え、'不明'を設定します。
27        echo "使用しているSSL/TLSライブラリ: " . ($curlVersion['ssl_version'] ?? '不明') . "\n";
28    } else {
29        echo "cURLはSSL/TLSサポートなしでコンパイルされています。\n";
30    }
31}
32
33// 関数を実行し、結果を出力します。
34checkCurlSslSupport();
35

このPHPサンプルコードは、cURL拡張機能がSSL/TLS（セキュアな通信）をサポートするようにコンパイルされているかどうかを確認する方法を示しています。CURL_VERSION_SSLは、cURLの特定の機能の有無を示す整数定数です。引数はなく、戻り値として整数値を返します。

コードではまずcheckCurlSslSupport関数が定義され、その中でcurl_version()関数を呼び出しています。このcurl_version()関数は、cURLのバージョン情報、サポートするプロトコル、コンパイル時に有効になっている機能のビットマスクなどを含む詳細な情報を連想配列として返します。

次に、取得した情報のうちfeaturesキーに格納されている機能フラグを取り出し、CURL_VERSION_SSL定数とビットAND演算子（&）を使って比較しています。このビット演算による比較は、cURLの機能フラグにCURL_VERSION_SSLが示すビットが含まれているかどうか、つまりcURLがSSL/TLSサポートを有効にしてコンパイルされているかを効率的に判断するために行われます。

最終的に、比較結果に基づいてcURLがSSL/TLSサポート付きでコンパイルされているかどうか、そして使用しているSSL/TLSライブラリのバージョン（利用可能な場合）がコンソールに出力されます。これにより、システムが安全なHTTPS通信などを確立できる状態にあるかを簡単に確認することが可能です。