PHP:ftp_nb_get()的用法

ftp_nb_get

(PHP 4 >= 4.3.0, PHP 5)

ftp_nb_get — 从 FTP 服务器上获取文件并写入本地文件（non-blocking）

<h3>说明</h3>
 bool <strong>ftp_nb_get</strong>
  ( resource <code>$ftp_stream</code>
 , string <code>$local_file</code>
 , string <code>$remote_file</code>
 , int <code>$mode</code>
 [, int <code>$resumepos</code>
] )
<p>
 <strong>ftp_nb_get()</strong> 函数用来获取参数 <code>remote_file</code>
 指定的的远程文件，并保存到由参数 <code>local_file</code>
 指定的本地文件。传输模式参数
 <code>mode</code> 只能为 <strong><code>FTP_ASCII</code></strong> (文本模式) 或 <strong><code>FTP_BINARY</code></strong>
 (二进制模式) 两种。与 ftp_get()
 函数不同的是，此函数上传文件的时候采用的是异步传输模式，也就意味着在文件传送的过程中，你的程序可以继续干其它的事情。
</p>
<p>
 返回 <strong><code>FTP_FAILED</code></strong>，<strong><code>FTP_FINISHED</code></strong>
 或 <strong><code>FTP_MOREDATA</code></strong>。
</p>
<p>
  <p><strong>Example #1 <strong>ftp_nb_get()</strong> 实例</strong></p>

<?php
// 开始下载
$ret = ftp_nb_get($my_connection, "test", "README", FTP_BINARY);
while ($ret == FTP_MOREDATA) {

   // 这里可以插入其它代码
   echo ".";

   // 继续下载...
   $ret = ftp_nb_continue ($my_connection);
}
if ($ret != FTP_FINISHED) {
   echo "下载中出错...";
   exit(1);
}
?>

  <p><strong>Example #2 使用 <strong>ftp_nb_get()</strong> 函数断线续传</strong></p>

<?php
// 开始
$ret = ftp_nb_get ($my_connection, "test", "README", FTP_BINARY,
                      filesize("test"));
// 或: $ret = ftp_nb_get ($my_connection, "test", "README",
//                           FTP_BINARY, FTP_AUTORESUME);
while ($ret == FTP_MOREDATA) {

   // 可以插入其它代码
   echo ".";

   // 继续传送...
   $ret = ftp_nb_continue ($my_connection);
}
if ($ret != FTP_FINISHED) {
   echo "下载出错...";
   exit(1);
}
?>

  <p><strong>Example #3
   用 <strong>ftp_nb_get()</strong> 在 100 的位置断线续传并存为 &quot;newfile&quot;
  </strong></p>

// 禁止自动搜寻
ftp_set_option ($my_connection, FTP_AUTOSEEK, FALSE);

// 开始
$ret = ftp_nb_get ($my_connection, "newfile", "README", FTP_BINARY, 100);
while ($ret == FTP_MOREDATA) {

   ...

   // 继续下载...
   $ret = ftp_nb_continue ($my_connection);
}

</p>
<p>
 在上边的例子中，&quot;newfile&quot; 文件比服务器上的文件
 &quot;README&quot; 要小 100 字节。这是因为我们是从文件的偏移量 100
 处开始读取的，如果没有禁止 <strong><code>FTP_AUTOSEEK</code></strong>，则
 &quot;newfile&quot; 的前 100
 字节将会是 &#039;&#039;。
</p>
<p>
 参见 ftp_nb_fget()，ftp_nb_continue()，ftp_get()
 和 ftp_fget()。
</p>