SSH2扩展是PHP原生C扩展，需编译安装libssh2库、PECL ssh2扩展、配置php.ini并重启服务，无法通过composer install；而phpseclib是纯PHP实现，可用composer require安装，但性能和协议兼容性弱于原生ssh2。
SSH2 扩展不是 Composer 包，不能用 composer require 安装
PHP-SSH2 不是一个纯 PHP 库，而是依赖 libssh2 C 扩展的 PHP 原生扩展。你执行 composer require phpseclib/phpseclib 或类似命令，装出来的只是纯 PHP 的 SSH 实现（比如 phpseclib），它不调用系统 libssh2，性能和兼容性远不如原生 ssh2_* 函数。真正想用 ssh2_connect()、ssh2_exec()、ssh2_scp_send() 这些函数，必须先让 PHP 加载 ssh2 扩展。
正确安装 ssh2 扩展：编译、启用、验证三步缺一不可
常见错误是只运行 pecl install ssh2 就以为完事了，结果 php -m | grep ssh2 查不到，或 function_exists('ssh2_connect') 返回 false。这是因为：
- libssh2 开发库未安装（Ubuntu/Debian 需
sudo apt-get install libssh2-1-dev；CentOS/RHEL 需sudo yum install libssh2-devel） -
pecl install ssh2成功后，没手动在php.ini中添加extension=ssh2 - Web 服务器（如 Apache/Nginx）使用的 PHP SAPI 与 CLI 的配置文件不同，改了 CLI 的
php.ini但没改 FPM 的
验证是否生效，不要只看 php -v，而要运行：
php -r "var_dump(function_exists('ssh2_connect'));"返回 bool(true) 才算真正可用。
立即学习“PHP免费学习笔记（深入）”；
用 ssh2_* 函数执行命令和传输文件的实际写法
原生 ssh2_* 函数接口粗糙，容易卡死或丢数据，关键点在于超时控制和流处理：
-
ssh2_connect()必须传['host' => 'x.x.x.x', 'port' => 22]，不能省略port参数，默认值不总是 22 - 认证失败时不会抛异常，而是返回
false，需手动检查：if (!$conn) { die("SSH connect failed"); } - 执行命令后，必须用
stream_set_timeout()设置读取超时，否则fgets()可能永久阻塞 - SCP 上传大文件前，建议先用
ssh2_sftp()检查目标路径权限，ssh2_scp_send()不报错但可能静默失败
最小可行示例（命令执行）：
$conn = ssh2_connect('192.168.1.100', 22);
ssh2_auth_password($conn, 'user', 'pass');
$stream = ssh2_exec($conn, 'ls -l /tmp');
stream_set_timeout($stream, 10);
while ($buf = fgets($stream)) {
echo $buf;
}
fclose($stream);为什么很多人最终换用 phpseclib 而不是 ssh2 扩展
不是因为 phpseclib 更好，而是因为部署太麻烦：ssh2 扩展在 Docker 多层构建、共享主机、某些云函数环境里根本没法装；而 phpseclib/phpseclib 纯 PHP，composer require 后直接 use phpseclib3\Net\SSH2; 就能用。但它默认用 RSA 密钥协商，遇到老设备（如某些嵌入式 NAS）会握手失败；且不支持带密码的键盘交互式认证（keyboard-interactive），而原生 ssh2 支持。选哪个，本质是在“部署简单”和“协议兼容性/性能”之间做取舍。
真正需要稳定跑生产环境的批量运维脚本，还是得把 ssh2 扩展配好——只是得接受它不像 Composer 包那样一键拉取就能用。
