ubuntu php配置怎么配扩展

ubuntu

小樊

2026-10-04 10:57:43

栏目: 编程语言

在 Ubuntu 上给 PHP 配置/安装扩展，通常分几种情况。下面按最常见、最推荐的方式来讲（以 PHP 8.1 为例，其他版本把 8.1 换成你的版本即可）。

一、先确认 PHP 版本

php -v

或者：

php --version

假设是 PHP 8.1

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

Ubuntu 下 PHP 扩展一般叫：

php8.1-扩展名

1️⃣ 更新软件源

sudo apt update

2️⃣ 安装扩展（举例）

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

三、查看已安装扩展

php -m

或只看某个扩展：

php -m | grep curl

四、启用 / 禁用扩展（apt 安装的）

启用

sudo phpenmod 扩展名
# 例：
sudo phpenmod curl

禁用

sudo phpdismod curl

注意：扩展名不带版本号（如 curl，不是 php8.1-curl）

五、改 PHP 配置文件（如需要）

CLI 配置

sudo nano /etc/php/8.1/cli/php.ini

Web（Apache / Nginx + PHP-FPM）

sudo nano /etc/php/8.1/fpm/php.ini

搜扩展相关：

extension=curl

改完重启：

# PHP-FPM
sudo systemctl restart php8.1-fpm

# Apache
sudo systemctl restart apache2

六、PECL 安装扩展（高级）

适合 apt 没有的扩展，比如 redis、swoole

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

然后在 php.ini 加：

extension=redis.so

七、常见问题

❓ 扩展装了但没生效

看的是 CLI 还是 FPM？
是否重启了对应服务？
用 phpinfo() 或 php -m 确认

❓ 多个 PHP 版本

sudo update-alternatives --config php

如果你告诉我：

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

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