【PHP8.x】CURLINFO_TOTAL_TIME定数の使い方
CURLINFO_TOTAL_TIME定数の使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
CURLINFO_TOTAL_TIME定数は、PHPのcURL拡張機能において、実行されたすべての転送にかかった合計時間を秒単位で取得するために使用される定数です。これは、特定のcURLリクエストが開始されてから完了するまでの、エンドツーエンドの処理時間全体を示します。具体的には、DNSの名前解決、TCPコネクションの確立、SSL/TLSハンドシェイク、データの送信、サーバーからの応答の受信、そしてセッションの終了に至るまでの一連のプロセスにかかった時間の総和を計測します。
この定数は、curl_getinfo()関数と組み合わせて使用することで、cURLセッションのパフォーマンスに関する重要な情報を取得できます。例えば、外部のAPIやWebサービスに対してリクエストを送信し、その応答が返ってくるまでの全体の所要時間を正確に把握したい場合に役立ちます。取得される値はfloat型で、秒単位の精度で示されます。
システムエンジニアを目指す初心者の方にとって、この情報はWebアプリケーションやスクリプトが外部リソースと連携する際のパフォーマンス評価やデバッグに非常に有用です。アプリケーションが特定の外部サービスへの接続にどの程度の時間を費やしているかを把握することで、処理速度のボトルネックを特定し、パフォーマンス改善のための具体的な手がかりを得ることができます。PHPのcURL拡張機能が有効な環境であれば利用可能です。
構文(syntax)
1<?php 2$ch = curl_init(); 3curl_setopt($ch, CURLOPT_URL, "https://www.example.com"); 4curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); 5curl_exec($ch); 6$total_time_seconds = curl_getinfo($ch, CURLINFO_TOTAL_TIME); 7curl_close($ch); 8?>
引数(parameters)
引数なし
引数はありません
戻り値(return)
戻り値なし
戻り値はありません