Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

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

CURLOPT_AUTOREFERER定数の使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

CURLOPT_AUTOREFERER定数は、PHPのcURL拡張機能において、HTTPリクエストのRefererヘッダの自動生成を制御するかどうかを表す定数です。この定数は、curl_setopt()関数を用いてcURLセッションの動作を設定する際に使用されます。

ウェブブラウザがリンクをたどってページを移動する際、通常は元のページのURLがRefererヘッダとして次のリクエストに含まれます。このCURLOPT_AUTOREFERER定数をTRUEに設定すると、cURLも同様の動作を模倣します。具体的には、cURLがHTTPリダイレクト(例: 301 Moved Permanently, 302 Foundなど)を処理する際に、自動的にそのリダイレクト元のURLを次のリクエストのRefererヘッダとして設定します。

この機能は、特にウェブサイトがRefererヘッダをチェックしている場合や、ブラウザに近い振る舞いをして正しくコンテンツを取得する必要がある場合に役立ちます。例えば、特定のページへのアクセスが、別のページからのリンク経由であることをサーバー側が要求するような状況で利用されます。

一方、この定数をFALSEに設定した場合は、cURLはRefererヘッダを自動的に設定しません。これにより、Refererヘッダを完全に手動で制御したい場合や、不必要なReferer情報を送信したくない場合に選択されます。この定数を適切に設定することで、ウェブサーバーとの通信において、より自然で適切なHTTPリクエストを構築することが可能となります。

構文(syntax)

1<?php
2$ch = curl_init();
3curl_setopt($ch, CURLOPT_AUTOREFERER, true);
4curl_close($ch);

引数(parameters)

引数なし

引数はありません

戻り値(return)

戻り値なし

戻り値はありません

関連コンテンツ