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

Copy
1<?php
2
3/**
4 * 指定されたURLへのHTTPリクエストを実行し、HTTPレスポンスコードを取得します。
5 * システムエンジニアを目指す初心者が、cURLを使ってWebリソースにアクセスし、
6 * その応答状況（成功/失敗）を判断する基本的な方法を理解するのに役立ちます。
7 *
8 * @param string $url リクエストを送信するURL。
9 * @return int|false HTTPレスポンスコード（例: 200, 404, 500）を返します。
10 *                   cURLの実行に失敗した場合は false を返します。
11 */
12function getHttpResponseCode(string $url): int|false
13{
14    // cURLセッションを初期化
15    $ch = curl_init();
16
17    // cURLオプションを設定
18    // リクエスト対象のURL
19    curl_setopt($ch, CURLOPT_URL, $url);
20    // レスポンスボディを文字列として取得（出力しない）
21    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
22    // HTTPリダイレクトを自動的に追跡
23    curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
24    // リダイレクト回数の上限
25    curl_setopt($ch, CURLOPT_MAXREDIRS, 10);
26    // 接続タイムアウト（秒）
27    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
28    // 実行タイムアウト（秒）
29    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
30    // SSL証明書の検証を無効化（開発・テスト環境向け。本番環境では通常 true に設定し、検証を有効にする）
31    // curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
32    // curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2); // 0 は無効、1 はCNのみ、2 はCNとSANの両方を検証
33
34    // cURLセッションを実行
35    $response = curl_exec($ch);
36
37    // エラーチェック
38    if (curl_errno($ch)) {
39        // エラーが発生した場合、エラーメッセージをログに出力し false を返す
40        error_log("cURL Error: " . curl_error($ch));
41        curl_close($ch);
42        return false;
43    }
44
45    // HTTPレスポンスコードを取得
46    // CURLINFO_HTTP_CODE は、HTTPレスポンスのステータスコード（例: 200 OK, 404 Not Found）を取得するための定数です。
47    // PHP 8では、CURLINFO_RESPONSE_CODE も CURLINFO_HTTP_CODE のエイリアスとして利用可能です（PHP 7.82.0 以降）。
48    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
49
50    // cURLセッションを閉じる
51    curl_close($ch);
52
53    return $httpCode;
54}
55
56// --- サンプル使用例 ---
57// 動作確認用のURL
58$targetUrl = "https://www.google.com";
59
60$code = getHttpResponseCode($targetUrl);
61
62if ($code !== false) {
63    echo "URL: " . $targetUrl . "\n";
64    echo "HTTP Response Code: " . $code . "\n";
65
66    // レスポンスコードによる簡単なステータス判定例
67    if ($code >= 200 && $code < 300) {
68        echo "Status: Success (OK)\n";
69    } elseif ($code >= 300 && $code < 400) {
70        echo "Status: Redirection\n";
71    } elseif ($code >= 400 && $code < 500) {
72        echo "Status: Client Error (e.g., Not Found, Bad Request)\n";
73    } elseif ($code >= 500 && $code < 600) {
74        echo "Status: Server Error (e.g., Internal Server Error)\n";
75    } else {
76        echo "Status: Unknown or Informational\n";
77    }
78} else {
79    echo "Failed to get HTTP response code for " . $targetUrl . "\n";
80}
81
82echo "\n";
83
84// 存在しないURLへのリクエスト例
85$nonExistentUrl = "https://example.com/nonexistent-page-12345";
86$codeNonExistent = getHttpResponseCode($nonExistentUrl);
87
88if ($codeNonExistent !== false) {
89    echo "URL: " . $nonExistentUrl . "\n";
90    echo "HTTP Response Code: " . $codeNonExistent . "\n";
91    if ($codeNonExistent == 404) {
92        echo "Status: Client Error (Not Found)\n";
93    } else {
94        echo "Status: " . ($codeNonExistent >= 200 && $codeNonExistent < 300 ? "Success" : "Error") . "\n";
95    }
96} else {
97    echo "Failed to get HTTP response code for " . $nonExistentUrl . "\n";
98}
99
100?>

このPHPサンプルコードは、cURL拡張機能を利用して指定されたURLへHTTPリクエストを送信し、そのHTTPレスポンスコードを取得する方法を示しています。システムエンジニアを目指す初心者が、WebサイトやAPIなどのリソースが正しく応答しているかを確認する基本的な技術を理解するのに役立ちます。

まず、curl_init()でcURLセッションを初期化し、curl_setopt()でリクエスト先のURL、レスポンスボディを文字列として取得するかどうか（CURLOPT_RETURNTRANSFER）、リダイレクトの追跡、タイムアウトなどのオプションを設定します。設定後、curl_exec()で実際のHTTPリクエストが実行され、応答が返されます。

重要な点は、curl_getinfo()関数とCURLINFO_HTTP_CODE定数（PHP 8ではCURLINFO_RESPONSE_CODEもエイリアスとして利用可能）を使って、HTTPレスポンスのステータスコード（例: 200 OK、404 Not Found、500 Internal Server Errorなど）を取得していることです。これにより、Webリソースの状況を数値で判断できます。最後に、curl_close()でcURLセッションを閉じ、リソースを解放します。

