Ubuntu PHP扩展如何添加

Ubuntu 添加 PHP 扩展的常用方法

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

• 更新索引并安装扩展（将 替换为你的 PHP 版本，如 8.1、8.2、8.3；将 替换为扩展名，如 curl、gd、mysql、mbstring）：
  • 查看可用扩展：sudo apt search php-
  • 安装扩展：sudo apt install php-（若系统装了多个 PHP 版本，使用 sudo apt install php****-，如 php8.2-mysql）
• 重启服务使扩展生效：
  • Apache：sudo systemctl restart apache2
  • Nginx + PHP-FPM：sudo systemctl restart php****-fpm && sudo systemctl restart nginx
• 快速验证：
  • 命令行：php -m | grep
  • 或创建 /var/www/html/info.php 输出 phpinfo(); 并在浏览器访问验证

二 使用 PECL 安装扩展

• 安装编译依赖与 PECL：
  • sudo apt install php-dev php-pear build-essential
• 通过 PECL 安装（示例为 redis；imagick 同样适用）：
  • sudo pecl install redis
• 在对应 SAPI 的 php.ini 中启用扩展（路径中的 与 SAPI 如 cli/fpm/apache2 需一致）：
  • 编辑：sudo nano /etc/php///php.ini
  • 添加：extension=redis.so（或 extension=imagick.so）
• 重启服务并验证：
  • Apache：sudo systemctl restart apache2
  • Nginx + PHP-FPM：sudo systemctl restart php****-fpm && sudo systemctl restart nginx
  • 验证：php -m | grep redis

三 从源码编译安装扩展

• 安装工具与依赖：
  • sudo apt install php-dev build-essential
• 编译安装（以 xdebug 为例）：
  • 下载并解压源码，进入目录
  • phpize
  • ./configure
  • make
  • sudo make install
• 启用扩展：
  • Zend 扩展（如 xdebug）在 php.ini 添加：zend_extension=xdebug.so
  • 普通扩展添加：extension=.so
• 重启服务并验证：
  • Apache：sudo systemctl restart apache2
  • Nginx + PHP-FPM：sudo systemctl restart php****-fpm && sudo systemctl restart nginx
  • 验证：php -m | grep xdebug

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

• 多版本并存时，扩展包名与配置路径需带版本号：
  • 安装：sudo apt install 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 与编译工具
• 修改配置后务必重启对应服务；CLI 与 FPM 可能使用不同 php.ini，需分别检查
• 验证方式优先用命令行 php -m；Web 环境可用 phpinfo() 页面核对