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

CURLINFO_HTTP_CONNECTCODE定数は、PHPのcURL拡張機能において、プロキシサーバーを介したHTTP CONNECTメソッドによる接続確立の際に、プロキシサーバーから返されるHTTPステータスコードを表す定数です。

PHPのcURL拡張機能は、ウェブサイトへのアクセスやAPI連携など、様々なプロトコルを利用したデータ転送を行うための強力なライブラリです。このCURLINFO_HTTP_CONNECTCODE定数は、curl_getinfo()関数と共に利用されます。curl_getinfo()関数は、cURLによるデータ転送が完了した後に、その転送に関する詳細な情報を取得するために用いられます。

特に、インターネット接続においてプロキシサーバーを経由する場合、クライアントはプロキシに対し、特定のホストへの安全なトンネル（主にSSL/TLS暗号化通信、つまりHTTPS通信のため）の確立を要求するためにHTTP CONNECTメソッドを使用します。この定数は、そのCONNECTリクエストに対してプロキシサーバーが応答として返したHTTPステータスコード（例えば、接続成功を示す200など）を取得する際に指定します。

これは、通常のHTTPリクエストに対する最終的なウェブサーバーからのステータスコード（例: 404 Not Found）とは異なり、プロキシサーバーとクライアントの間でのトンネル確立が正常に行われたか、あるいはプロキシ側で問題が発生したかを示す中間的な情報です。システムエンジニアにとって、プロキシ経由の通信における接続問題をデバッグする際に、この定数から得られる情報は非常に有用となります。プロキシを使用しない直接的なHTTPリクエストの場合には、この定数から有用な値は得られません。

Copy
1<?php
2var_dump(CURLINFO_HTTP_CONNECTCODE);
3?>

引数なし

引数はありません

戻り値なし

戻り値はありません