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

Copy
1<?php
2
3/**
4 * CURLINFO_SSL_ENGINES 定数を使用して、利用可能なSSLエンジンの情報を表示します。
5 *
6 * この関数は、システムエンジニアを目指す初心者向けに、PHPのcURL拡張機能の
7 * 基本的な使い方と、特定のcURL情報定数 (`CURLINFO_SSL_ENGINES`) の利用方法を示します。
8 *
9 * キーワード: phpinfo, curl
10 * 注: このコードを実行する前に、お使いの環境でcURL拡張機能が有効になっていることを
11 * 確認してください。PHPの設定情報（`phpinfo()` 関数で確認可能）で、
12 * 'curl'セクションが存在していれば有効です。
13 */
14function displayCurlSslEnginesInfo(): void
15{
16    // cURL拡張機能がPHPにロードされているかを確認
17    if (!extension_loaded('curl')) {
18        echo "エラー: cURL拡張機能が有効になっていません。\n";
19        echo "PHPの構成（phpinfo()で確認）を確認し、cURLが有効になっていることを確認してください。\n";
20        return;
21    }
22
23    // cURLセッションを初期化
24    // cURLハンドルの取得に失敗した場合はエラーメッセージを表示
25    $ch = curl_init();
26    if (false === $ch) {
27        echo "エラー: cURLセッションの初期化に失敗しました。\n";
28        return;
29    }
30
31    // SSLエンジンの情報を取得するため、HTTPSプロトコルを使用するURLを設定します。
32    // 実際に完全なリクエストを行う必要はありませんが、cURLセッションが
33    // 動作可能な状態である必要があります。
34    curl_setopt($ch, CURLOPT_URL, 'https://www.example.com');
35    // レスポンスボディは不要なため、取得しない設定
36    curl_setopt($ch, CURLOPT_NOBODY, true);
37    // レスポンスヘッダーを取得する設定 (情報を取得するために最小限の通信を行う)
38    curl_setopt($ch, CURLOPT_HEADER, true);
39    // curl_exec() が文字列を返すように設定（通常のリクエストでは使用）
40    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
41
42    // cURLリクエストを実行
43    // この実行により、cURLの内部状態が更新され、正確な情報が取得できるようになります。
44    curl_exec($ch);
45
46    // CURLINFO_SSL_ENGINES 定数を使用して、利用可能なSSLエンジンの情報を取得します。
47    // この定数は curl_getinfo() 関数の引数として使用され、利用可能なSSLエンジン名の
48    // 配列（または空の配列）を返します。
49    $sslEngines = curl_getinfo($ch, CURLINFO_SSL_ENGINES);
50
51    // cURLセッションを終了し、リソースを解放
52    curl_close($ch);
53
54    echo "--- cURL SSL エンジン情報 ---\n";
55
56    // 取得したSSLエンジン情報が配列であり、空でないかを確認
57    if (is_array($sslEngines) && !empty($sslEngines)) {
58        echo "システムで利用可能なSSLエンジン:\n";
59        foreach ($sslEngines as $engine) {
60            echo "- " . htmlspecialchars($engine) . "\n";
61        }
62    } else {
63        echo "利用可能なSSLエンジン情報が見つかりませんでした。\n";
64        echo "これは、システムにOpenSSLなどのSSLライブラリがインストールされていないか、\n";
65        echo "cURLがそれらを検出できなかった場合に発生することがあります。\n";
66    }
67
68    echo "-----------------------------\n";
69}
70
71// 定義した関数を実行
72displayCurlSslEnginesInfo();

PHPのこのサンプルコードは、cURL拡張機能を利用して、システムで利用可能なSSLエンジンに関する情報を取得し表示する方法を示しています。まず、extension_loaded('curl')でcURL拡張機能が有効かを確認します。もし有効でなければ、phpinfo()でPHPの設定を確認し、cURLセクションが存在するかどうかを確認する必要があることを伝えています。

cURLセッションはcurl_init()で開始され、curl_setopt()で接続先のURLやレスポンスボディを無視するなどのオプションを設定します。curl_exec()を実行することでcURLが内部状態を更新し、その後にcurl_getinfo()関数とCURLINFO_SSL_ENGINES定数を使って、システムがサポートするSSLエンジンの情報を取得します。CURLINFO_SSL_ENGINESはcurl_getinfo()に渡すことで、利用可能なSSLエンジン名の配列を返します。この定数自体には引数や戻り値はありませんが、curl_getinfo()によって情報が引き出されます。

最後にcurl_close()でセッションを閉じ、取得したSSLエンジン情報が配列として存在すればそれを表示し、見つからなければその旨を伝えます。これにより、システムエンジニアを目指す初心者がcURL拡張機能の基本的な使い方と、セキュリティ関連情報の取得方法を理解できます。

