RHEL8上PHP 7.4环境SSH2扩展的编译与安装指南

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。

1. 下载Libssh2源代码包

   访问libssh2官方网站或其下载页面，获取最新稳定版本的源代码包。本教程以libssh2-1.10.0.tar.gz为例。

   立即学习“PHP免费学习笔记（深入）”；

   wget https://libssh2.org/download/libssh2-1.10.0.tar.gz

   登录后复制

2. 解压并进入源代码目录

   tar -zxvf libssh2-1.10.0.tar.gz
   cd libssh2-1.10.0

   登录后复制

3. 配置、编译与安装

   执行以下命令序列进行配置、编译和安装。./configure命令会检查系统环境并生成Makefile。

   ./configure
   make
   sudo make install

   登录后复制

   make install命令会将编译好的库文件安装到系统默认路径（通常是/usr/local/lib和/usr/local/include）。

4. 编译安装PHP SSH2扩展

在libssh2安装完成后，我们可以开始编译PHP的SSH2扩展。

1. 下载PHP SSH2扩展源代码包

   访问PECL官网（PHP Extension Community Library）获取SSH2扩展的源代码包。本教程以ssh2-1.3.1.tgz为例。

   wget https://pecl.php.net/get/ssh2-1.3.1.tgz

   登录后复制

2. 解压并进入源代码目录

   tar -zxvf ssh2-1.3.1.tgz
   cd ssh2-1.3.1

   登录后复制

3. 准备PHP扩展编译环境

   phpize工具用于为PHP扩展生成编译所需的配置脚本。

   

   风车Ai翻译

   跨境电商必备AI翻译工具

   160

   查看详情

   phpize

   登录后复制

   执行成功后，会生成configure文件。

4. 配置、编译与安装

   ./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的配置文件中启用它。

1. 编辑php.ini文件

   找到PHP的php.ini配置文件。在RHEL8上，PHP 7.4通过DNF安装后，通常位于/etc/php.ini。

   sudo vi /etc/php.ini

   登录后复制

2. 添加扩展配置

   在php.ini文件的任意位置（通常是在所有extension=指令的下方或一个专门的扩展配置区域），添加以下行：

   extension=ssh2.so

   登录后复制

3. 重启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通信能力。

以上就是RHEL8上PHP 7.4环境SSH2扩展的编译与安装指南的详细内容，更多请关注php中文网其它相关文章！