ubuntu php配置怎么扩展

ubuntu

小樊

2026-09-19 14:00:51

栏目: 编程语言

在 Ubuntu 上给 PHP 配置/安装扩展，通常分几种情况：用 apt 安装官方扩展、用 pecl 安装扩展、手动编译扩展。下面按常见场景给你讲清楚。

一、先确认 PHP 版本和环境

php -v
which php

如果你用的是 PHP 7.4 / 8.1 / 8.2 等，扩展包名通常是：

php7.4-xxx
php8.1-xxx

查看已安装扩展：

php -m

二、用 apt 安装 PHP 扩展（最推荐）

1️⃣ 更新软件源

sudo apt update

2️⃣ 安装扩展（示例）

sudo apt install php-cli php-common php-mysql php-curl php-gd php-mbstring php-xml php-zip

如果是 PHP 8.1：

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

3️⃣ 重启 Web 服务

# Apache
sudo systemctl restart apache2

# Nginx + PHP-FPM
sudo systemctl restart php8.1-fpm
sudo systemctl restart nginx

三、用 PECL 安装扩展（如 redis、swoole）

1️⃣ 安装 php-dev 和 pecl

sudo apt install php-dev php-pear

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

sudo pecl install redis

3️⃣ 启用扩展

编辑 php.ini（CLI 和 FPM 可能不同）：

php --ini

添加：

extension=redis.so

或：

echo "extension=redis.so" | sudo tee /etc/php/8.1/mods-available/redis.ini
sudo phpenmod redis

4️⃣ 重启服务

sudo systemctl restart php8.1-fpm

四、编译安装 PHP 扩展（高级）

适合 源码扩展 或 自定义参数。

git clone https://github.com/xxx/php-xxx.git
cd php-xxx
phpize
./configure
make
sudo make install

然后在 php.ini 中启用。

五、常见问题

❌ 扩展不生效

确认改的是 正确的 php.ini
CLI 和 FPM 是分开的
用 php -m | grep 扩展名 检查

❌ 找不到 php8.x 包

sudo add-apt-repository ppa:ondrej/php
sudo apt update

六、示例：启用 mbstring

sudo apt install php-mbstring
sudo phpenmod mbstring
sudo systemctl restart apache2

如果你能告诉我：

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

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