怎么用 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服务器上的文件。

通过本文的讲解，你可以快速掌握如何使用该函数，并根据需要灵活地应用到自己的项目中。希望这篇文章对你有所帮助！