Ubuntu上PHP扩展管理方法

作者：袖梨 2026-07-19

Ubuntu上PHP扩展管理指南

在Ubuntu系统中，PHP扩展的管理主要通过APT包管理器（推荐，适用于大多数常见扩展）、PECL（适用于官方扩展库中的扩展）及手动编译（适用于无预编译包的扩展）三种方式实现。以下是详细操作流程及注意事项：

一、准备工作

在管理扩展前，需确保系统包列表最新，并安装必要的工具：

sudo apt update# 更新软件包列表sudo apt install php-pear php-dev# 安装PECL及编译工具（用于非APT扩展）

其中，php-pear是PECL的依赖包，php-dev包含编译扩展所需的头文件。

二、使用APT包管理器管理扩展（推荐）

APT是Ubuntu默认的包管理工具，可便捷地安装、更新、删除PHP扩展，且会自动处理依赖关系。

1. 安装扩展

sudo apt install php-<extension-name># 替换<extension-name>为目标扩展（如mysql、curl、gd）

示例：安装MySQL扩展（支持PHP与MySQL数据库交互）：

sudo apt install php-mysql

若需安装多个扩展，可一次性列出：

sudo apt install php-mysql php-curl php-gd php-mbstring

2. 更新扩展

sudo apt update# 先更新软件包列表sudo apt upgrade php-<extension-name># 升级指定扩展

示例：升级GD扩展（图像处理库）：

sudo apt upgrade php-gd

3. 删除扩展

sudo apt remove php-<extension-name># 删除指定扩展

示例：删除MBSTRING扩展（多字节字符串处理）：

sudo apt remove php-mbstring

4. 验证扩展是否安装成功

php -m | grep <extension-name># 列出已加载的扩展，检查目标扩展是否存在

示例：验证MySQL扩展是否安装：

php -m | grep mysql

若输出中包含mysql，则表示安装成功。

三、使用PECL管理扩展（适用于官方扩展库）

PECL（PHP Extension Community Library）是PHP官方扩展库，包含部分未纳入APT的扩展（如Redis、Imagick）。需通过PECL安装后，手动启用。

1. 安装PECL扩展

sudo pecl install <extension-name># 替换<extension-name>为目标扩展（如redis、imagick）

示例：安装Redis扩展（高性能键值存储）：

sudo pecl install redis

2. 启用扩展

安装完成后，需在PHP配置文件中添加扩展配置：

# 查找php.ini文件位置（根据PHP版本调整）php --ini# 编辑对应的php.ini文件（如CLI或FPM）sudo nano /etc/php/<version>/<sapi>/php.ini# 替换<version>为PHP版本（如8.1），<sapi>为CLI或fpm

在文件末尾添加以下行（注意：无需添加.so后缀）：

extension=<extension-name>

示例：启用Redis扩展：

extension=redis

3. 重启Web服务器

# Apachesudo systemctl restart apache2# Nginx + PHP-FPMsudo systemctl restart php<version>-fpm# 替换<version>为PHP版本（如8.1）sudo systemctl restart nginx

4. 验证扩展

php -m | grep <extension-name>

示例：验证Redis扩展：

php -m | grep redis

四、手动编译安装扩展（适用于无预编译包的扩展）

若扩展不在APT或PECL中，需从源码编译安装。此方法较复杂，需具备一定编译经验。

1. 下载扩展源码

wget https://github.com/<extension-repo>/<extension-name>/archive/master.zip# 替换为实际源码地址unzip master.zipcd <extension-name>-master

2. 安装依赖并编译

sudo apt install build-essential php-dev# 安装编译工具及PHP开发头文件phpize# 准备编译环境./configure# 配置编译选项（根据扩展要求调整）make# 编译扩展sudo make install# 安装扩展（生成的.so文件通常在/usr/lib/php/<version>/目录下）

3. 启用扩展

同PECL步骤，在php.ini中添加extension=<extension-name>.so，并重启Web服务器。

五、常用辅助命令

1. 查看已安装的扩展

php -m# 列出所有已加载的扩展ls /etc/php/<version>/<sapi>/conf.d/# 查看启用的扩展配置文件（Ubuntu会将扩展配置放在单独的.conf文件中）

2. 启用/禁用扩展（Ubuntu专用）

Ubuntu提供了phpenmod（启用）和phpdismod（禁用）命令，简化扩展管理：

# 启用扩展（如mbstring）sudo phpenmod mbstring# 禁用扩展（如mbstring）sudo phpdismod mbstring# 指定PHP版本（如7.4）sudo phpenmod -v 7.4 mbstringsudo phpdismod -v 7.4 mbstring

注意：phpenmod和phpdismod仅适用于通过APT安装的扩展，手动安装的扩展需手动编辑php.ini。