Ubuntu如何安装PHP模块

在 Ubuntu 上安装 PHP 模块（扩展）通常有两种常用方式：通过 apt 包管理器 和 通过 pecl 编译安装。下面按常见场景一步一步说明。

一、查看当前 PHP 版本（很重要）

不同 PHP 版本对应的包名不同。

php -v

示例输出：

PHP 8.2.10 (cli)

记住你的版本号（如 8.1、8.2、8.3）。

二、通过 apt 安装 PHP 模块（推荐 ✅）

1️⃣ 更新软件源

sudo apt update

2️⃣ 搜索可用的 PHP 模块

apt search php | grep php8.2

（把 8.2 换成你的 PHP 版本）

3️⃣ 安装常用 PHP 模块示例

基础常用模块

sudo apt install php8.2-common php8.2-cli php8.2-fpm

常见扩展

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

其他常见模块

sudo apt install php8.2-bcmath php8.2-intl php8.2-redis php8.2-opcache

✅ 安装完成后会自动启用，无需手动配置。

三、确认模块是否安装成功

php -m

或查看某个模块：

php -m | grep curl

四、通过 pecl 安装 PHP 模块（高级）

适用于 apt 中没有的扩展。

1️⃣ 安装 pecl 依赖

sudo apt install php8.2-dev php-pear

2️⃣ 安装扩展（示例：swoole）

sudo pecl install swoole

3️⃣ 启用扩展

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

五、重启 PHP 服务（Web 环境必须）

PHP-FPM

sudo systemctl restart php8.2-fpm

Apache

sudo systemctl restart apache2

六、查看 php.ini 路径

php --ini

七、常见错误排查

❌ 模块装了但没生效

• 确认 PHP 版本
• 确认重启了 php-fpm / apache
• 用 phpinfo() 查看加载的 php.ini

八、示例：安装 Redis 扩展（完整流程）

sudo apt install php8.2-redis
sudo systemctl restart php8.2-fpm
php -m | grep redis

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

• ✅ Ubuntu 版本（20.04 / 22.04 / 24.04）
• ✅ PHP 版本
• ✅ 要安装哪个模块

我可以给你精确命令。