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

CURL_HTTP_VERSION_3ONLY定数は、PHPのcURL拡張機能において、HTTP通信のプロトコルバージョンをHTTP/3のみに限定することを指示する定数です。この定数を使用すると、cURLが外部のWebサーバーと通信する際に、HTTP/3プロトコルだけを試行し、それ以外のバージョンでの接続を一切許可しないようになります。

具体的には、curl_setopt()関数を使ってCURLOPT_HTTP_VERSIONオプションにこのCURL_HTTP_VERSION_3ONLY定数を設定することで、プログラムが確立しようとするHTTP接続は、HTTP/3が利用できない場合には必ず失敗します。これは、アプリケーションが厳密にHTTP/3経由での通信を要求し、他のHTTPバージョン（HTTP/1.1やHTTP/2など）でのフォールバックを許容しない場合に特に有用です。

HTTP/3は、UDPベースのQUICプロトコルを利用することで、従来のHTTPプロトコルと比較して通信の効率性や安定性を向上させる最新のプロトコルです。この定数を活用することで、常に最新の高速通信プロトコルでの接続を保証し、特定のパフォーマンス要件を満たすことが可能になります。ただし、接続先のサーバーがHTTP/3に対応していない環境では接続が確立できないため、利用する際は対象サーバーの対応状況を事前に確認することが重要です。この定数はPHP 8.2以降のバージョンで導入されました。

Copy
1curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_3ONLY);

引数なし

引数はありません

int

CURL_HTTP_VERSION_3ONLY は、HTTP/3 プロトコルのみを使用するように cURL に指示するための定数です。この定数は整数値 1 を返します。