中文(繁體)
中文(繁體)
在使用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 程序更加穩定高效。如果你也遇到類似情況，不妨逐條排查，找到根因後對症下藥。
