ubuntu php-fpm如何安装扩展

在 Ubuntu 上给 PHP-FPM 安装扩展，通常有两种方式：apt 安装（推荐） 和 手动编译（pecl）。下面以 PHP 8.1 为例（其他版本把 8.1 换成你的版本即可）。

一、先确认 PHP 版本和 php-fpm 是否已安装

php -v
php-fpm8.1 -v

如果还没装 php-fpm：

sudo apt install php8.1-fpm

二、使用 apt 安装 PHP 扩展（最简单、最安全 ✅）

1️⃣ 查看可用扩展

apt-cache search php8.1-

常见扩展示例：

• php8.1-mysql
• php8.1-curl
• php8.1-gd
• php8.1-mbstring
• php8.1-xml
• php8.1-zip

2️⃣ 安装扩展

例如安装 curl 和 mbstring：

sudo apt install php8.1-curl php8.1-mbstring

3️⃣ 重启 php-fpm

sudo systemctl restart php8.1-fpm

4️⃣ 验证扩展

php -m | grep curl

三、使用 pecl 安装扩展（适合 apt 没有的扩展）

1️⃣ 安装必要工具

sudo apt install php8.1-dev php-pear

2️⃣ 用 pecl 安装（以 redis 为例）

sudo pecl install redis

3️⃣ 启用扩展

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

4️⃣ 重启 php-fpm

sudo systemctl restart php8.1-fpm

四、不同 SAPI 的注意点（很重要 ⚠️）

Ubuntu 的 PHP 配置是分目录的：

/etc/php/8.1/
├── cli/
├── fpm/

如果你只改了 cli，php-fpm 不会生效。

✅ 正确做法：

sudo phpenmod -v 8.1 -s fpm 扩展名

或者确认：

ls /etc/php/8.1/fpm/conf.d/

五、常见扩展推荐（Web 项目）

sudo apt install php8.1-common php8.1-mysql php8.1-curl \
php8.1-gd php8.1-mbstring php8.1-xml php8.1-zip php8.1-bcmath

六、排错小技巧

查看 php-fpm 错误日志：

sudo tail -f /var/log/php8.1-fpm.log

确认加载的 php.ini：

php-fpm8.1 -i | grep php.ini

如果你能告诉我：

• PHP 版本
• 具体想装哪个扩展（如 redis、swoole、imagick）

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