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

CURLOPT_POSTREDIR定数は、PHPのcURL拡張機能において、HTTPリダイレクト発生時にPOSTリクエストをどのように扱うかを制御するためのオプションを表す定数です。WebアプリケーションでHTTPリクエストを送信する際、リクエスト先のサーバーから別のURLへの転送（リダイレクト）が指示されることがあります。一般的なHTTPの301（Moved Permanently）や302（Found）リダイレクトでは、元のPOSTリクエストが自動的にGETリクエストに変換されてしまうため、POSTで送信されたデータがリダイレクト先で失われる可能性があります。

この定数をcurl_setopt()関数で設定することで、リダイレクトの種類に応じてPOSTリクエストをGETに変換せず、元のPOSTの形式を維持したままリダイレクト先に送信するかどうかを詳細に指定できます。具体的には、CURL_REDIR_POST_301（301リダイレクトでPOSTを保持）、CURL_REDIR_POST_302（302リダイレクトでPOSTを保持）、CURL_REDIR_POST_303（303リダイレクトでPOSTを保持）といった値を組み合わせてビットマスクとして指定し、どのHTTPステータスコードのリダイレクトでPOSTリクエストを保持するかを制御します。これにより、フォームデータなどの重要なPOSTデータを伴うリクエストがリダイレクトされた場合でも、データの整合性を保ち、アプリケーションが期待通りに動作するように調整することが可能になります。システム開発において、リダイレクト処理を含むAPI連携やWebスクレイピングを行う際に重要な役割を果たす定数です。

Copy
1<?php
2$ch = curl_init();
3curl_setopt($ch, CURLOPT_URL, "https://example.com/api/redirect");
4curl_setopt($ch, CURLOPT_POST, true);
5curl_setopt($ch, CURLOPT_POSTFIELDS, "data=example");
6curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
7curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
8curl_setopt($ch, CURLOPT_POSTREDIR, CURL_REDIR_POST_ALL);
9
10$response = curl_exec($ch);
11curl_close($ch);
12?>

引数なし

引数はありません

戻り値なし

戻り値はありません