函数名:ftp_nlist()
适用版本:PHP 4, PHP 5, PHP 7
用法:ftp_nlist ( resource $ftp_stream , string $directory ) : array
函数描述:ftp_nlist() 函数返回指定目录中的文件和目录列表。该函数使用 FTP 传输协议。
参数:
- $ftp_stream:FTP 连接资源。
- $directory:要获取文件和目录列表的目录路径。
返回值:返回一个包含目录中文件和目录的数组,如果出错则返回 FALSE。
示例:
// 连接到 FTP 服务器
$ftp_server = 'ftp.example.com';
$ftp_user = 'username';
$ftp_pass = 'password';
$ftp_conn = ftp_connect($ftp_server);
$login_result = ftp_login($ftp_conn, $ftp_user, $ftp_pass);
// 获取指定目录的文件和目录列表
$directory = '/public_html';
$file_list = ftp_nlist($ftp_conn, $directory);
// 打印文件和目录列表
if ($file_list) {
foreach ($file_list as $file) {
echo $file . "<br>";
}
} else {
echo "获取文件和目录列表失败";
}
// 关闭 FTP 连接
ftp_close($ftp_conn);
注意事项:
- 在使用 ftp_nlist() 函数之前,需要先通过 ftp_connect() 和 ftp_login() 函数建立 FTP 连接。
- 请确保传递给函数的目录路径是正确的,并且有相应的权限访问。
- 如果函数返回 FALSE,可能是由于连接失败、登录失败或目录不存在等原因,可以通过调用 ftp_get_error() 函数获取详细的错误信息。