ftp_nlist 函数详解

函数名

ftp_nlist

适用PHP版本

PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8

函数说明

ftp_nlist 函数用于从指定的 FTP 服务器获取文件和目录的列表。它通过列出指定目录内的文件名来返回文件列表，支持带有通配符的目录。

函数语法

ftp_nlist ( resource $ftp_stream , string $directory ) : array

参数

• $ftp_stream (resource): 一个有效的 FTP 流。
• $directory (string): 需要列出文件和目录的路径，支持通配符。

返回值

如果成功，返回一个包含目录中文件名的数组。如果失败，返回 false。

示例

下面是一个使用 ftp_nlist 函数列出 FTP 服务器目录内容的示例代码：

示例代码：

<?php
// 建立与 FTP 服务器的连接
$ftp_server = "ftp.example.com";
$ftp_user_name = "username";
$ftp_user_pass = "password";
<p>// 连接到 FTP 服务器<br>
$conn_id = ftp_connect($ftp_server);</p>
<p>// 登录到 FTP 服务器<br>
$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);</p>
<p>// 获取某个目录的文件列表<br>
$directory = "/public_html";<br>
$file_list = ftp_nlist($conn_id, $directory);</p>
<p>// 检查是否成功获取文件列表<br>
if ($file_list !== false) {<br>
echo "文件列表：\n";<br>
foreach ($file_list as $file) {<br>
echo $file . "\n";<br>
}<br>
} else {<br>
echo "获取文件列表失败！\n";<br>
}</p>
<p>// 关闭 FTP 连接<br>
ftp_close($conn_id);<br>
?><br>

示例代码的说明：

• 首先，使用 ftp_connect 和 ftp_login 连接到 FTP 服务器。
• 然后，使用 ftp_nlist 获取指定目录（在本示例中为 /public_html）中的文件列表。
• 通过遍历返回的文件列表，输出每个文件的名字。
• 最后，关闭与 FTP 服务器的连接。