PHP 手册
后退 |  | 前进

# ftp_nb_get

(PHP 4 >= 4.3.0, PHP 5)

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

## 说明

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_FAILED`，`FTP_FINISHED` 或 `FTP_MOREDATA`。

例子 1. ftp_nb_get() 实例

`<?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); } ?>`

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

`<?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); } ?>`

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

`// 禁止自动搜寻 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); }`

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

参见 ftp_nb_fget()，ftp_nb_continue()，ftp_get() 和 ftp_fget()。

后退 | 起点 | 前进
ftp_nb_fput | 上一级 | ftp_nb_put