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

CURLINFO_PRIMARY_PORT定数は、PHPのcURL拡張機能において、実行されたcURL転送に関する詳細な情報を取得する際に、特に接続先のプライマリポート番号を表す定数です。この定数は、cURLセッションの情報を取得するためのcurl_getinfo()関数と組み合わせて使用されます。

curl_getinfo()関数は、すでに実行されたcURLセッションに関する様々な情報を取得するために利用される重要な関数です。その際、どの種類の情報を取得したいかを指定するために、CURLINFO_PRIMARY_PORTのような定数を使用します。具体的には、curl_getinfo()関数の第二引数にCURLINFO_PRIMARY_PORTを渡すことで、PHPはcURLが実際に接続したリモートサーバーのポート番号を整数値として返します。

例えば、Webサーバーの標準ポートである80番やHTTPSの443番など、cURLが接続に成功したエンドポイントのポート番号をプログラム内で確認したい場合にこの定数が役立ちます。ネットワーク接続のデバッグ、ログ記録、あるいは接続先の詳細情報の確認といったシナリオで非常に有用です。この定数を利用することで、システムエンジニアはcURLセッションの挙動をより詳細に把握し、問題解決やシステム監視に活用することができます。

Copy
1<?php
2$ch = curl_init("http://www.example.com");
3curl_exec($ch);
4$primaryPort = curl_getinfo($ch, CURLINFO_PRIMARY_PORT);
5curl_close($ch);
6?>

引数なし

引数はありません

int

この定数は、接続されたプライマリポートの番号を整数型で返します。