怎麼用ftp_nlist 函數輕鬆獲取FTP服務器上的文件列表？

M66 2025-07-10

在PHP中， ftp_nlist是一個非常有用的函數，可以幫助我們輕鬆地獲取FTP服務器上指定目錄的文件和目錄列表。它可以用於檢查FTP服務器上的文件內容，方便我們進行文件操作，如下載、刪除或上傳文件。今天我們將深入了解如何使用這個函數，並展示一個簡單的實例來幫助你快速上手。

ftp_nlist函數簡介

ftp_nlist函數用於獲取FTP服務器上指定目錄中的文件和目錄的名稱。該函數返回一個包含文件名的數組，注意它只會列出當前目錄下的文件或目錄，並不會列出子目錄中的內容。

函數原型：

 <span><span><span class="hljs-keyword">array</span></span><span> </span><span><span class="hljs-title function_ invoke__">ftp_nlist</span></span><span> ( resource </span><span><span class="hljs-variable">$ftp_stream</span></span><span> , </span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$directory</span></span><span> )
</span></span>

$ftp_stream ：FTP連接的資源，通常通過ftp_connect或ftp_login獲得。
$directory ：要獲取文件列表的目錄，可以是相對路徑或絕對路徑。

返回值：

該函數返回一個包含FTP服務器上指定目錄中的所有文件和目錄名稱的數組。如果發生錯誤，返回FALSE 。

使用ftp_nlist獲取文件列表的步驟

1. 連接到FTP服務器

首先，我們需要建立一個與FTP服務器的連接。使用ftp_connect函數連接到FTP服務器，然後用ftp_login進行登錄認證。

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$ftp_server</span></span><span> = </span><span><span class="hljs-string">"ftp.example.com"</span></span><span>;
</span><span><span class="hljs-variable">$ftp_username</span></span><span> = </span><span><span class="hljs-string">"your_username"</span></span><span>;
</span><span><span class="hljs-variable">$ftp_password</span></span><span> = </span><span><span class="hljs-string">"your_password"</span></span><span>;

</span><span><span class="hljs-comment">// 連接到FTP伺服器</span></span><span>
</span><span><span class="hljs-variable">$ftp_conn</span></span><span> = </span><span><span class="hljs-title function_ invoke__">ftp_connect</span></span><span>(</span><span><span class="hljs-variable">$ftp_server</span></span><span>) </span><span><span class="hljs-keyword">or</span></span><span> </span><span><span class="hljs-keyword">die</span></span><span>(</span><span><span class="hljs-string">"无法連接到FTP伺服器"</span></span><span>);

</span><span><span class="hljs-comment">// 登入</span></span><span>
</span><span><span class="hljs-variable">$login</span></span><span> = </span><span><span class="hljs-title function_ invoke__">ftp_login</span></span><span>(</span><span><span class="hljs-variable">$ftp_conn</span></span><span>, </span><span><span class="hljs-variable">$ftp_username</span></span><span>, </span><span><span class="hljs-variable">$ftp_password</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (!</span><span><span class="hljs-variable">$login</span></span><span>) {
    </span><span><span class="hljs-keyword">die</span></span><span>(</span><span><span class="hljs-string">"登入失败！"</span></span><span>);
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

2. 獲取文件列表

使用ftp_nlist函數來獲取指定目錄的文件和目錄列表。

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$directory</span></span><span> = </span><span><span class="hljs-string">"/path/to/directory"</span></span><span>; </span><span><span class="hljs-comment">// 需要列出文件的目錄</span></span><span>

</span><span><span class="hljs-comment">// 獲取文件列表</span></span><span>
</span><span><span class="hljs-variable">$file_list</span></span><span> = </span><span><span class="hljs-title function_ invoke__">ftp_nlist</span></span><span>(</span><span><span class="hljs-variable">$ftp_conn</span></span><span>, </span><span><span class="hljs-variable">$directory</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$file_list</span></span><span> === </span><span><span class="hljs-literal">false</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"无法獲取文件列表"</span></span><span>;
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"文件列表：\n"</span></span><span>;
    </span><span><span class="hljs-keyword">foreach</span></span><span> (</span><span><span class="hljs-variable">$file_list</span></span><span> </span><span><span class="hljs-keyword">as</span></span><span> </span><span><span class="hljs-variable">$file</span></span><span>) {
        </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$file</span></span><span> . </span><span><span class="hljs-string">"\n"</span></span><span>;
    }
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

在上面的代碼中， ftp_nlist將返回一個數組，數組中的每個元素都是該目錄下的一個文件或目錄名。我們可以用foreach循環遍歷這個數組並輸出每個文件或目錄的名稱。

3. 關閉FTP連接

操作完成後，別忘了關閉FTP連接。

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 關閉FTP連接</span></span><span>
</span><span><span class="hljs-title function_ invoke__">ftp_close</span></span><span>(</span><span><span class="hljs-variable">$ftp_conn</span></span><span>);
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

常見問題與註意事項

路徑問題： ftp_nlist返回的文件列表是相對於指定路徑的。如果你傳入的是相對路徑，確保你提供的路徑是正確的。如果你傳入的是絕對路徑，確保服務器端的文件結構與你所提供的路徑匹配。
隱藏文件：在某些FTP服務器上，隱藏文件（以點號.開頭的文件）可能不會被列出。你可以通過使用ftp_rawlist來獲取更多的文件信息，包括隱藏文件。
字符編碼：如果FTP服務器的文件名包含非ASCII字符（如中文），你可能需要在顯示之前對文件名進行編碼轉換。

小結

ftp_nlist函數是一個簡單而高效的工具，可以幫助開發者獲取FTP服務器上的文件和目錄列表。通過建立連接、調用ftp_nlist獲取文件列表、遍歷並輸出結果，你就可以輕鬆地管理和操作FTP服務器上的文件。

通過本文的講解，你可以快速掌握如何使用該函數，並根據需要靈活地應用到自己的項目中。希望這篇文章對你有所幫助！