PHPのftp_nb_fput()関数の使い方：非同期でFTPサーバーへファイルをアップロードする方法

PHPのftp_nb_fput()関数は、開いているローカルファイルからデータを読み込み、FTPサーバー上のファイルとしてアップロード（保存）します。

この関数は非同期（ノンブロッキング）で動作するのが特徴です。通常のftp_fput()関数はアップロードが完了するまでスクリプトの処理が停止しますが、ftp_nb_fput()を使用すると、アップロードの進行中でも他の処理を並行して実行できます。

構文

ftp_nb_fput(con, remote_file, open_file, transfer_mode, beg_pos);

パラメータ

• con − ftp_connect()で取得したFTP接続リソース

• remote_file − アップロード先となるサーバー上のファイルパス

• open_file − fopen()などで開いたローカルファイルのポインタ

• transfer_mode − データ転送モード。以下のいずれかを指定します。

  - FTP_ASCII：テキストファイル向けのアスキーモード
  - FTP_BINARY：画像や実行ファイルなど向けのバイナリモード

• beg_pos − アップロードを開始するファイル内の位置（省略可能）。途中からの再開などに利用できます。

戻り値

ftp_nb_fput()関数は、以下のいずれかの値を返します。

• FTP_FAILED − 送受信に失敗した

• FTP_FINISHED − 送受信が正常に完了した

• FTP_MOREDATA − 送受信が進行中である

戻り値がFTP_MOREDATAの間は、ftp_nb_continue()関数を呼び出して転送を継続させる必要があります。

使用例

以下は、ローカルファイル「new.txt」をFTPサーバーの「demo.txt」として非同期にアップロードする例です。

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

    // FTPサーバーに接続
    $con = ftp_connect($ftp_server) or die("$ftp_server に接続できませんでした");

    // ログイン
    $login = ftp_login($con, $ftp_user, $ftp_pass);

    $my_serverfile = "demo.txt";  // アップロード先のファイル名
    $local_file = "new.txt";      // ローカルのファイル名

    // ローカルファイルを読み込みモードで開く
    $file_pointer = fopen($local_file, "r");

    // 非同期でアップロードを開始
    $c = ftp_nb_fput($con, $my_serverfile, $file_pointer, FTP_BINARY);

    // 転送が完了するまで継続
    while ($c == FTP_MOREDATA) {
        $c = ftp_nb_continue($con);
        // この間に進捗表示など別の処理を実行できる
    }

    if ($c != FTP_FINISHED) {
        echo "ファイルのアップロード中にエラーが発生しました！";
        exit(1);
    }

    // 接続を閉じる
    ftp_close($con);
?>

ポイント

• 大きなファイルを扱う場合でも、アップロード中にユーザーへの応答やプログレスバーの表示など、他の処理を行えます。

• 転送モードには、テキストファイルならFTP_ASCII、画像や圧縮ファイルなどならFTP_BINARYを指定するのが基本です。

• 処理終了後はftp_close()で必ず接続を閉じましょう。