跳到主要内容

PHP PECL 软件包：如何查看和安装

什么是 PHP PECL 软件包？​

PECL（PHP 扩展社区库）是一个 PHP 扩展的仓库，提供所有已知扩展的目录以及用于下载和开发 PHP 扩展的托管服务。

  • 如何查看当前已安装的 PECL 软件包
  • 如何安装 PECL 软件包
  • 总结

如何查看当前已安装的 PECL 软件包​

要查看当前已安装的 PECL 软件包，您需要具备 SSH 访问权限。如果您需要启用 SSH 访问，请参阅我们的文章：SSH 访问。
目前，单个 cPanel 用户无法直接查看已安装的 PECL 软件包。您可以通过检查位于您的主目录下的 ~/pecl 文件夹来了解已安装的软件包。
您也可以使用以下命令查看全局安装的 PECL 软件包（命令中的“73”可替换为服务器上其他可用的 PHP 版本号，例如 56、70、71、72、73 或 74）：

ea-php73-pecl list -a

如何安装 PECL 软件包​

您可以将 PECL 软件包下载并安装到您的账户本地。此过程同样需要 SSH 访问权限。如需启用 SSH 访问，请参阅我们的文章：SSH 访问。
注意： 以下命令中的 "ea-php73" 可根据服务器上的 PHP 版本替换为相应版本号。

登录后，安装步骤如下：

  1. 在您的主目录下创建一个文件夹，用于下载和编译软件包。
mkdir ~/pecl
  1. 创建一个目录，用于存放您的 PHP 扩展，例如 ~/php/extensions。
mkdir ~/php  
mkdir ~/php/extensions
  1. 切换到刚创建的 PECL 目录，并运行以下命令下载指定的软件包（请将 <packagename> 替换为实际的软件包名称）：
cd ~/pecl  
/opt/cpanel/ea-php73/root/usr/bin/pecl download <packagename>

如果需要安装多个 PECL 软件包，请重复执行步骤 4 至步骤 9，最后执行步骤 12。

  1. 下载完成后，使用以下命令解压下载的软件包（请将 $package 替换为实际的包文件名，通常是 <packagename>.tgz）：
tar -zxvf $package.tgz
  1. 解压后，切换到解压出来的目录（通常是 ~/pecl/<packagename>），然后运行 phpize 命令以准备编译环境：
cd ~/pecl/<packagename>  
/opt/cpanel/ea-php73/root/usr/bin/phpize

注：phpize 命令用于准备 PHP 扩展的编译环境。

  1. 运行以下命令配置扩展（请确保仍在模块目录中）：
./configure --with-php-config=/opt/cpanel/ea-php73/root/usr/bin/php-config --prefix=$HOME/pecl/
  1. 如果配置过程无错误，说明该软件包与当前环境兼容。接着运行：
make

  1. 编译完成后，会在 modules 目录下生成扩展模块文件，文件名格式通常为 <packagename>.so。您需要将此文件添加到您的 php.ini 中。

  2. 将生成的 .so 文件复制到您之前创建的扩展目录中：

cp ~/pecl/<packagename>/modules/<packagename>.so ~/php/extensions/
  1. 将服务器上已安装的扩展从 /usr/lib64/php/modules/ 目录复制到您的扩展目录，以确保依赖完整：
cp -rf /usr/lib64/php/modules/* ~/php/extensions/
  1. 通过 cPanel 的 高级 部分中的 MultiPHP INI 编辑器 编辑您的 PHP 配置。切换到编辑器模式，添加或修改以下配置行，指定扩展目录路径。
    请使用 pwd 命令确认您的主目录路径，示例如下（请将 <user> 替换为您的用户名）：
extension_dir = "/home/<user>/php/extensions"
  1. 在 php.ini 文件中添加扩展，格式如下（请将 <packagename> 替换为实际的软件包名称）：
extension=<packagename>.so

总结​

本指南介绍了 PECL 软件包的基本概念，如何查看当前已安装的软件包，以及如何在您的 PHP 环境中安装新的 PECL 扩展。虽然查看已安装的软件包需要 SSH 访问权限，但您可以通过检查 ~/pecl 文件夹来定位它们。PECL 软件包的安装过程包括下载、解压、编译和配置，完成后即可增强您的 PHP 功能。只需按照步骤操作，您就能轻松安装所需的 PECL 扩展，提升 PHP 使用体验。