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

Copy
1<?php
2
3/**
4 * 指定されたURLに対してHTTP GETリクエストを実行し、
5 * HTTPステータスコードを取得して表示する関数。
6 *
7 * この関数は、cURLライブラリを使用してWebリソースにアクセスし、
8 * リクエストのHTTPステータスコード（例: 200 OK, 404 Not Found）を取得する方法を示します。
9 * システムエンジニアを目指す初心者にとって、Webサイトの稼働状況や
10 * APIのレスポンスを確認する基本的なスキルとなります。
11 *
12 * @param string $url リクエストを送信するターゲットURL。
13 * @return void
14 */
15function getHttpResponseCode(string $url): void
16{
17    // cURLセッションを初期化します。
18    // curl_init() は新しいcURLセッションハンドルを返します。
19    $ch = curl_init();
20
21    // cURLオプションを設定します。
22    // CURLOPT_URL: リクエストを送信するURLを設定します。
23    curl_setopt($ch, CURLOPT_URL, $url);
24
25    // CURLOPT_RETURNTRANSFER: curl_exec() が結果を文字列として返すように設定します。
26    // これを true にしない場合、curl_exec() は取得したデータを直接出力します。
27    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
28
29    // HTTPリクエストを実行します。
30    // 成功した場合は転送されたデータ、失敗した場合は false を返します。
31    $response = curl_exec($ch);
32
33    // cURLリクエストの実行中にエラーが発生したかを確認します。
34    if (curl_errno($ch)) {
35        // エラーが発生した場合、エラーメッセージを表示します。
36        echo 'cURL Error: ' . curl_error($ch) . PHP_EOL;
37    } else {
38        // リクエストが成功した場合、HTTPステータスコードを取得します。
39        // CURLINFO_RESPONSE_CODE は、直前のHTTP転送におけるHTTPステータスコードを
40        // 取得するための情報定数です。
41        $httpCode = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
42
43        echo "URL: {$url}" . PHP_EOL;
44        echo "HTTP Status Code: {$httpCode}" . PHP_EOL;
45    }
46
47    // cURLセッションを終了し、使用していたリソースを解放します。
48    curl_close($ch);
49}
50
51// サンプル使用例
52// 実際に存在するURLに対してリクエストを送信し、ステータスコードを確認します。
53getHttpResponseCode('https://www.google.com');
54echo PHP_EOL; // 見やすくするための改行
55
56// 存在しないページやエラーを返す可能性のあるURLを試すこともできます。
57getHttpResponseCode('https://httpbin.org/status/404'); // HTTP 404 Not Found を返すテストURL
58echo PHP_EOL;
59
60getHttpResponseCode('https://example.com/this-page-does-not-exist-12345'); // 存在しないURL
61echo PHP_EOL;
62
63// 無効なURLを指定した場合のcURLエラーハンドリングの例
64getHttpResponseCode('invalid-url');

このPHPコードは、指定されたURLに対してHTTPリクエストを実行し、その応答のHTTPステータスコードを取得・表示する手順を示しています。システムエンジニアを目指す方にとって、WebサイトやAPIの稼働状況をプログラムから確認する基本的な方法を学ぶ上で役立ちます。

getHttpResponseCode関数は、引数として受け取った$url（リクエストを送信するターゲットURL）に対して処理を行います。まずcurl_init()でcURLセッションを開始し、curl_setopt()でリクエスト先のURLと、取得したデータを文字列として返す設定（CURLOPT_RETURNTRANSFERをtrue）を行います。次にcurl_exec()で実際にHTTPリクエストを実行し、応答を取得します。

リクエスト中にエラーが発生した場合は、curl_errno()とcurl_error()でエラーメッセージを表示します。エラーがなければ、curl_getinfo()関数にCURLINFO_RESPONSE_CODE定数を指定することで、直前のHTTP転送で得られたHTTPステータスコード（例: "200 OK"や"404 Not Found"など）を取得し、画面に表示します。最後にcurl_close()でcURLセッションを終了し、リソースを解放します。この関数はvoid型であり、呼び出し元に特定の値を返しませんが、実行結果をコンソールに出力します。

