PHPのFTPコンテキストオプションの使い方を徹底解説

はじめに

PHPでは、ftp:// および ftps:// ラッパー(トランスポート)に対してストリームコンテキストオプションを指定することで、FTP通信の挙動を細かく制御できます。利用可能な主なコンテキストオプションは以下のとおりです。

これらのオプションは、stream_context_create() 関数で作成したコンテキストリソースとして fopen() などに渡すことで利用できます。

使用例

次の例では、overwrite オプションを有効にしたコンテキストを作成し、fopen() による書き込み時にFTPサイト上の既存ファイルを上書きできるようにしています。

<?php
$ftp_path = 'ftp://username:password@example.com/example.txt';
$stream_options = array('ftp' => array('overwrite' => true));
$stream_context = stream_context_create($stream_options);
$fh = fopen($ftp_path, 'w', 0, $stream_context);
fputs($fh, 'Hello World');
fclose($fh);
?>

このコードでは、まず接続情報を含むFTPのURLを定義し、次に「overwrite」をtrueに設定したオプション配列からコンテキストを生成しています。そのコンテキストを第4引数として fopen() に渡すことで、example.txt がすでに存在していても上書きして書き込めるようになります。認証情報はURLに直接埋め込んでいますが、実運用では設定ファイルや環境変数で管理し、コード内に平文で残さないように注意してください。