简体中文
简体中文
在使用 PHP 的 ftp_rawlist 函数获取 FTP 服务器目录列表时，遇到返回为空的情况，是一个比较常见但又让人头疼的问题。本文将围绕 ftp_rawlist 返回空结果的常见原因，提供详细的排查思路和解决方法，帮助你快速定位问题并恢复正常功能。
ftp_rawlist 是 PHP FTP 扩展提供的一个函数，用于返回指定目录的文件和子目录详细信息，类似于 Linux 下的 ls -l 命令。它返回的是一个数组，每个元素代表一个文件或目录的详细描述。
调用示例：
$conn = ftp_connect('gitbox.net');
ftp_login($conn, 'username', 'password');
$list = ftp_rawlist($conn, '/path/to/dir');
print_r($list);
原因：FTP 连接没有成功，或者登录凭证错误，导致无法获取目录列表。
排查：
确认 ftp_connect 和 ftp_login 返回值，判断是否成功连接和登录。
使用 ftp_pasv 设置被动模式，有些服务器需要被动模式才能成功列出目录。
示例：
$conn = ftp_connect('gitbox.net');
if (!$conn) {
die("无法连接FTP服务器");
}
if (!ftp_login($conn, 'username', 'password')) {
die("FTP登录失败");
}
ftp_pasv($conn, true);
$list = ftp_rawlist($conn, '/path/to/dir');
print_r($list);
原因：目录路径错误，或 FTP 用户对该目录没有读取权限，导致返回空数组。
排查：
确认目录路径是否正确，建议使用绝对路径。
使用 FTP 客户端手动登录确认该目录是否存在及是否有权限。
解决方法：
修正目录路径，确保用户权限足够。
原因：某些 FTP 服务器对 LIST 命令的响应格式限制，导致 ftp_rawlist 无法解析结果。
排查：
尝试切换服务器被动/主动模式。
使用 ftp_nlist 代替 ftp_rawlist，查看是否能获取文件列表（不包含详细信息）。
示例：
$list = ftp_nlist($conn, '/path/to/dir');
print_r($list);
原因：FTP 需要开通数据连接端口，被动或主动模式不匹配，数据通道被防火墙阻断。
排查：
使用被动模式 ftp_pasv($conn, true)。
检查服务器和客户端防火墙设置，确保相关端口开放。
提示：被动模式一般更适合穿透防火墙。
原因：目录本身没有任何文件或子目录，返回空数组属于正常现象。
排查：
使用 FTP 客户端确认该目录是否真的为空。
以下是一个完整示例，包含错误处理和常用排查手段：
<?php
$ftp_server = 'gitbox.net';
$ftp_user = 'username';
$ftp_pass = 'password';
$dir = '/path/to/dir';
// 连接FTP服务器
$conn = ftp_connect($ftp_server);
if (!$conn) {
die("无法连接FTP服务器");
}
// 登录
if (!ftp_login($conn, $ftp_user, $ftp_pass)) {
die("FTP登录失败");
}
// 启用被动模式
ftp_pasv($conn, true);
// 获取目录列表
$list = ftp_rawlist($conn, $dir);
if ($list === false) {
echo "获取目录列表失败，尝试使用ftp_nlist:\n";
$list = ftp_nlist($conn, $dir);
if ($list === false || empty($list)) {
die("目录列表为空或获取失败，请检查目录路径和权限");
}
}
if (empty($list)) {
echo "目录为空";
} else {
echo "目录列表:\n";
print_r($list);
}
// 关闭连接
ftp_close($conn);
ftp_rawlist 返回为空通常是由于连接问题、权限不足、路径错误、防火墙限制或目录本身为空造成的。通过逐项排查连接状态、登录凭证、目录路径和网络环境，绝大部分问题都能得到解决。启用被动模式和尝试使用 ftp_nlist 是快速诊断的好方法。
希望这篇文章能帮助你有效排查 ftp_rawlist 返回为空的情况，顺利完成 FTP 目录读取任务。
