ftp_fget
(PHP 4, PHP 5, PHP 7)
ftp_fget — FTP サーバーからファイルをダウンロードし、オープン中のファイルに保存する
説明
ftp_fget
( resource $ftp_stream
, resource $handle
, string $remote_file
[, int $mode
= FTP_BINARY
[, int $resumepos
= 0
]] ) : bool
ftp_fget() は、FTP サーバーから
remote_file
を取得し、指定したファイルポインタ
fp
に書きこみます。
パラメータ
ftp_stream
- FTP 接続のリンク ID 。
handle
- オープンされているファイルのポインタ。ここにデータが保存されます。
remote_file
- リモートファイルのパス。
mode
- 転送モード。
FTP_ASCII
またはFTP_BINARY
のどちらかを指定する必要があります。 resumepos
- リモートファイル中で、ダウンロードを開始する位置。
返り値
成功した場合に true
を、失敗した場合に false
を返します。
変更履歴
バージョン | 説明 |
---|---|
7.3.0 | mode パラメータはオプションになりました。
これより前のバージョンでは、このパラメータは必須でした。 |
例
例1 ftp_fget() の例
<?php// リモートファイルへのパス。$remote_file = 'somefile.txt';$local_file = 'localfile.txt';// 書き込み用のファイルをオープンします。$handle = fopen($local_file, 'w');// 接続を確立します。$conn_id = ftp_connect($ftp_server);// ユーザー名とパスワードを指定してログインします。$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);// $remote_file をダウンロードし、$handle に保存しようとします。if (ftp_fget($conn_id, $handle, $remote_file, FTP_ASCII, 0)) { echo "$local_file への書き込みに成功しました\n";} else { echo "$remote_file を $local_file にダウンロードする際に問題が発生しました\n";}// 接続およびファイルハンドラを閉じます。ftp_close($conn_id);fclose($handle);?>
参考
- ftp_get() - FTP サーバーからファイルをダウンロードする
- ftp_nb_get() - FTP サーバーからファイルを取得し、ローカルファイルに書き込む(非ブロッキング)
- ftp_nb_fget() - FTP サーバーからファイルをダウンロードし、オープン中のファイルに保存する(非ブロッキング)