Linux下PHP安装ssh2扩展完整指南

目标与环境准备

PHP自带的默认安装通常不包含ssh2扩展。若需要在PHP中通过代码执行远程服务器命令或使用SFTP协议传输文件，必须显式安装该扩展。本教程基于传统源码编译模式，适用于大多数支持gcc和make命令的Linux发行版（如CentOS, Ubuntu, Debian）及较老版本的PHP运行环境。

第1步：安装底层依赖 libssh2 库

ssh2扩展依赖于C语言编写的libssh2库。由于历史版本兼容性原因，此处演示使用稳定的1.4.2版本进行安装（生产环境建议根据需求选择更新版本）。

1. 下载源码包：
   wget http://www.libssh2.org/download/libssh2-1.4.2.tar.gz
2. 解压：
   tar -zxvf libssh2-1.4.2.tar.gz
3. 进入目录并配置：指定安装路径，例如/usr/local/libssh2。
   cd libssh2-1.4.2
./configure --prefix=/usr/local/libssh2
4. 编译并安装：
   make && make install

第2步：构建与配置 ssh2 扩展

接下来获取PHP官方PECL源的ssh2模块源码。注意版本号需匹配当前使用的PHP版本环境。

5. 下载扩展包：
   wget http://pecl.php.net/get/ssh2-0.12.tgz
6. 解压并进入：
   tar -zxvf ssh2-0.12.tgz
cd ssh2-0.12
7. 初始化构建环境：这一步会生成config.m4和Makefile等关键文件。
   phpize
8. 执行Configure脚本：这是核心环节，需指向正确的依赖库路径和本机PHP配置路径。
   ./configure --with-ssh2=/usr/local/libssh2 --with-php-config=/usr/local/php/bin/php-config

第3步：编译并部署模块

完成配置后，编译扩展并复制到对应的PHP扩展目录。

9. 编译：
   make
10. 复制 .so 文件：请将编译好的modules/ssh2.so复制到你的PHP extensions目录。旧版本PHP可能要求特定子目录结构（如no-debug-zts-...），请根据实际报错调整路径。
    cp modules/ssh2.so /usr/local/php/lib/php/extensions/no-debug-zts-20090626

验证与服务重启

安装完成后，必须重新加载PHP-FPM进程以使新扩展生效。

11. 语法检查：
    /usr/local/php/sbin/php-fpm -t
12. 重启服务：
    /etc/init.d/php-fpm restart

操作无误后，可通过php -m查看列表是否包含ssh2，或在PHP脚本中使用function_exists('ssh2_connect')进行功能测试。以上就是在Linux平台为PHP安装ssh2扩展的详细内容，更多关于Linux PHP环境配置的资料请关注本站其它相关文章！