ftp_get

(PHP 4, PHP 5, PHP 7, PHP 8)

ftp_getFTP サーバーからファイルをダウンロードする

説明

ftp_get(
    FTP\Connection $ftp,
    string $local_filename,
    string $remote_filename,
    int $mode = FTP_BINARY,
    int $offset = 0
): bool

ftp_get() は FTP サーバーからリモートファイルを取得し、 それをローカルファイルに保存します。

パラメータ

ftp

FTP\Connection クラスのインスタンス

local_filename

ローカルファイルのパス(ファイルがすでに存在する場合は上書きされます)。

remote_filename

リモートファイルのパス。

mode

転送モード。FTP_ASCII または FTP_BINARY のどちらかを指定する必要があります。

offset

リモートファイルの、ダウンロードを開始する位置。

戻り値

成功した場合に true を、失敗した場合に false を返します。

変更履歴

バージョン 説明
8.1.0 引数 ftp は、FTP\Connection のインスタンスを期待するようになりました。 これより前のバージョンでは、リソース を期待していました。
7.3.0 mode パラメータはオプションになりました。 これより前のバージョンでは、このパラメータは必須でした。

例1 ftp_get() の例

<?php

// 変数を定義する
$local_file 'local.zip';
$server_file 'server.zip';

// 接続を確立する
$ftp ftp_connect($ftp_server);

// ユーザー名とパスワードでログインする
$login_result ftp_login($ftp$ftp_user_name$ftp_user_pass);

// $server_file をダウンロードし、$local_file への保存を試みる
if (ftp_get($ftp$local_file$server_fileFTP_BINARY)) {
    echo 
"Successfully written to $local_file\n";
} else {
    echo 
"There was a problem\n";
}

// 接続を閉じる
ftp_close($ftp);

?>

参考

  • ftp_pasv() - パッシブモードをオンまたはオフにする
  • ftp_fget() - FTP サーバーからファイルをダウンロードし、オープン中のファイルに保存する
  • ftp_nb_get() - FTP サーバーからファイルを取得し、ローカルファイルに書き込む(非ブロッキング)
  • ftp_nb_fget() - FTP サーバーからファイルをダウンロードし、オープン中のファイルに保存する(非ブロッキング)

関連キーワード:  サーバー, ダウンロード, ファイル, filename, ローカル, Connection, バージョン, パラメータ, mode, 保存