Ubuntu下PHP模块怎么加

在 Ubuntu 下给 PHP 添加（启用/安装）模块，常见有几种情况。下面按最常用场景给你一个完整说明，基本能覆盖 90% 的需求。

一、先确认你用的是哪个 PHP 版本

Ubuntu 可能同时装了多个 PHP 版本，一定要先确认。

php -v

查看 PHP 模块配置文件位置：

php -i | grep "Loaded Configuration File"

或者：

php --ini

二、安装 PHP 模块（最常见）

✅ 示例：安装 curl 模块

sudo apt update
sudo apt install php-curl

安装完成后 自动启用，一般无需手动操作。

常见模块对照表

例如：

sudo apt install php-mysql php-redis php-gd php-mbstring

三、多 PHP 版本（非常常见）

如果你是 PHP 7.4 / 8.1 / 8.2 等：

sudo apt install php8.2-curl

而不是 php-curl（可能装错版本）

查看已安装版本：

ls /usr/bin/php*

四、手动启用 / 禁用模块（php.ini 方式）

1️⃣ 找到模块配置文件

ls /etc/php/*/mods-available/

例如：

/etc/php/8.2/mods-available/curl.ini

2️⃣ 启用模块

sudo phpenmod curl

指定版本：

sudo phpenmod -v 8.2 curl

3️⃣ 禁用模块

sudo phpdimod curl

五、确认模块是否加载成功

php -m | grep curl

或：

php -i | grep curl

六、Apache / Nginx 必须重启

Apache

sudo systemctl restart apache2

Nginx + PHP-FPM

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

⚠️ 只重启 PHP-FPM 是不够的，Nginx 也要重启

七、编译安装模块（不推荐，除非特殊需求）

sudo apt install php-dev
pecl install redis

然后加到 php.ini：

extension=redis.so

八、常见问题排查

❌ 模块装了但没生效

✅ 检查：

• PHP 版本是否一致
• 是否重启了 PHP-FPM / Apache
• phpinfo() 页面是否显示

❌ php -m 有，phpinfo() 没有

✅ 说明 CLI 和 FPM 用的不是同一个 php.ini

九、总结（速查）

# 安装
sudo apt install php-curl

# 启用
sudo phpenmod curl

# 重启
sudo systemctl restart php8.2-fpm

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

• ✅ Ubuntu 版本（20.04 / 22.04 / 24.04）
• ✅ PHP 版本
• ✅ Apache 还是 Nginx
• ✅ 想加哪个模块

我可以直接给你一条精确命令。