1. 引言
php的ssh2扩展为php应用程序提供了与ssh服务器进行安全通信的能力，包括执行远程命令、文件传输（sftp）等。在rhel8系统上，尽管php 7.4可以通过dnf默认流安装，但ssh2扩展通常需要手动编译安装，因为它可能不直接包含在默认的软件包仓库中。本教程将详细介绍如何通过源代码编译的方式，在rhel8上为php 7.4环境成功安装ssh2扩展。
2. 环境准备与依赖安装
在开始编译之前，需要确保系统已安装必要的开发工具和PHP开发库。这些依赖项对于编译C语言库和PHP扩展至关重要。
sudo yum install make gcc php-devel php-pear -y
- make: 用于自动化编译过程。
- gcc: GNU C编译器，用于编译源代码。
- php-devel: 包含PHP开发所需的头文件和库，phpize工具也包含在其中。
- php-pear: PHP扩展与应用库，虽然我们不直接使用PEAR安装SSH2，但它可能包含其他一些编译时所需的工具或配置。
3. 编译安装Libssh2库
PHP的SSH2扩展依赖于libssh2库。因此，我们需要首先编译并安装libssh2。
-
下载Libssh2源代码包
访问libssh2官方网站或其下载页面，获取最新稳定版本的源代码包。本教程以libssh2-1.10.0.tar.gz为例。
立即学习“PHP免费学习笔记（深入）”；
wget https://libssh2.org/download/libssh2-1.10.0.tar.gz
-
解压并进入源代码目录
tar -zxvf libssh2-1.10.0.tar.gz cd libssh2-1.10.0
-
配置、编译与安装
执行以下命令序列进行配置、编译和安装。./configure命令会检查系统环境并生成Makefile。
./configure make sudo make install
make install命令会将编译好的库文件安装到系统默认路径（通常是/usr/local/lib和/usr/local/include）。
4. 编译安装PHP SSH2扩展
在libssh2安装完成后，我们可以开始编译PHP的SSH2扩展。
-
下载PHP SSH2扩展源代码包
访问PECL官网（PHP Extension Community Library）获取SSH2扩展的源代码包。本教程以ssh2-1.3.1.tgz为例。
wget https://pecl.php.net/get/ssh2-1.3.1.tgz
-
解压并进入源代码目录
tar -zxvf ssh2-1.3.1.tgz cd ssh2-1.3.1
-
准备PHP扩展编译环境
phpize工具用于为PHP扩展生成编译所需的配置脚本。
phpize
执行成功后，会生成configure文件。
-
配置、编译与安装
./configure make # 可选：运行测试 # make test sudo make install
make install命令会将ssh2.so文件安装到PHP的扩展模块目录（通常是/usr/lib64/php/modules或/usr/local/lib/php/extensions/no-debug-zts-xxxxxx，具体路径取决于PHP的安装方式和版本）。
5. 启用SSH2扩展
安装完ssh2.so模块后，还需要在PHP的配置文件中启用它。
-
编辑php.ini文件
找到PHP的php.ini配置文件。在RHEL8上，PHP 7.4通过DNF安装后，通常位于/etc/php.ini。
sudo vi /etc/php.ini
-
添加扩展配置
在php.ini文件的任意位置（通常是在所有extension=指令的下方或一个专门的扩展配置区域），添加以下行：
extension=ssh2.so
-
重启PHP服务
为了使新的扩展生效，需要重启PHP-FPM服务。
sudo systemctl restart php-fpm
如果您的PHP运行在Apache或其他Web服务器模块下，则需要重启相应的Web服务（例如sudo systemctl restart httpd）。
6. 验证安装
安装完成后，可以通过PHP命令行工具验证SSH2扩展是否已成功加载。
php -m | grep ssh2
如果输出中包含ssh2，则表示扩展已成功安装并启用。您也可以通过创建一个简单的PHP脚本来测试：
<?php
if (extension_loaded('ssh2')) {
echo "SSH2 extension is loaded.\n";
} else {
echo "SSH2 extension is NOT loaded.\n";
}
// 尝试连接一个SSH服务器（请替换为您的实际SSH服务器信息）
// $connection = ssh2_connect('your_ssh_host', 22);
// if ($connection) {
// echo "Successfully connected to SSH host.\n";
// // ... 进一步操作
// } else {
// echo "Failed to connect to SSH host.\n";
// }
?>7. 注意事项与总结
- 版本兼容性： 确保下载的libssh2和ssh2扩展版本与您的PHP版本兼容。本教程使用的版本在PHP 7.4上验证通过。
- 路径问题： 如果./configure步骤失败，可能是因为找不到libssh2的头文件或库文件。您可以尝试在./configure命令中指定路径，例如：./configure --with-ssh2=/usr/local。
- 权限问题： make install命令通常需要root权限，因此请使用sudo。
- PHP-FPM与Web服务器： 确保重启了正确的PHP服务（如php-fpm）或Web服务器，以加载新的php.ini配置。
- php.ini位置： 不同的PHP安装方式可能会导致php.ini文件位于不同的位置。您可以使用php --ini命令来查找当前PHP配置文件的路径。
通过以上步骤，您应该能够在RHEL8系统上的PHP 7.4环境中成功安装并启用SSH2扩展，从而为您的PHP应用程序提供强大的SSH通信能力。