getHttpResponseCode関数は、引数としてリクエストを送信する$url（文字列）を受け取ります。成功時にはHTTPレスポンスコード（整数値）を返し、cURLの実行に失敗した場合はfalseを返します。このコードは、Webアプリケーションにおける外部リソースの可用性チェックや、API連携のデバッグなどに活用できます。

Copy
1<?php
2
3/**
4 * CURLINFO_RTSP_CSEQ_RECV 定数の使用例を示す関数。
5 * この定数は、RTSP (Real Time Streaming Protocol) リクエストの応答から
6 * 受信したCSEQ (Command Sequence) 番号を取得するために使用されます。
7 *
8 * 実際のRTSPサーバーへの接続は行わず、定数の使用方法を示すことを目的としています。
9 * そのため、取得される値は通常0またはfalseとなります。
10 */
11function demonstrateCurlInfoRTSP()
12{
13    // cURLセッションを初期化します。
14    $ch = curl_init();
15
16    // 実際のRTSPストリームのURLをここに設定します。
17    // この例ではダミーのURLを使用しており、実際のRTSPサーバーが存在しない場合、
18    // 期待するRTSP関連情報は取得できません。
19    $rtspUrl = "rtsp://example.com/stream"; // 実際のRTSPサーバーのURLに置き換える必要があります
20
21    // cURLオプションを設定します。
22    curl_setopt($ch, CURLOPT_URL, $rtspUrl);            // アクセスするURL
23    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);     // 結果を文字列で返すように設定
24    curl_setopt($ch, CURLOPT_HEADER, false);            // レスポンスヘッダを含めない設定
25
26    // RTSPリクエストタイプを設定します（例: DESCRIBEリクエスト）。
27    // RTSPプロトコルでは、DESCRIBE, SETUP, PLAYなどのリクエストタイプがあります。
28    // このオプションを設定しない場合、CURLINFO_RTSP_CSEQ_RECVは通常0を返します。
29    curl_setopt($ch, CURLOPT_RTSP_REQUEST, CURL_RTSP_DESCRIBE);
30
31    // cURLリクエストを実行します。
32    // 実際のRTSPサーバーが存在しない場合、この実行は失敗するか、
33    // 期待するRTSP関連情報を得られない可能性があります。
34    $response = curl_exec($ch);
35
36    // エラーをチェックします。
37    if (curl_errno($ch)) {
38        echo 'cURLエラー: ' . curl_error($ch) . PHP_EOL;
39    } else {
40        // CURLINFO_RTSP_CSEQ_RECV を使用してRTSPの受信CSEQ番号を取得します。
41        // 実際のRTSP応答から取得される値ですが、ダミーのURLでは通常0または何らかのデフォルト値になります。
42        $rtspCseqRecv = curl_getinfo($ch, CURLINFO_RTSP_CSEQ_RECV);
43
44        echo "CURLINFO_RTSP_CSEQ_RECV の値: " . $rtspCseqRecv . PHP_EOL;
45
46        if ($rtspCseqRecv > 0) {
47            echo "RTSP応答からCSEQ番号が正常に取得されました。" . PHP_EOL;
48        } else {
49            echo "RTSP応答からCSEQ番号を取得できませんでした。" . PHP_EOL;
50            echo "（ヒント：ダミーのRTSP URLを使用しているか、実際のRTSPサーバーに接続できていない可能性があります。）" . PHP_EOL;
51        }
52    }
53
54    // cURLセッションを終了し、リソースを解放します。
55    curl_close($ch);
56}
57
58// 関数を実行します。
59demonstrateCurlInfoRTSP();

PHP 8で利用可能なCURLINFO_RTSP_CSEQ_RECVは、PHPのcURL拡張機能でRTSP (Real Time Streaming Protocol) 通信に関する情報を取得するために使われる定数です。この定数は、RTSPサーバーからの応答に含まれるCSEQ (Command Sequence) 番号を特定し、取得する際に役立ちます。

この定数自体に引数や戻り値はありません。代わりに、curl_getinfo()関数の第二引数としてこの定数を指定することで、現在実行中のcURLセッションにおけるRTSPリクエストの受信CSEQ番号を整数値として取得できます。

サンプルコードでは、curl_init()でcURLセッションを初期化し、curl_setopt()でRTSP関連のオプションを設定した後にcurl_exec()でリクエストを実行しています。その後、curl_getinfo($ch, CURLINFO_RTSP_CSEQ_RECV)を使ってCSEQ番号を取得し、その値を出力しています。

実際のRTSPサーバーに接続して有効なRTSPリクエストが成功しない限り、この定数で取得されるCSEQ番号は通常0となります。サンプルコードは定数の使用方法を示すためのものであり、ダミーのURLを使用しているため、通常0が出力されます。この定数は、リアルタイムストリーミングサービスと通信し、その応答シーケンスをプログラムから追跡したい場合に活用されます。