PHP ftp_nb_get() 関数

定義と使用方法

ftp_nb_get() 関数は FTP サーバーからファイルを取得しローカルファイルに書き込む(ノンブロッキング)。

この関数は以下の値を返します:

  • FTP_FAILED (送信/受信失敗)
  • FTP_FINISHED (送信/受信完了)
  • FTP_MOREDATA (送信/受信中)

および ftp_get() 異なる、この関数は非同期にファイルを取得します。これは、プログラムがファイル転送中に他の操作を実行できることを意味します。

文法

ftp_nb_get(ftp_connection,local,remote,mode,resume)
パラメータ 説明
ftp_connection 必須。使用する FTP 接続(FTP 接続の識別子)を指定します。
local 必須。コピー先のローカルファイルを指定します。既存のファイルがある場合、それが上書きされます。
remote 必須。コピーを行うリモートファイルのパスを指定します。
mode

必須。転送モードを指定します。可能な値は:

  • FTP_ASCII
  • FTP_BINARY
resume 必須。リモートファイル内のコピーを開始する場所を指定します。デフォルトは 0 です。

この例では、テキストを "source.txt" から "target.txt" にコピーします:

<?php
$conn = ftp_connect("ftp.testftp.com") or die("Could not connect");
ftp_login($conn,"admin","ert456");
ftp_nb_get($conn,"target.txt","source.txt",FTP_ASCII);
ftp_close($conn);
?>