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

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

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

作成日: 更新日:

基本的な使い方

CURLOPT_REDIR_PROTOCOLS_STR定数は、PHPのcURL拡張機能を利用してHTTPリクエストを行う際に、リダイレクト先に許可されるプロトコルを指定するために使用される定数です。この定数は、cURLオプションの一つとして設定され、特にPHP 8.0以降で導入されました。以前はビットマスク形式でプロトコルを指定する CURLOPT_REDIR_PROTOCOLS が使われていましたが、CURLOPT_REDIR_PROTOCOLS_STR を使用することで、より直感的に文字列形式で許可するプロトコルを指定できるようになりました。

このオプションを設定する際には、"http,https,ftp"のように、許可したいプロトコル名をコンマ(,)で区切った文字列として指定します。例えば、HTTPとHTTPSのみへのリダイレクトを許可したい場合は、CURLOPT_REDIR_PROTOCOLS_STR に "http,https" という文字列を設定します。これにより、意図しないプロトコルへのリダイレクトを防ぎ、セキュリティを強化することが可能になります。ウェブアプリケーションが外部のリソースにアクセスする際、悪意のあるリダイレクトによって機密情報が漏洩したり、予期せぬ動作が発生したりするリスクを低減するために重要な設定です。この定数が設定されていない場合、cURLは CURLOPT_PROTOCOLS_STR オプションで許可されているプロトコルに従ってリダイレクトを処理します。安全な通信を行う上で、適切なプロトコル制限を設定することは不可欠です。

構文(syntax)

1<?php
2$ch = curl_init();
3curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
4curl_setopt($ch, CURLOPT_REDIR_PROTOCOLS_STR, "http,https");
5curl_close($ch);
6?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

戻り値なし

戻り値はありません

関連コンテンツ