ftp_nb_get

从 FTP 服务器上获取文件并写入本地文件(non-blocking) (PHP 4 >= 4.3.0, PHP 5)
bool ftp_nb_get ( resource ftp_stream, string local_file, string remote_file, int mode [, int resumepos] )

说明

ftp_nb_get() 函数用来获取参数 remote_file 指定的的远程文件,并保存到由参数 local_file 指定的本地文件。传输模式参数 mode 只能为 FTP_ASCII (文本模式) 或 FTP_BINARY (二进制模式) 两种。与 ftp_get() 函数不同的是,此函数上传文件的时候采用的是异步传输模式,也就意味着在文件传送的过程中,你的程序可以继续干其它的事情。

返回 FTP_FAILEDFTP_FINISHEDFTP_MOREDATA

例 639. ftp_nb_get() 实例

<?php
// &#24320;&#22987;&#19979;&#36733;
$ret = ftp_nb_get($my_connection, "test", "README", FTP_BINARY);
while (
$ret == FTP_MOREDATA) {

 
// &#36825;&#37324;&#21487;&#20197;&#25554;&#20837;&#20854;&#23427;&#20195;&#30721;
 
echo ".";

 
// &#32487;&#32493;&#19979;&#36733;...
 
$ret = ftp_nb_continue ($my_connection);
}
if (
$ret != FTP_FINISHED) {
  echo
"&#19979;&#36733;&#20013;&#20986;&#38169;...";
  exit(
1);
}
?>

例 640. 使用 ftp_nb_get() 函数断线续传

<?php
// &#24320;&#22987;
$ret = ftp_nb_get ($my_connection, "test", "README", FTP_BINARY,
                     
filesize("test"));
// &#25110;: $ret = ftp_nb_get ($my_connection, "test", "README",
//                           FTP_BINARY, FTP_AUTORESUME);
while ($ret == FTP_MOREDATA) {

 
// &#21487;&#20197;&#25554;&#20837;&#20854;&#23427;&#20195;&#30721;
 
echo ".";

 
// &#32487;&#32493;&#20256;&#36865;...
 
$ret = ftp_nb_continue ($my_connection);
}
if (
$ret != FTP_FINISHED) {
  echo
"&#19979;&#36733;&#20986;&#38169;...";
  exit(
1);
}
?>

例 641.  用 ftp_nb_get() 在 100 的位置断线续传并存为 "newfile"

// &#31105;&#27490;&#33258;&#21160;&#25628;&#23547;
ftp_set_option ($my_connection, FTP_AUTOSEEK, FALSE);

// &#24320;&#22987;
$ret = ftp_nb_get ($my_connection, "newfile", "README", FTP_BINARY, 100);
while (
$ret == FTP_MOREDATA) {

  ...

 
// &#32487;&#32493;&#19979;&#36733;...
 
$ret = ftp_nb_continue ($my_connection);
}
?>

在上边的例子中,"newfile" 文件比服务器上的文件 "README" 要小 100 字节。这是因为我们是从文件的偏移量 100 处开始读取的,如果没有禁止 FTP_AUTOSEEK,则 "newfile" 的前 100 字节将会是 '\0'

参见 ftp_nb_fget()ftp_nb_continue()ftp_get()ftp_fget()