最可靠的是phpseclib扩展，纯PHP实现无依赖、兼容性强、支持密钥登录与SFTP；ext-ssh2性能好但需编译且常被禁用。
PHP用什么扩展执行SSH命令最可靠
直接用 exec() 或 shell_exec() 调用 ssh 命令行风险高：权限失控、输出截断、错误不捕获、密码交互不可控。生产环境必须用 phpseclib（纯PHP实现，无C扩展依赖）或 ext-ssh2（性能更好但需编译安装）。Laravel项目推荐 phpseclib，Composer 安装即用，兼容性稳，调试友好。
安装方式：
composer require phpseclib/phpseclib:^3.0
-
ext-ssh2在 Docker 或共享主机上常被禁用，phpseclib无此限制 -
phpseclib支持密钥登录、超时控制、SFTP、命令流式读取，适合长任务（如部署脚本） - 别用
ssh2_connect()+ssh2_exec()混搭 —— 错误码不统一，ssh2_exec()返回资源句柄，不读取就卡死
Laravel中封装SSH连接要避开哪些坑
在 Laravel 中硬编码 SSH 配置（如 host、key path）到控制器里是反模式。必须抽离为配置项 + 可复用服务类，否则部署换服务器就得改代码。
- 把连接参数写进
config/ssh.php，而非.env—— 私钥路径、端口、用户等属于环境配置，但密钥内容不应进.env（易泄露） - 私钥文件必须设为
0600权限，PHP 进程用户（如 www-data）要有读权限，否则phpseclib报Unable to open private key file - 不要在
__construct()里直接 connect —— 连接应惰性建立，避免实例化就失败；建议用connect()方法显式触发 - 每次执行完命令必须调用
$ssh->disconnect()，否则连接堆积，触发服务器MaxStartups限制
执行远程命令时如何捕获真实错误和实时输出
$ssh->exec('ls -l') 默认只返回最后一屏输出，且不区分 stdout/stderr。部署或调试时看不到报错细节，极易误判成功。
立即学习“PHP免费学习笔记（深入）”；
- 用
$ssh->read()+$ssh->write()手动交互，适合需要响应判断的场景（如输入 yes/no、等待提示符） - 更稳妥的方式是包装成 shell 脚本并重定向：
$cmd = 'bash -c \'ls -l /tmp 2>&1\'';
确保 stderr 合并进返回值 - 加超时保护：
$ssh->setTimeout(30)，防止远程卡死阻塞整个请求 - 对长命令（如
git pull），用$ssh->enablePTY()开启伪终端，避免因缺少 TTY 导致某些命令拒绝执行（如sudo不认密码）
Laravel队列里跑SSH任务要注意什么
SSH 连接不能跨进程复用，队列 worker 是常驻进程，如果在 job 构造函数里建了 Net_SSH2 实例，下次 job 复用时连接已断，exec() 直接抛异常。
- 所有 SSH 对象必须在
handle()内创建、使用、销毁 —— 不存属性、不依赖构造注入的连接实例 - 避免在队列中执行交互式命令（如
mysql -u root -p），没有 stdin 可读，会永久挂起 - 大文件传输不用 SSH 命令拼接，改用
SFTP子系统：$sftp = $ssh->getSFTP()，它支持断点续传和目录递归 - 记录日志时脱敏敏感字段：
host可记，private_key_path绝对路径要打码，防止日志泄露密钥位置
PermitTunnel 或 AllowUsers 配置上，先手动 ssh 成功再写 PHP。 
