Ubuntu如何配置PHP模块

在 Ubuntu 上配置 PHP 模块（扩展）通常分为 安装模块 → 启用模块 → 重启服务 → 验证 几个步骤。下面按常见场景详细说明。

一、确认 PHP 版本

Ubuntu 可能同时安装多个 PHP 版本，先确认当前使用的是哪个版本：

php -v

或查看已安装版本：

ls /usr/bin/php*

例如：

• PHP 8.1
• PHP 8.2
• PHP 8.3

二、安装 PHP 模块

1️⃣ 使用 apt 安装（推荐）

Ubuntu 官方源中 PHP 模块命名规则为：

php<版本>-<模块名>

例如安装常用模块：

sudo apt update
sudo apt install php8.1 php8.1-cli php8.1-fpm \
php8.1-mysql php8.1-curl php8.1-gd \
php8.1-mbstring php8.1-xml php8.1-zip

常见模块说明：

三、启用 / 禁用 PHP 模块

1️⃣ 查看已启用的模块

php -m

或：

php -i | grep "Loaded Configuration"

2️⃣ 启用模块（php.ini 方式）

编辑 php.ini：

sudo nano /etc/php/8.1/cli/php.ini
# 或 fpm
sudo nano /etc/php/8.1/fpm/php.ini

取消注释或添加：

extension=curl
extension=mysql

3️⃣ 使用 phpenmod（推荐）

sudo phpenmod -v 8.1 curl

启用所有 SAPI（cli/fpm/apache）：

sudo phpenmod curl

禁用模块：

sudo phpdismod curl

四、重启 PHP 服务

✅ PHP-FPM（Nginx 常用）

sudo systemctl restart php8.1-fpm

✅ Apache

sudo systemctl restart apache2

五、验证模块是否生效

php -m | grep curl

或在 PHP 文件中：

<?php
phpinfo();

六、常见场景示例

✅ 安装 Redis 模块

sudo apt install php8.1-redis
sudo systemctl restart php8.1-fpm

✅ 安装 Imagick

sudo apt install php8.1-imagick

七、多 PHP 版本共存（重要）

如果你有多个 PHP 版本，一定要指定版本：

sudo phpenmod -v 8.2 gd
sudo systemctl restart php8.2-fpm

八、常见问题

❌ 模块已安装但 php -m 看不到

• 检查是否启用了正确的 SAPI（cli / fpm / apache）
• 重启对应服务
• 确认 php.ini 路径是否正确

如果你能告诉我：

• ✅ Ubuntu 版本（20.04 / 22.04 / 24.04）
• ✅ Web 服务器（Apache / Nginx）
• ✅ PHP 版本

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