PHP中使用ftp_nlist()获取文件列表返回null的排查方法

我正在开发一个从指定目录获取文件列表的PHP函数，但ftp_nlist()的返回结果始终为null。已确认目录权限正确，也尝试关闭了防火墙，代码运行在CentOS服务器上，请问还可以进行哪些排查操作？

我的实现代码 #

function getFiles($Directory){

    $ftp_server = "123.123.123.123";
    $ftp_user = "User";
    $ftp_pass = "Password";
    $ftp_dir = "../magazines/"; //我也试过绝对路径

    $conn_id = ftp_connect($ftp_server);
    $login_result = ftp_login($conn_id, $ftp_user, $ftp_pass);

    if ((!$conn_id) || (!$login_result)) {
        die("连接错误");
    }

    //ftp_set_option($conn_id, FTP_USEPASVADDRESS, false);  //我试过这个
    ftp_pasv($conn_id, true);   //我也试过false

    $directory = $ftp_dir . $Directory;
    $files = ftp_nlist($conn_id, $directory);

    if ($files) {
        //执行操作...
    } else {
        ftp_close($conn_id);
        return "未找到文件。";
    }
}

可进行的排查操作 #

• 开启PHP错误排查：在代码开头添加error_reporting(E_ALL); ini_set('display_errors', 1);，或者直接查看CentOS服务器上的PHP错误日志（通常路径为/var/log/php-fpm/或/var/log/httpd/），查看是否有未捕获的FTP相关错误。
• 验证目标路径真实性：用FTP客户端（如FileZilla）手动登录服务器，检查$ftp_dir . $Directory拼接后的路径是否存在，注意FTP服务器的根目录可能和系统根目录不一致，部分服务器会将用户限制在自家目录下。
• 检查FTP被动模式端口配置：如果服务器用的是vsftpd，查看/etc/vsftpd/vsftpd.conf中的pasv_min_port和pasv_max_port配置，确认这些端口在服务器端未被占用，即使关闭了防火墙，也需确保端口范围设置合理。
• 替换函数测试：用ftp_rawlist()代替ftp_nlist()执行列表获取，如果它也返回null，说明问题集中在连接或权限层面；如果能返回数据，可能是ftp_nlist()的解析异常。
• 手动验证用户权限：用当前FTP账号登录客户端，尝试手动列出目标目录内容，确认用户确实拥有该目录的读取权限，避免服务器的chroot限制导致路径超出访问范围。
• 确认连接状态与当前目录：在登录成功后添加echo ftp_pwd($conn_id);，查看FTP连接的当前工作目录，排查路径拼接是否错误。
• 使用完整绝对路径：通过FTP客户端获取当前目录的绝对路径，替换代码中的相对路径，比如服务器根目录对应/home/ftpuser/，那目标路径应为/magazines/而非../magazines/。
• 检查PHP FTP扩展：在终端执行php -m | grep ftp，确认FTP扩展已安装启用，若未安装，执行yum install php-ftp（根据PHP版本调整命令）安装扩展。

内容的提问来源于stack exchange，提问作者Alberto Muñoz Sánchez