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

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

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

作成日: 更新日:

基本的な使い方

CURLOPT_NOPROXY定数は、PHPのcURL拡張機能において、プロキシサーバを経由せずに直接接続を行うべきホストを指定するための定数です。システム開発において、インターネットへのアクセスはセキュリティやネットワーク制御の目的でプロキシサーバを経由させることがよくあります。しかし、すべての通信をプロキシ経由にするのではなく、特定の宛先に対しては直接接続を必要とするケースも存在します。このCURLOPT_NOPROXY定数は、まさにそのような状況で利用され、特定の宛先ホストへの通信時にのみプロキシの設定を無効化し、直接インターネットへの接続を試みることを可能にします。

cURLのオプションとして設定する際には、この定数をキーとして使用し、その値にはプロキシを使用しないホスト名やIPアドレス、またはサブネットのリストを文字列形式で渡します。複数の宛先を指定する際は、カンマ(,)で区切って記述します。例えば、「example.com,localhost,192.168.0.0/16」のように設定することで、これら指定されたドメインやIP範囲へのリクエストでは、CURLOPT_PROXYなどで設定されたプロキシが無視され、直接通信が行われます。

この機能は、社内ネットワーク内のサーバへのアクセスや、特定の外部サービスとの連携において、プロキシを経由させたくない、あるいは経由できないといった要件がある場合に非常に重要です。プロキシの有無に関わらず、柔軟かつ効率的なネットワークアクセス制御をPHPアプリケーションで実現するための、重要な設定オプションの一つと言えます。特に、既存のプロキシ設定が存在する環境で、一部の通信だけを除外したい場合にこの定数が活躍します。

構文(syntax)

1<?php
2$ch = curl_init();
3curl_setopt($ch, CURLOPT_NOPROXY, 'localhost,127.0.0.1');
4curl_close($ch);

引数(parameters)

引数なし

引数はありません

戻り値(return)

int

CURLOPT_NOPROXY は、プロキシサーバーを経由しないように指定するための定数です。この定数を CURLOPT_PROXY を使用する際に指定すると、プロキシ設定が無効になります。

関連コンテンツ