ubuntu php配置如何加扩展

ubuntu

小樊

2026-09-10 09:47:16

栏目: 编程语言

在 Ubuntu 上给 PHP 添加扩展，通常分 CLI（命令行） 和 Web（如 Apache / Nginx + PHP-FPM） 两种情况。下面按常见场景说明。

一、先确认 PHP 版本

php -v

例如输出：

PHP 8.1.2

记住版本号（如 8.1）

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

1. 更新软件源

sudo apt update

2. 安装扩展

格式：

sudo apt install php<版本>-<扩展名>

常见示例：

# 安装 mysqli
sudo apt install php8.1-mysqli

# 安装 curl
sudo apt install php8.1-curl

# 安装 gd
sudo apt install php8.1-gd

# 安装 mbstring
sudo apt install php8.1-mbstring

# 安装 zip
sudo apt install php8.1-zip

三、确认扩展是否启用

php -m | grep 扩展名

例如：

php -m | grep curl

或：

php -i | grep extension_dir

四、Web 环境（Apache / Nginx）

1. Apache

sudo apt install libapache2-mod-php8.1
sudo systemctl restart apache2

2. Nginx（PHP-FPM）

sudo systemctl restart php8.1-fpm
sudo systemctl reload nginx

五、手动启用扩展（极少情况）

如果扩展已安装但未启用：

sudo phpenmod 扩展名

例如：

sudo phpenmod gd

然后重启服务。

六、手动编译安装扩展（高级）

适合 PECL 扩展：

sudo apt install php8.1-dev
sudo pecl install redis

然后在 php.ini 中加：

extension=redis.so

七、常见 php.ini 位置

php --ini

通常：

CLI: /etc/php/8.1/cli/php.ini
FPM: /etc/php/8.1/fpm/php.ini

如果你能告诉我：

PHP 版本
Ubuntu 版本
具体要加哪个扩展（如 redis、swoole、xdebug）

我可以给你精确命令。