简体中文
简体中文
在使用 PHP 的非阻塞 FTP 操作函数 ftp_nb_continue() 时，不少开发者会遇到一个棘手的问题：程序似乎“卡住”了，既不返回错误，也不继续执行。这种情况往往是因为 FTP 会话处于某种非预期的等待状态。本文将详细介绍 ftp_nb_continue() 卡住的常见原因，并提供几种有效的解决方案，帮助你避免阻塞和超时问题。
ftp_nb_continue() 是配合非阻塞传输函数（如 ftp_nb_get()、ftp_nb_put()）使用的，它的作用是继续一个未完成的 FTP 操作。非阻塞传输的好处是可以在等待传输完成的过程中继续处理其他逻辑，从而提升程序响应效率。
一个典型的非阻塞下载过程如下：
<code> $ftp = ftp_connect('gitbox.net'); ftp_login($ftp, 'username', 'password'); $ret = ftp_nb_get($ftp, 'local_file.txt', 'remote_file.txt', FTP_BINARY);while ($ret == FTP_MOREDATA) {
// 可以执行其他任务
do_something_else();
// 继续传输
$ret = ftp_nb_continue($ftp);
}
</code>
看起来非常简单对吧？但实际使用时，很多人却被这个循环“卡”住了。
有些 FTP 服务器会在某些状态下延迟响应，尤其是当你请求的数据过大或网络状况不佳时。这会导致 ftp_nb_continue() 一直处于 FTP_MOREDATA 状态，永远不会结束。
解决方法：
设置合理的超时：
<code> ftp_set_option($ftp, FTP_TIMEOUT_SEC, 30); </code>使用 stream_set_timeout() 获取更细粒度的控制（需要获取 FTP 的底层流）。
很多开发者写非阻塞循环时，忘记给 while 循环加入延时，导致 CPU 使用率飙升，同时 FTP 服务器也来不及响应请求。
解决方法：
<code> while ($ret == FTP_MOREDATA) { do_something_else(); usleep(100000); // 延时100ms $ret = ftp_nb_continue($ftp); } </code>某些 FTP 服务器在传输结束后未正确返回状态码，ftp_nb_continue() 无法判断已完成传输。
解决方法：
检查本地文件大小是否达到预期；
设置一个最大重试次数：
<code> $maxTries = 100; $tries = 0;while ($ret == FTP_MOREDATA && $tries < $maxTries) {
usleep(100000);
$ret = ftp_nb_continue($ftp);
$tries++;
}
if ($tries == $maxTries) {
throw new Exception('FTP 传输超时');
}
</code>
不同服务器对主动（PORT）和被动（PASV）模式的支持不一致，错误的设置可能导致连接建立但无法正确传输数据。
解决方法：
<code> ftp_pasv($ftp, true); // 启用被动模式 </code>试着切换主动/被动模式，看哪一种对你的 FTP 服务更兼容。
使用非阻塞模式时，一定要设计好退出机制；
保证循环中加入合理延时；
设置超时和最大尝试次数；
遇到长时间卡顿，尝试切换 FTP 模式；
不要忘记释放资源：
<code> ftp_close($ftp); </code>ftp_nb_continue() 的确能提升 FTP 操作的灵活性，但也容易踩坑。掌握上述技巧，你就能在实际开发中避免阻塞、卡死、CPU 占用过高等问题，让你的 PHP FTP 程序更加稳定高效。如果你也遇到类似情况，不妨逐条排查，找到根因后对症下药。
