Ubuntu怎么配置PHP扩展

在 Ubuntu 上配置 PHP 扩展，通常分为 安装扩展 → 启用扩展 → 验证扩展 三步。下面我按常见场景给你一个完整说明。

一、确认 PHP 版本

先确认你正在使用的 PHP 版本：

php -v

或者查看 PHP CLI 使用的配置文件路径：

php --ini

如果是 Apache / Nginx + PHP-FPM，版本可能不同：

php-fpm -v

二、安装 PHP 扩展（最常见方式）

Ubuntu 使用 apt 管理 PHP 扩展，扩展包命名规则一般是：

php<版本>-<扩展名>

示例（以 PHP 8.2 为例）

1️⃣ 更新软件源

sudo apt update

2️⃣ 安装扩展

sudo apt install php8.2-mysql
sudo apt install php8.2-curl
sudo apt install php8.2-gd
sudo apt install php8.2-mbstring
sudo apt install php8.2-xml
sudo apt install php8.2-zip

✅ 安装后扩展一般 自动启用

三、手动启用 / 禁用扩展

查看已启用的扩展

php -m

启用扩展

sudo phpenmod -v 8.2 扩展名

例如：

sudo phpenmod -v 8.2 curl

禁用扩展

sudo phpdismod -v 8.2 curl

⚠️ 修改后需要重启 PHP 服务

四、重启 PHP 服务

Apache

sudo systemctl restart apache2

Nginx + PHP-FPM

sudo systemctl restart php8.2-fpm
sudo systemctl restart nginx

五、验证扩展是否生效

CLI 验证

php -m | grep curl

网页验证（推荐）

创建 info.php：

<?php
phpinfo();

访问：

http://your-server/info.php

六、编译安装扩展（特殊情况）

适用于 PECL 扩展 或 源码扩展

1️⃣ 安装编译工具

sudo apt install php8.2-dev autoconf automake libtool

2️⃣ 使用 pecl 安装

sudo pecl install redis

3️⃣ 手动添加配置

sudo bash -c "echo extension=redis.so > /etc/php/8.2/mods-available/redis.ini"
sudo phpenmod -v 8.2 redis

七、常见扩展对照表

功能	扩展名
MySQL	`mysql` / `mysqli` / `pdo_mysql`
Redis	`redis`
GD 图像	`gd`
CURL	`curl`
多字节	`mbstring`
XML	`xml`
ZIP	`zip`

八、常见错误排查

❌ 扩展未生效

是否重启了 PHP？
是否修改了正确的 php.ini
CLI 和 FPM 使用的是不同配置

❌ 找不到扩展

sudo apt-cache search php | grep 扩展名

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

✅ Ubuntu 版本（20.04 / 22.04 / 24.04）
✅ PHP 版本
✅ 要装哪个扩展

我可以给你 精确到命令级别 的配置方案。