Ubuntu PHP扩展如何添加

Ubuntu 添加 PHP 扩展的常用方法

在 Ubuntu 上给 PHP 装扩展，这事儿说简单也简单，说复杂也够折腾一阵子。关键是得选对路子——不同的场景、不同的 PHP 版本，甚至不同的扩展类型，都有各自最合适的安装方式。下面把几种主流方法拆开来讲，每一步都配好命令，照着走基本不会翻车。

一 使用 APT 安装预编译扩展（推荐）

这是最省心的方式，尤其适合那些常见的扩展，比如 curl、gd、mysql、mbstring 这些。APT 仓库里已经编译好了，直接装就行。

先更新索引，然后搜索一下要装的扩展是否可用：

sudo apt search php-

确认有包之后，直接安装。注意，如果你系统里只装了一个 PHP 版本，直接写 php- 就行；要是装了多个版本，比如 8.1、8.2、8.3 并存，那就要带上版本号，例如 php8.2-mysql：

sudo apt install php-
# 或
sudo apt install php-

装完别急着用——得重启一下服务，扩展才能生效。Apache 用户重启 apache2，Nginx + PHP-FPM 用户则重启 php-fpm 和 nginx：

sudo systemctl restart apache2
# 或
sudo systemctl restart php-fpm && sudo systemctl restart nginx

验证是否装上了，两种方式任选：命令行里跑 php -m | grep ，或者建一个 info.php 文件，里面写上 ，然后浏览器访问看看扩展列表里有没有它。

二 使用 PECL 安装扩展

有些扩展（比如 redis、imagick）在 APT 里可能版本太旧，或者压根没收录，这时候 PECL 就派上用场了。它相当于 PHP 的扩展商店，直接从源码编译安装，版本比较新。

先装好编译工具和 PECL 本体：

sudo apt install php-dev php-pear build-essential

然后直接安装，以 redis 为例：

sudo pecl install redis

装好之后，扩展文件（比如 redis.so）已经放在系统里了，但还得在 php.ini 里手动启用它。注意，不同的 SAPI（cli、fpm、apache2）各有各的 php.ini，路径通常是 /etc/php///php.ini。打开对应的文件，加上一行：

extension=redis.so

最后重启服务，跟上面一样，然后验证：php -m | grep redis。

三 从源码编译安装扩展

如果 APT 和 PECL 都搞不定——比如你要装 xdebug 的某个特定版本，或者一个自研的扩展——那就只能动手编译了。步骤稍微多一点，但也不难。

工具链：

sudo apt install php-dev build-essential

以 xdebug 为例，下载源码包，解压，进入目录，然后依次执行：

phpize
./configure
make
sudo make install

安装完成后，扩展文件（xdebug.so）会被放到 PHP 的扩展目录里。接下来修改 php.ini：如果是 Zend 扩展（比如 xdebug），用 zend_extension=xdebug.so；普通扩展用 extension=.so。重启服务，验证。

四 多版本 PHP 与常见问题处理

如果你的机器上跑着多个 PHP 版本（比如同时有 8.1 和 8.2），那就要格外小心。扩展包名必须带上版本号，比如 php8.2-gd、php8.2-mysql；配置文件路径也分版本，/etc/php/8.2/cli/php.ini 和 /etc/php/8.2/fpm/php.ini 是两码事；重启服务时，FPM 的服务名也要带上版本，比如 php8.2-fpm。

几个常见坑：

• 找不到扩展包？先 apt search php- 搜一下，有些包名可能和你想象的不一样。
• PECL 安装失败？确认 php-dev 和 php-pear 装好了，编译工具链也齐全。
• 改完 php.ini 不生效？多半是没重启服务，或者改错了文件——CLI 和 FPM 的 php.ini 是独立的，要分别检查。
• 验证方式，命令行优先用 php -m，Web 环境用 phpinfo() 页面核对，两者都看一下最保险。