PHPのftp_fget()関数の使い方：FTPサーバーからファイルをダウンロードしてローカルに保存する方法

PHPのftp_fget()関数は、FTPサーバー上のファイルをダウンロードし、あらかじめ開いておいたローカルファイルに保存するために使用します。よく似た関数のftp_get()がローカルファイルのパスを直接指定するのに対し、ftp_fget()はfopen()で取得したファイルポインタ（リソース）を引数として渡す点が特徴です。

構文

ftp_fget(con, local_file, server_file, mode, startpos);

パラメータ

• con − FTP接続を示すリンクIDです。

• local_file − ダウンロードしたデータを書き込む、開かれた状態のローカルファイルポインタです。

• server_file − ダウンロード対象となるサーバー側のファイルです。

• mode − 転送モードです。FTP_ASCIIまたはFTP_BINARYを指定します。

• startpos − ダウンロードを開始する位置（オフセット）です。PHP 4.3.0で追加されました。

戻り値

ftp_fget()関数は、成功した場合にTRUEを、失敗した場合にFALSEを返します。

例

以下の例では、サーバー上のファイル「demo.txt」をダウンロードし、ローカルファイル「new.txt」に保存します。

<?php
    $ftp_server = "192.168.0.4";
    $ftp_user = "amit";
    $ftp_pass = "tywg61gh";

    $con = ftp_connect($ftp_server) or die("$ftp_server に接続できませんでした");
    $login = ftp_login($con, $ftp_user, $ftp_pass);

    $my_serverfile = "demo.txt";
    $my_file = "new.txt";

    // ローカルファイルを書き込みモードで開く
    $file_pointer = fopen($my_file, "w");

    if (ftp_fget($con, $file_pointer, $my_serverfile, FTP_ASCII, 0)) {
        echo "ローカルファイルに書き込みました！";
    } else {
        echo "サーバーファイルのダウンロード中にエラーが発生しました！";
    }

    ftp_close($con);
    fclose($file_pointer);
?>

ポイント

転送モードには、テキストファイル向けのFTP_ASCIIと、画像や実行ファイルなどあらゆる種類のファイルに対応できるFTP_BINARYがあります。データ破損を防ぐため、特別な理由がない限りFTP_BINARYの使用が推奨されます。また、処理が完了したら必ずftp_close()でFTP接続を閉じ、fclose()でファイルポインタを解放しましょう。