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

CURLOPT_SERVER_RESPONSE_TIMEOUT定数は、PHPのcURL拡張機能において、サーバーからの最初の応答を待つ最大時間を設定するために使用される定数です。cURLは、HTTP通信など様々なプロトコルを利用して、ウェブサーバーとデータを送受信するための強力なライブラリです。

この定数は、curl_setopt()関数を通じてcURLセッションに適用されます。具体的には、クライアントがサーバーへリクエストを送信した後、サーバーが最初のデータ（例えば、HTTPヘッダや応答ボディの最初の部分）を返し始めるまでの最大時間を秒単位で指定します。これは、サーバー側の処理に時間がかかっている場合に、いつまで待機するかを制御する目的で使用されます。

重要な点として、このタイムアウトには、名前解決（DNSルックアップ）、TCP接続の確立、SSL/TLSハンドシェイクといった、サーバーへの接続自体にかかる時間は含まれません。これらの接続に関するタイムアウトは、CURLOPT_CONNECTTIMEOUTなどの別のオプションで設定されます。CURLOPT_SERVER_RESPONSE_TIMEOUTは、接続が確立され、リクエストが送信された後の、サーバー側からの応答開始に特化したタイムアウトです。

この値を設定することで、応答しないサーバーや、処理に時間がかかりすぎるサーバーによってプログラムが長時間ブロックされるのを防ぎ、アプリケーションの応答性を向上させることができます。例えば、curl_setopt($ch, CURLOPT_SERVER_RESPONSE_TIMEOUT, 10);と設定した場合、サーバーから10秒以内に応答がなければ、cURL操作はタイムアウトエラーとなります。0を指定すると、このタイムアウトが無効になり、無限に待機する可能性がありますが、他のタイムアウト設定が優先される場合もあります。ネットワーク通信の信頼性と効率を高める上で重要な設定の一つです。

Copy
1curl_setopt($ch, CURLOPT_SERVER_RESPONSE_TIMEOUT, 10);

引数なし

引数はありません

戻り値なし

戻り値はありません