PHP ftp_nb_get() 函数

定义和用法

ftp_nb_get() 函数从 FTP 服务器上获取文件并写入本地文件 (non-blocking)。

该函数返回下列值:

  • FTP_FAILED (send/receive failed)
  • FTP_FINISHED (send/receive completed)
  • FTP_MOREDATA (send/receive in progress)

ftp_get() 不同,该函数异步地获取文件。这意味着您的程序可以在文件传输时执行其他操作。

语法

  1. 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" 中:

    1. <?php
    2. $conn = ftp_connect("ftp.testftp.com") or die("Could not connect");
    3. ftp_login($conn,"admin","ert456");
    4.  
    5. ftp_nb_get($conn,"target.txt","source.txt",FTP_ASCII);
    6.  
    7. ftp_close($conn);
    8. ?>