PHP应用中phpseclib连接SFTP报Invalid Size错误求助

我之前在项目里用phpseclib连接SFTP时也碰到过一模一样的"Invalid Size"报错，结合你的代码和堆栈信息，给你几个实用的排查和解决方向：

1. 优先升级phpseclib版本 #

这个错误在旧版本的phpseclib里比较常见，尤其是2.x及更早的版本，很多协议兼容问题在3.x的稳定版里已经被修复了。你可以把Yii扩展里的phpseclib替换成最新的稳定版（直接覆盖原有类文件即可），再测试连接，大概率能解决问题。

2. 绕开Yii扩展封装，直接用原生phpseclib方法测试 #

有时候Yii的扩展封装可能对参数处理有问题，你可以试试直接实例化phpseclib的类，排除框架层的影响：

// 若Yii未自动加载，手动引入类文件
require_once 'protected/extensions/phpseclib/classes/Net/SSH2.php';
require_once 'protected/extensions/phpseclib/classes/Net/SFTP.php';

$ssh = new Net_SSH2($ftp_server, 8822);
if (!$ssh->login($ftp_username, $ftp_password)) {
    die('登录失败');
}

$sftp = new Net_SFTP($ftp_server, 8822);
$sftp->setSSH2($ssh);

// 测试SFTP操作，比如列出目录
print_r($sftp->nlist());

如果这样能成功连接，那问题就出在Yii扩展的封装逻辑上，你可以调整扩展代码或者直接用原生方法实现。

3. 检查加密算法兼容性 #

服务器的SSH服务可能禁用了phpseclib默认使用的某些加密算法，导致握手时数据解析出错。你可以手动指定兼容的算法：

$sftp = Yii::app()->phpseclib->createSFTP($ftp_server,8822);
// 根据服务器支持的算法调整，以下为示例配置
$sftp->setPreferredAlgorithms([
    'kex' => ['diffie-hellman-group-exchange-sha256'],
    'hostkey' => ['ssh-rsa'],
    'cipher' => ['aes256-ctr']
]);

if (!$sftp->login($ftp_username, $ftp_password)) {
    // 登录失败处理逻辑
}

你可以在本地终端执行ssh -v username@ftp_server -p 8822命令，查看服务器支持的算法列表，再对应调整上面的参数。

4. 确认PHP环境依赖是否正常 #

phpseclib依赖openssl扩展处理加密操作，如果这个扩展未开启，也可能导致数据处理异常，出现"Invalid Size"错误。你可以在代码里加一行测试：

var_dump(extension_loaded('openssl'));

如果输出false，需要在php.ini里开启extension=openssl，然后重启web服务器。

错误原因补充 #

这个报错本质是SSH握手阶段，phpseclib解析服务器返回的数据时，发现数据长度不符合SSH协议预期。常见诱因包括：协议版本不兼容、加密算法不匹配、网络层面（防火墙/代理）截断了数据，或者旧版本库的已知bug。

内容的提问来源于stack exchange，提问作者US-1234