【PHP8.x】CURLOPT_ACCEPTTIMEOUT_MS定数の使い方
CURLOPT_ACCEPTTIMEOUT_MS定数の使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
CURLOPT_ACCEPTTIMEOUT_MS定数は、PHPのcURL拡張機能において、データ転送中のアイドルタイムアウト時間をミリ秒単位で設定するために使用される定数です。この定数に値を設定することで、cURLによるネットワーク通信において、TCP接続が確立された後に、サーバーからのデータ転送が指定されたミリ秒間停止した場合に、cURL操作を強制的に終了させることができます。
これは、ネットワークの遅延やサーバー側の応答停止などによって、データ転送が途中で途絶え、プログラムが長時間応答を待ち続ける状況を防ぐために非常に重要です。例えば、Web APIへのリクエストが、サーバーからデータが送られてこないために無限に待機し続けてしまうといった問題を回避できます。このタイムアウトは、リクエスト全体の処理時間に対する制限であるCURLOPT_TIMEOUT_MSとは異なり、あくまで接続が確立された後のデータ転送が「アイドル状態」（つまり、何もデータが送られてこない状態）になった場合にのみ適用されます。デフォルト値は0ミリ秒であり、これはアイドル状態のタイムアウトを無期限に許可することを意味します。システムの安定性や外部サービスへの依存度が高いアプリケーションにおいて、適切な値を設定することで、より堅牢なエラーハンドリングと迅速な障害検知を実現できます。
構文(syntax)
1<?php 2curl_setopt($curl_handle, CURLOPT_ACCEPTTIMEOUT_MS, 100);
引数(parameters)
引数なし
引数はありません
戻り値(return)
戻り値なし
戻り値はありません