Copy
1<?php
2
3/**
4 * 指定されたURLへのHTTPリクエストを行い、HTTPステータスコードを取得します。
5 *
6 * @param string $url リクエストを送信するURL。
7 * @return int|null HTTPステータスコード（例: 200, 404）または、
8 *                  cURLエラーが発生した場合はnullを返します。
9 */
10function getHttpStatusCode(string $url): ?int
11{
12    // cURLセッションを初期化します。
13    $ch = curl_init();
14
15    // URLを設定します。
16    curl_setopt($ch, CURLOPT_URL, $url);
17
18    // サーバーの応答を直接出力せず、文字列として取得するように設定します。
19    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
20
21    // SSL証明書の検証をスキップする設定（テスト目的や特定の環境でのみ使用し、本番環境では注意が必要です）
22    // curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
23    // curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
24
25    // cURLセッションを実行し、サーバーからの応答を取得します。
26    $response = curl_exec($ch);
27
28    // cURL実行中にエラーが発生したか確認します。
29    if (curl_errno($ch)) {
30        // エラーが発生した場合、エラーメッセージを出力し、nullを返します。
31        error_log('cURLエラー (' . curl_errno($ch) . '): ' . curl_error($ch));
32        curl_close($ch);
33        return null;
34    }
35
36    // cURLセッションからHTTPステータスコードを取得します。
37    // CURLINFO_HTTP_CODE は、直前のHTTP転送で受信したHTTPステータスコードを返します。
38    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
39
40    // cURLセッションを閉じ、リソースを解放します。
41    curl_close($ch);
42
43    return $httpCode;
44}
45
46// --- サンプル使用例 ---
47
48// 存在するURL
49$testUrlSuccess = 'https://www.google.com';
50// 存在しないURL（404 Not Foundを想定）
51$testUrlNotFound = 'https://www.google.com/nonexistent-page-12345';
52// 無効なURL（名前解決エラーなどを想定）
53$testUrlError = 'http://invalid.example.com';
54
55echo "--- HTTPステータスコード取得の例 ---" . PHP_EOL;
56
57// 成功するケースのテスト
58$statusCodeSuccess = getHttpStatusCode($testUrlSuccess);
59if ($statusCodeSuccess !== null) {
60    echo "URL: {$testUrlSuccess}" . PHP_EOL;
61    echo "HTTPステータスコード: {$statusCodeSuccess}" . PHP_EOL;
62} else {
63    echo "URL: {$testUrlSuccess} - ステータスコードの取得に失敗しました。" . PHP_EOL;
64}
65echo PHP_EOL;
66
67// 404エラーになるケースのテスト
68$statusCodeNotFound = getHttpStatusCode($testUrlNotFound);
69if ($statusCodeNotFound !== null) {
70    echo "URL: {$testUrlNotFound}" . PHP_EOL;
71    echo "HTTPステータスコード: {$statusCodeNotFound}" . PHP_EOL;
72} else {
73    echo "URL: {$testUrlNotFound} - ステータスコードの取得に失敗しました。" . PHP_EOL;
74}
75echo PHP_EOL;
76
77// cURLエラーになるケースのテスト
78$statusCodeError = getHttpStatusCode($testUrlError);
79if ($statusCodeError !== null) {
80    echo "URL: {$testUrlError}" . PHP_EOL;
81    echo "HTTPステータスコード: {$statusCodeError}" . PHP_EOL;
82} else {
83    echo "URL: {$testUrlError} - ステータスコードの取得に失敗しました。詳細についてはエラーログを確認してください。" . PHP_EOL;
84}

このPHPコードは、指定されたURLにHTTPリクエストを送信し、その応答として返されるHTTPステータスコードを正確に取得する方法を学ぶためのサンプルです。ウェブサイトの存在確認や、外部サービスの稼働状況監視など、様々な場面で利用できる基本的な技術です。

コードではまず、curl_init()関数でcURLセッションを初期化します。次に、curl_setopt()関数を使って、リクエスト先のURLを設定したり、サーバーの応答を直接出力せず文字列として取得するなどのオプションを設定します。設定が完了したら、curl_exec()関数で実際にHTTPリクエストを実行し、サーバーからの応答を受け取ります。

リクエスト実行後、取得したい情報としてcurl_getinfo()関数にCURLINFO_HTTP_CODE定数を指定することで、直前に行われたHTTP転送でサーバーから返されたHTTPステータスコード（例: 200 OK, 404 Not Foundなど）を取得できます。

getHttpStatusCode関数は、引数としてリクエストを送信するstring型のURLを受け取ります。この関数は、HTTPステータスコードが正常に取得できた場合はint型の数値（例: 200や404）を返し、cURLの実行中に何らかのエラーが発生した場合はnullを返します。エラー発生時にはエラーログに詳細が出力されるため、問題の原因特定にも役立ちます。このように、外部のWebサービスと連携するシステム開発において、HTTPステータスコードの取得は非常に重要な要素となります。