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

CURLINFO_PRIMARY_IP定数は、PHPのcURL拡張機能において、実行されたcURLセッションが実際に接続を確立したリモートサーバーのプライマリIPアドレスを取得するために使用される定数です。

PHPで外部のウェブサービスやAPIと通信する際に利用されるcURLは、多くのネットワーク操作を可能にする強力なツールです。この定数は、cURLセッションが完了した後に、その通信が具体的にどのIPアドレスを持つサーバーと行われたのかを知りたい場合に特に役立ちます。使用方法は、まずcurl_init()でcURLセッションを初期化し、各種オプションを設定してcurl_exec()で実行します。その後、curl_getinfo()関数を呼び出し、その第二引数としてCURLINFO_PRIMARY_IPを指定することで、接続先のIPアドレスが文字列形式で返されます。

この情報は、例えばウェブサーバーがDNSラウンドロビンなどの負荷分散技術を利用している場合や、プロキシサーバーを経由して通信している場合など、実際に接続されたエンドポイントの正確なIPアドレスを確認する際に重要となります。システムエンジニアにとって、ネットワーク通信のデバッグ、ログの記録、セキュリティ監査、または特定のIPアドレスへの接続確認を行う上で不可欠な情報であり、通信の信頼性と透明性を確保するための一助となるでしょう。

Copy
1<?php
2
3$ch = curl_init();
4curl_setopt($ch, CURLOPT_URL, "http://example.com");
5curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
6
7curl_exec($ch);
8
9$primary_ip = curl_getinfo($ch, CURLINFO_PRIMARY_IP);
10
11echo $primary_ip;
12
13curl_close($ch);
14
15?>

引数なし

引数はありません

戻り値なし

戻り値はありません