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

CURLINFO_REDIRECT_COUNT定数は、PHPのcURL拡張機能において、HTTPリクエスト中に発生したリダイレクトの回数を表す定数です。cURLは、Webサーバーなどとデータ通信を行うための強力なライブラリであり、PHPでは主にcurl_*関数群として提供されています。

この定数は、curl_exec()関数でcURLセッションが実行された後、その通信セッションに関する情報を取得するために用いられるcurl_getinfo()関数の引数として使用されます。具体的には、curl_getinfo($ch, CURLINFO_REDIRECT_COUNT)のように呼び出すことで、指定されたcURLハンドル（$ch）が実行したリクエストにおいて、HTTPリダイレクトが何回発生したかの総数を整数値として取得できます。

例えば、あるWebサイトのURLにアクセスした際に、そのサイトが別のURLへ自動的に転送される（リダイレクト）場合があります。この定数を使用することで、そのようなリダイレクトが実際に何回行われたかをプログラム的に確認できるようになります。これは、Webスクレイピングや外部APIとの連携、URLの追跡など、HTTP通信を伴うアプリケーション開発において、リクエストの挙動を正確に把握するために非常に重要です。

取得できる情報は、HTTPステータスコードが3xx番台（例：301 Moved Permanently、302 Foundなど）である場合に発生するリダイレクトの合計回数を指します。この情報により、目的のWebリソースに到達するまでの経路を分析し、処理の効率化やデバッグ、異常検出などのロジックを構築する際に役立てることができます。

Copy
1<?php
2$ch = curl_init("https://www.example.com");
3curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
4curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
5curl_exec($ch);
6$redirect_count = curl_getinfo($ch, CURLINFO_REDIRECT_COUNT);
7curl_close($ch);
8?>

引数なし

引数はありません

戻り値なし

戻り値はありません