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

CURLOPT_FTPPORT定数は、PHPのcURL拡張機能において、FTP（File Transfer Protocol）接続のアクティブモードでのデータ転送時に使用されるPORTコマンドで、クライアントが自身のIPアドレスをサーバーに通知するための値を設定する際に用いる定数です。この定数に文字列としてIPアドレスを設定することで、cURLはFTPサーバーに対して、指定されたIPアドレスと、cURLが内部的に動的に割り当てるポート番号を使用してデータ接続を確立するよう要求します。

例えば、クライアントがNAT（ネットワークアドレス変換）環境の背後にある場合や、複数のネットワークインターフェースを持つサーバー上で特定のIPアドレスを使ってFTPデータ接続を確立したい場合に、このオプションが役立ちます。これにより、ファイアウォールやルーターによってクライアントの内部IPアドレスが直接見えない状況でも、データ接続が正しく確立される可能性が高まります。また、このオプションに空の文字列を設定した場合は、PORTコマンドの代わりにEPRTコマンドが使用され、システムのデフォルトのIPアドレスが通知されます。

このオプションを設定しない場合、cURLは一般的にパッシブモード（PASVコマンド）を優先して使用しようとします。または、アクティブモードを使用する場合でも、システムが自動的にクライアントのIPアドレスを判断してPORTコマンドを発行します。したがって、特定のIPアドレスを明示的に指定する必要がある状況でのみ、このCURLOPT_FTPPORT定数を使用することが推奨されます。多くのネットワーク環境ではパッシブモードが推奨されますが、アクティブモードが必須となる特定の環境下では重要な役割を果たす定数と言えます。

Copy
1<?php
2$ch = curl_init();
3curl_setopt($ch, CURLOPT_URL, "ftp://example.com/remote/file.txt");
4curl_setopt($ch, CURLOPT_FTPPORT, "localhost:21");
5curl_close($ch);

引数なし

引数はありません

戻り値なし

戻り値はありません