PHP中ftp_ssl_connect连接成功但ftp_nlist获取文件列表失败求助

核心原因 #

• 端口与连接模式冲突：你用ftp_ssl_connect走的是FTPS（FTP over SSL/TLS）协议，而非远程系统原生要求的SFTP。FTPS被动模式下，远程服务器会返回一个随机数据端口，本地服务器的防火墙、SELinux或AppArmor可能阻止了PHP进程连接这个端口，导致ftp_nlist无法获取数据。
• 进程权限限制：PHP运行进程（比如Apache的httpd、PHP-FPM进程）没有发起出站网络连接到非标准端口的权限，触发了系统的Permission denied警告。
• 协议适配差异：虽然专业FTP客户端能正常使用FTPS连接，但PHP的ftp扩展对FTPS被动模式的兼容性可能不如客户端，且远程服务器的FTPS配置可能对端口范围有严格限制。

解决步骤 #

1. 排查并开放被动模式端口范围 #

• 联系远程服务器管理员，确认FTPS被动模式开放的端口范围（例如10000-20000）。
• 在本地服务器上开放对应端口的出站权限：
  • 若用firewalld：

    firewall-cmd --add-port=10000-20000/tcp --permanent
    firewall-cmd --reload
    

  • 若用iptables：

    iptables -A OUTPUT -p tcp --dport 10000:20000 -j ACCEPT
    service iptables save
    

2. 调整系统安全策略（SELinux/AppArmor） #

• SELinux临时测试：执行setenforce 0关闭SELinux，重新运行代码。若问题解决，需要永久配置：

  setsebool -P httpd_can_network_connect on
  

  （注：如果PHP运行在PHP-FPM下，需调整对应进程的SE布尔值）
• AppArmor配置：找到PHP的AppArmor配置文件（通常在/etc/apparmor.d/下），添加允许连接远程端口的规则：

  network tcp,
  

  然后重启AppArmor服务：service apparmor restart

3. 尝试切换主动模式 #

• 关闭被动模式，改用主动模式连接：

  $conn = ftp_ssl_connect('远程服务器地址', 22);
  ftp_login($conn, '用户名', '密码');
  ftp_pasv($conn, false); // 关闭被动模式
  $files = ftp_nlist($conn, '/');
  print_r($files);
  

  注意：主动模式需要本地服务器开放20端口的入站权限，若本地有NAT或防火墙，这种方式可能不适用。

4. 使用纯PHP库替代（无需ssh2扩展） #

推荐使用phpseclib，纯PHP实现的SFTP/FTPS库，无需安装系统扩展：

• 通过Composer安装：

  composer require phpseclib/phpseclib
  

• SFTP连接示例（符合远程系统原生要求，优先选择）：

  require 'vendor/autoload.php';
  use phpseclib3\Net\SFTP;
  
  $sftp = new SFTP('远程服务器地址', 22);
  if (!$sftp->login('你的用户名', '你的密码')) {
      die('登录失败');
  }
  // 获取目标目录文件列表
  print_r($sftp->nlist('/目标目录'));
  

• FTPS连接示例：

  require 'vendor/autoload.php';
  use phpseclib3\Net\FTP;
  
  $ftp = new FTP('远程服务器地址', 22);
  $ftp->enableTLS();
  if (!$ftp->login('你的用户名', '你的密码')) {
      die('登录失败');
  }
  $ftp->pasv(true);
  print_r($ftp->nlist('/目标目录'));
  

内容的提问来源于stack exchange，提问作者Faye D.