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

CURLINFO_REDIRECT_TIME定数は、PHPのcURL拡張機能を利用してHTTPリクエストを実行する際、そのリクエストがリダイレクト処理に要した合計時間を表す定数です。この定数は、curl_getinfo()関数と組み合わせて使用することで、ネットワーク操作の詳細なパフォーマンス情報を取得するために利用されます。

具体的には、最初のURLへのリクエストが開始されてから、最終的なリダイレクト先への接続が確立されるまでの、すべてのリダイレクト処理にかかった合計時間が、秒単位の浮動小数点数として返されます。例えば、ウェブサイトへのアクセスが複数のリダイレクトを経て目的のページに到達した場合、そのすべての中継地点でのリダイレクト処理にかかる時間が合算されてこの値となります。これには、DNS解決、TCP接続、SSL/TLSハンドシェイクといった、リダイレクトに伴う各段階のネットワーク処理時間も含まれる場合があります。

この情報は、特に外部サービスとの連携やウェブスクレイピングなど、リダイレクトが頻繁に発生するHTTP通信を行う際に非常に重要です。システムエンジニアは、この値を確認することで、リダイレクト処理に過剰な時間がかかっていないか、あるいは予期せぬリダイレクトループが発生していないかといった問題を分析し、ネットワーク通信のパフォーマンスボトルネックを特定する手がかりにすることができます。リダイレクトが発生しなかった場合は0.0が、エラー発生時は-1.0が返されることがあります。これにより、アプリケーションの応答性を改善するための具体的な指標を得ることが可能です。

Copy
1<?php
2$curl_handle = curl_init("https://example.com");
3curl_exec($curl_handle);
4$redirect_time = curl_getinfo($curl_handle, CURLINFO_REDIRECT_TIME);
5curl_close($curl_handle);
6?>

引数なし

引数はありません

float

リダイレクトが発生した場合、リダイレクトに費やされた合計時間を秒単位の浮動小数点数で返します。