ftp_nb_put
(PHP 4 >= 4.3.0, PHP 5)
ftp_nb_put — 存储一个文件至 FTP 服务器(non-blocking)
<h3>说明</h3>
int <strong>ftp_nb_put</strong>
( resource <code>$ftp_stream</code>
, string <code>$remote_file</code>
, string <code>$local_file</code>
, int <code>$mode</code>
[, int <code>$startpos</code>
] )
<p>
<strong>ftp_nb_put()</strong> 函数用来把本地文件 <code>local_file</code>
存储到 FTP 服务器上由 <code>remote_file</code> 参数指定的路径。传输模式参数
<code>mode</code> 只能为 <strong><code>FTP_ASCII</code></strong> (文本模式) 或 <strong><code>FTP_BINARY</code></strong>
(二进制模式) 两种。与函数 ftp_put()
不同的是,此函数上传文件的时候采用的是异步传输模式,也就意味着在文件传送的过程中,你的程序可以继续干其它的事情。
</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_put()</strong> 实例</strong></p>
<?php
// 开始上传
$ret = ftp_nb_put($my_connection, "test.remote", "test.local", 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_put()</strong> 来断线续传</strong></p>
<?php
// 开始
$ret = ftp_nb_put ($my_connection, "test.remote", "test.local",
FTP_BINARY, ftp_size("test.remote"));
// 或: $ret = ftp_nb_put ($my_connection, "test.remote", "test.local",
// FTP_BINARY, FTP_AUTORESUME);
while ($ret == FTP_MOREDATA) {
// 加入其它要执行的代码
echo ".";
// 继续传送...
$ret = ftp_nb_continue ($my_connection);
}
if ($ret != FTP_FINISHED) {
echo "上传文件中发生错误...";
exit(1);
}
?>
</p>
<p>
参见 ftp_nb_fput(),ftp_nb_continue(),ftp_put()
和 ftp_fput()。
</p>