为什么FileZilla可连接FTP但PHP Laravel中FTP连接失败？

故障根因说明 #

• 首先直接废弃SFTP驱动的尝试：SFTP是基于SSH的文件传输协议，和你服务器使用的FTPS协议完全无关，990端口是隐式TLS FTPS的默认端口，不是SFTP端口，所以必然连接失败。
• 之前原生ftp_ssl_connect和Laravel默认FTP驱动失败的核心原因：Laravel 5.6依赖的Flysystem 1.x版本默认FTP驱动适配的是显式TLS FTPS，而你服务器要求的是隐式TLS，二者连接逻辑完全不同：显式TLS先连接明文端口再发起TLS升级，隐式TLS在连接建立时就直接走TLS加密，你之前的配置没有适配这个逻辑。

逐步排查与修复方案 #

1. 确认基础依赖 #

首先确认你的Ubuntu环境安装了必需的PHP扩展，执行以下命令校验：

php -m | grep -E 'ftp|openssl'

如果输出中没有ftp或openssl，安装对应PHP版本的扩展即可，例如PHP7.2版本执行：

sudo apt install php7.2-ftp php7.2-openssl

安装完成后重启PHP-FPM服务生效。

2. 修正Laravel FTP驱动配置 #

修改config/filesystems.php中的FTP磁盘配置，适配隐式TLS逻辑：

'ftp' => [
    'driver' => 'ftp',
    'host' => 'ssl://' . env('FTP_HOST'), // 加ssl://前缀启用隐式TLS连接
    'username' => env('FTP_USER'),
    'password' => env('FTP_PASSWORD'),
    'port' => env('FTP_PORT', 990),
    'ssl' => true,
    'passive' => true, // 显式开启被动模式，和FileZilla连接逻辑对齐
    'timeout' => 60,
    // 如果FTP服务器使用自签名证书，添加以下上下文配置跳过证书校验
    'context' => [
        'ssl' => [
            'verify_peer' => false,
            'verify_peer_name' => false,
            'allow_self_signed' => true,
        ]
    ],
],

配置更新后执行php artisan config:clear清空配置缓存。

3. 原生代码测试排除框架问题 #

如果修改配置后还是连接失败，先运行独立的原生PHP测试代码，排除框架层影响：

<?php
$host = 'ssl://替换为你的FTP域名/IP';
$port = 990;
$username = '替换为你的FTP用户名';
$password = '替换为你的FTP密码';

// 建立隐式TLS连接
$ftpConn = ftp_ssl_connect($host, $port, 60);
if (!$ftpConn) {
    die("连接失败，请检查域名、端口和网络");
}

// 登录
$loginRes = ftp_login($ftpConn, $username, $password);
if (!$loginRes) {
    die("登录失败，请检查用户名密码");
}

// 开启被动模式
ftp_pasv($ftpConn, true);

// 测试列目录验证连接正常
var_dump(ftp_nlist($ftpConn, '.'));

// 关闭连接
ftp_close($ftpConn);

如果该代码能正常输出FTP根目录文件列表，说明网络、账号配置都正常，问题出在Laravel配置层，再回头核对配置项即可。

4. 网络与防火墙排查 #

• 确认PHP运行用户（通常是www-data）没有出站990端口的限制，执行sudo ufw status查看防火墙规则，没有放行的话执行sudo ufw allow out 990/tcp添加规则。
• 确认FTP服务器的被动模式端口范围已经在你本地和服务器端放行：FTPS被动模式会使用随机高位端口传输数据，这些端口被拦截会出现连接成功但上传超时的问题，可以在FileZilla的连接日志中查看对应端口范围，同步放行即可。

5. 开启错误日志定位细节 #

如果以上步骤都未解决，临时开启PHP错误显示：修改php.ini中error_reporting = E_ALL、display_errors = On，重启PHP-FPM后再运行连接代码，根据具体的报错信息（比如证书校验失败、连接被拒绝等）针对性处理。

内容的提问来源于stack exchange，提问作者James_Griffiths