Copy
1<?php
2
3/**
4 * CURLINFO_RTSP_SERVER_CSEQ 定数の使用例を示す関数。
5 * この定数は、RTSP (Real-Time Streaming Protocol) 通信において、
6 * サーバーから報告されたシーケンス番号を取得するために使用されます。
7 *
8 * システムエンジニアを目指す初心者の方へ:
9 * cURLは様々なプロトコルでネットワーク通信を行うためのPHP拡張です。
10 * curl_getinfo() 関数は、cURLリクエストの実行後にそのリクエストに関する
11 * 詳細な情報を取得するために使われます。
12 *
13 * 注意: この定数で意味のある値を取得するには、実際にはRTSPストリームへの
14 * リクエストが必要です。通常のHTTP/HTTPSリクエストでは、この情報は通常
15 * 0として返されます。このサンプルコードは定数の使い方を示すことを目的としています。
16 */
17function demonstrateCurlInfoRTSPServerCseq(): void
18{
19    // cURLセッションを初期化します
20    $ch = curl_init();
21
22    // cURLセッションの初期化に失敗した場合はエラーメッセージを表示して終了します
23    if ($ch === false) {
24        echo "cURLセッションの初期化に失敗しました。\n";
25        return;
26    }
27
28    // サンプルURLを設定します。
29    // 実際にはRTSPストリームのURL（例: rtsp://example.com/stream）が必要ですが、
30    // この例は定数の使い方を示すため、一般的なHTTP URLを使用します。
31    $url = "https://example.com";
32    curl_setopt($ch, CURLOPT_URL, $url);
33    // レスポンスの内容を文字列として取得する設定
34    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
35    // SSL証明書の検証をスキップ（開発・テスト用。本番環境では非推奨）
36    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
37    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
38
39    echo "URL '{$url}' へのcURLリクエストを試行します。\n\n";
40
41    // cURLリクエストを実行します
42    $response = curl_exec($ch);
43
44    // cURLリクエスト中にエラーが発生したか確認します
45    if (curl_errno($ch)) {
46        echo 'cURLエラーが発生しました: ' . curl_error($ch) . "\n";
47    } else {
48        // CURLINFO_RTSP_SERVER_CSEQ の情報を取得します。
49        // HTTPリクエストの場合、この値は通常0または未定義となります。
50        $rtspServerCseq = curl_getinfo($ch, CURLINFO_RTSP_SERVER_CSEQ);
51
52        echo "CURLINFO_RTSP_SERVER_CSEQ の値: ";
53        if ($rtspServerCseq === 0 || $rtspServerCseq === false) {
54            echo "0 (RTSP情報が利用できないか、リクエストがRTSPプロトコルではありません。)\n";
55        } else {
56            echo "{$rtspServerCseq}\n";
57        }
58
59        // 参考として、他のcURL情報（HTTPステータスコードなど）も取得できます。
60        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
61        echo "HTTPステータスコード: {$httpCode}\n";
62    }
63
64    // cURLセッションを閉じ、リソースを解放します
65    curl_close($ch);
66}
67
68// 定数の使用例を示す関数を実行します
69demonstrateCurlInfoRTSPServerCseq();

PHPのCURLINFO_RTSP_SERVER_CSEQは、cURL拡張が提供する定数の一つです。この定数は、RTSP（Real-Time Streaming Protocol）を用いたネットワーク通信において、サーバーから報告されたシーケンス番号（CSEQ）を取得するために使用されます。cURLは、HTTPやFTP、RTSPなど、様々なプロトコルでのデータ転送を可能にする強力なライブラリで、PHPではcURL拡張として利用できます。

サンプルコードは、cURLを使ったネットワーク通信と情報取得の一連の流れを示しています。まず、curl_init()でcURLセッションを初期化し、curl_setopt()で通信先のURLなどの設定を行います。次に、curl_exec()で実際にリクエストを実行し、その結果を取得します。リクエスト実行後、curl_getinfo()関数にCURLINFO_RTSP_SERVER_CSEQを渡すことで、通信に関する詳細な情報を取得できます。この定数自体には引数や戻り値はありませんが、curl_getinfo()は情報の取得結果を返します。

注意点として、この定数はRTSPプロトコルに特化した情報であるため、通常のHTTPやHTTPSリクエストでは、その値は通常0として返されます。サンプルコードは一般的なHTTPサイトへのアクセスを行っていますが、これは定数の利用方法を示すための例であり、RTSPストリームへのリクエストで真価を発揮します。