【PHP8.x】CURLINFO_CONNECT_TIME定数の使い方
CURLINFO_CONNECT_TIME定数の使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
CURLINFO_CONNECT_TIME定数は、PHPのcURL拡張機能において、curl_getinfo()関数を使用して特定の転送情報を取得する際に指定する定数です。この定数を用いることで、HTTPなどの通信において、リモートサーバーへのTCP接続が完了するまでにかかった時間を秒単位の浮動小数点数で取得できます。具体的には、ドメイン名の名前解決（DNSルックアップ）から始まり、ターゲットとなるサーバーとのTCPハンドシェイクが成功し、データ転送の準備が整うまでの合計時間を測定します。
この接続時間は、ネットワーク通信のパフォーマンスを評価する上で重要な指標となります。システムエンジニアは、アプリケーションの応答が遅いと感じた際に、接続時間を確認することで、ネットワーク環境に問題があるのか、あるいはサーバー側の応答が遅いのかといった原因を切り分ける手助けとすることができます。例えば、接続時間が異常に長い場合は、DNS設定の問題やネットワーク経路の遅延、あるいはサーバーの負荷が高いことなどが考えられます。このように、CURLINFO_CONNECT_TIME定数は、Webアプリケーションの安定稼働を支える上で、通信トラブルの診断や最適化に役立つ貴重な情報を提供します。
構文(syntax)
1<?php 2$ch = curl_init('http://example.com'); 3curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); 4curl_exec($ch); 5$connect_time_seconds = curl_getinfo($ch, CURLINFO_CONNECT_TIME); 6curl_close($ch); 7?>
引数(parameters)
引数なし
引数はありません
戻り値(return)
int
この定数は、PHPがHTTPリクエストを送信する際に、サーバーへの接続が確立されるまでにかかった時間を秒単位で整数（int）で返します。