如何在CentOS 7 CyberPanel中为网站安装PHP gRPC扩展

核心原因 #

你在CLI中看到的gRPC是系统默认PHP的扩展，而CyberPanel使用的是LiteSpeed专属的lsphp系列PHP版本，两者环境完全独立，所以网站的phpinfo无法检测到该扩展。由于Hostinger的yum源没有提供对应lsphp版本的gRPC预编译包，需要手动编译安装。

操作步骤 #

1. 确认网站使用的PHP版本

• 登录CyberPanel，进入对应网站的Website Settings，查看PHP Version（比如PHP 8.1对应lsphp81）
• 也可通过SSH执行命令查看已安装的lsphp版本：

  ls /usr/local/lsws/lsphp*
  

2. 安装编译依赖

假设网站使用的是lsphp81，执行以下命令安装编译所需依赖：

sudo yum install -y gcc make autoconf glibc-devel zlib-devel openssl-devel
sudo yum install -y lsphp81-devel

注意：如果网站使用其他PHP版本（如lsphp80），将命令中的81替换为对应版本号即可

3. 用LiteSpeed专属PECL安装gRPC

切换到对应lsphp版本的bin目录，使用自带的pecl工具安装扩展：

cd /usr/local/lsws/lsphp81/bin
sudo ./pecl channel-update pecl.php.net
sudo ./pecl install grpc

安装过程中若出现选项提示，直接按回车选择默认配置即可

4. 配置PHP加载gRPC扩展

编辑对应版本的php.ini文件：

sudo nano /usr/local/lsws/lsphp81/etc/php.ini

在文件末尾添加一行：

extension=grpc.so

保存并退出（按Ctrl+O，回车确认，再按Ctrl+X退出）

5. 重启LiteSpeed服务生效

sudo systemctl restart lsws

6. 验证安装

• 访问网站根目录下的phpinfo.php（若没有则新建，内容为<?php phpinfo(); ?>），搜索grpc确认扩展已加载
• 或通过SSH执行对应lsphp版本的命令验证：

  /usr/local/lsws/lsphp81/bin/php -m | grep grpc
  

内容的提问来源于stack exchange，提问作者Salar Pro