CentOS怎样安装PHP扩展

在 CentOS 上安装 PHP 扩展 常见有三种方式，推荐使用 包管理器（yum/dnf），其次是 PECL 或 源码编译。下面按常用场景说明。

一、先确认 PHP 版本与相关工具

查看 PHP 版本

php -v

查看已安装扩展

php -m

安装 EPEL 和 Remi 仓库（强烈推荐）

CentOS 自带 PHP 版本较旧，建议使用 Remi 仓库。

CentOS 7

yum install -y epel-release
yum install -y https://rpms.remirepo.net/enterprise/remi-release-7.rpm

CentOS 8 / Stream

dnf install -y epel-release
dnf install -y https://rpms.remirepo.net/enterprise/remi-release-8.rpm

启用指定 PHP 版本（示例 PHP 7.4 / 8.1）

dnf config-manager --set-enabled remi-php81
# 或（CentOS 7）
yum-config-manager --enable remi-php81

二、使用 yum / dnf 安装 PHP 扩展（✅ 推荐）

查看可安装的扩展

yum search php | grep php-

安装常用扩展示例

yum install -y php php-cli php-fpm \
php-mysqlnd \
php-pdo \
php-gd \
php-curl \
php-json \
php-mbstring \
php-xml \
php-zip \
php-opcache

安装扩展后重启服务

systemctl restart php-fpm
systemctl restart httpd   # 或 nginx

三、使用 PECL 安装扩展（适用于 php 扩展在 yum 中没有的情况）

安装依赖

yum install -y php-pear php-devel gcc make

示例：安装 redis 扩展

pecl install redis

启用扩展

echo "extension=redis.so" > /etc/php.d/redis.ini

验证

php -m | grep redis

四、源码编译安装（不推荐，除非必须）

示例：安装自定义扩展

wget https://pecl.php.net/get/redis-5.3.7.tgz
tar -zxvf redis-5.3.7.tgz
cd redis-5.3.7
phpize
./configure
make && make install

然后手动添加：

extension=redis.so

五、常见问题排查

1️⃣ 扩展不生效

确认修改的是 正确的 php.ini

php --ini

2️⃣ PHP CLI 和 FPM 版本不一致

php -v
php-fpm -v

3️⃣ 查看扩展是否加载

php -i | grep 扩展名

六、总结（推荐顺序）

✅ 优先：yum / dnf install php-xxx
✅ 其次：pecl install
❌ 最后：源码编译

如果你愿意，可以告诉我：

✅ CentOS 版本（7 / 8 / Stream）
✅ PHP 版本
✅ 要安装的具体扩展（如 redis、swoole、gd、mysqli）

我可以直接给你 一条条可复制执行的命令 ✅