Ubuntu如何更新PHP扩展
作者:小宇宙叶知秋
时间:2026-04-20
浏览:0
Ubuntu 更新 PHP 扩展的实用步骤 一 前置检查 动手之前,先摸清家底。这一步看似简单,却能避免后续很多“张冠李戴”的麻烦。核心是确认你系统里正在运行的PHP究竟是哪个版本、以什么模式(SAPI)在服务。 确认当前 PHP 主次版本与 SAPI(CLI 或 FPM):这一点至关重要,因为不同
Ubuntu 更新 PHP 扩展的实用步骤

一 前置检查
动手之前,先摸清家底。这一步看似简单,却能避免后续很多“张冠李戴”的麻烦。核心是确认你系统里正在运行的PHP究竟是哪个版本、以什么模式(SAPI)在服务。
- 确认当前 PHP 主次版本与 SAPI(CLI 或 FPM):这一点至关重要,因为不同版本的扩展包名可是不一样的。
- 查看版本:
php -v - 查看已加载模块:
php -m - 查看 php.ini 路径:
php --ini - 如果你用的是 PHP-FPM,别忘了确认具体的服务名,通常是
systemctl status php*-fpm(比如 php8.1-fpm)。
- 查看版本:
这些信息能帮你精准定位:第一,你需要安装的扩展包名是什么(比如是 php8.1-mysql 还是 php8.1-redis);第二,更新完成后,需要重启哪个服务才能生效。
二 使用 APT 更新扩展(推荐)
对于绝大多数扩展,通过系统的APT包管理器来操作,是最省心、最稳妥的选择。它能自动处理依赖关系和版本匹配,帮你避开不少坑。
- 更新索引并升级已安装的扩展:这会让所有已安装的PHP扩展跟随系统仓库升级到最新版本。
sudo apt updatesudo apt upgrade php*
- 或者,仅升级某个特定扩展:如果你只想更新某一个,可以把
<扩展名>替换成实际的包名,比如 php-mysql、php-gd、php-curl。sudo apt install --only-upgrade php-<扩展名>
- 注意,如果扩展包名里包含了PHP版本号(例如 php8.1-mysql),那么在升级时也请带上对应的版本号。
- 最后,别忘了重启服务让扩展生效:
- 对于 Apache:
sudo systemctl restart apache2 - 对于 Nginx + PHP-FPM 组合:
sudo systemctl restart php-fpm && sudo systemctl restart nginx
- 对于 Apache:
一句话总结,能用APT就用APT,省时省力。
三 使用 PECL 更新扩展(适用于仓库未提供或需新版的场景)
当系统仓库里的扩展版本太旧,或者压根没有提供某个扩展时,PECL(PHP扩展社区库)就是你的得力工具。它让你能直接安装或升级到最新版本,灵活性更高。
- 首先,安装必要的工具和依赖:
sudo apt install php-pear php-dev
- 升级已安装的 PECL 扩展:以 redis 扩展为例。
- 先看看有哪些可用版本:
pecl remote-info redis - 升级到指定版本:
sudo pecl upgrade redis - 如果之前没安装过,那就用:
sudo pecl install redis
- 先看看有哪些可用版本:
- 在对应的 php.ini 文件中启用扩展:这一步很关键!配置文件路径因PHP版本和SAPI模式而异,比如
/etc/php/8.1/cli/php.ini或/etc/php/8.1/fpm/php.ini。- 在文件里添加一行:
extension=redis.so
- 在文件里添加一行:
- 同样,需要重启服务:
- Apache:
sudo systemctl restart apache2 - PHP-FPM:
sudo systemctl restart php-fpm
- Apache:
记住,通过PECL安装或升级的扩展,完成后务必检查php.ini是否已正确启用它,并重启对应的服务。
四 验证与常见问题
操作完成,怎么知道成功了呢?万一出错了又该怎么解决?
- 验证扩展是否更新成功:
- 命令行快速检查:
php -m | grep <扩展名> - 或者,创建一个
info.php文件,内容为,在浏览器中访问这个文件,然后搜索扩展名。
- 命令行快速检查:
- 如果遇到兼容性错误:比如提示 “Module compiled with module API=… does not match PHP compiled with …”。这通常意味着扩展编译时使用的API版本与你当前运行的PHP版本不匹配。
- 解决思路是尽量统一来源:要么全部使用APT管理的扩展,要么都为同一个PHP版本编译PECL扩展。
- 有时候,可能需要重新安装扩展,或者调整PHP运行库的版本,确保编译环境一致。
- 最后一个小提醒:当系统里存在多个PHP版本时,一定要格外小心。确保你安装或升级的扩展是针对正确的PHP版本和SAPI模式的,并且重启了对应的服务(比如正确的 php
-fpm)。
作者最新文章
极度公式
2026-09-16 17:43
索尼WH-1000XM4C发布:复刻经典折叠设计并升级现代接口
2026-09-08 19:10
PDF转TXT操作步骤与转换后内容核对指南
2026-09-04 18:03
Photoshop安装失败或启动异常:系统要求、安装流程与故障排查指南
2026-09-03 06:04
PDF文件体积过大如何压缩及压缩后清晰度检查方法
2026-09-02 19:30
热门文章
更多
精品专题
更多
Mac软件
更多
WINDOWS
更多


































