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

CURLINFO_PRETRANSFER_TIME_T定数は、PHPのcURL拡張機能において、HTTPなどのネットワーク転送に関する特定の時間情報を取得するために使用される定数です。この定数は、プログラムが外部のWebサービスなどと通信を開始してから、実際にデータの転送が始まるまでの時間を、通常はマイクロ秒単位で表します。具体的には、名前解決（ドメイン名をIPアドレスに変換する処理）やTCPコネクションの確立、そしてHTTPS通信の場合はSSL/TLSハンドシェイクといった、データ転送の前段階で必要となる準備にかかった総時間を計測します。

この情報は、Webアプリケーションのパフォーマンス分析において非常に重要です。例えば、外部APIへのリクエストが遅いと感じた場合、データ転送前の準備段階に時間がかかっているのか、それともデータ転送そのものに時間がかかっているのかを区別することで、問題の根本原因を特定する手助けとなります。ネットワークの遅延や、対象サーバーの初期応答、セキュリティプロトコルの処理速度など、様々な要素がこの時間に影響を与えます。CURLINFO_PRETRANSFER_TIME_Tを利用することで、より詳細な通信状況を把握し、システムの最適化やデバッグに役立てることが可能です。PHP 8からは、この値がより高精度な時間情報として扱われるようになりました。

Copy
1<?php
2$ch = curl_init("http://example.com");
3curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
4curl_exec($ch);
5
6$pretransfer_time_microseconds = curl_getinfo($ch, CURLINFO_PRETRANSFER_TIME_T);
7
8curl_close($ch);
9?>

引数なし

引数はありません

戻り値なし

戻り値はありません