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

CURLOPT_CONNECT_TO定数は、PHPのcURL拡張機能において、ネットワーク接続のリクエスト先を再マッピングするための設定を表す定数です。この定数を使用すると、cURLが特定のホストとポートへ接続しようとする際に、本来の接続先とは異なる代替のホストとポートへ接続するように強制的に変更できます。

具体的には、curl_setopt()関数にこの定数を指定し、値として接続先のマッピングルールを記述した文字列の配列を渡します。各文字列は「HOST:PORT:ALT_HOST:ALT_PORT」という形式で構成され、例えば「example.com:80:localhost:8080」と設定した場合、cURLがexample.comの80番ポートへ接続を試みると、実際にはlocalhostの8080番ポートへ接続が実行されます。

この機能は、開発環境やテスト環境で特に有用です。例えば、本番環境と同じドメイン名を使ってローカル開発サーバー上のアプリケーションをテストしたい場合や、外部サービスへの接続を、DNSの設定を変更することなく一時的にローカルプロキシやテスト用のエンドポイントにルーティングしたい場合に活用できます。PHP 8以降のバージョンで利用可能であり、柔軟なネットワーク接続制御を実現するための重要なオプションの一つとして提供されています。

Copy
1<?php
2$ch = curl_init();
3curl_setopt($ch, CURLOPT_CONNECT_TO, ["original.example.com:80:proxy.example.com:8080"]);
4curl_close($ch);

引数なし

引数はありません

戻り値なし

戻り値はありません