php cli与web版本不一致的根本原因是二者使用独立配置和二进制,需分别通过php --ini和phpinfo()确认加载的php.ini路径,修改后重启对应服务(如apache2或php8.1-fpm)。

php -v 显示的版本和 web 里不一致?查 php.ini 加载路径才是关键
Linux 下 PHP 版本混乱,根本原因不是没装对,而是 CLI 和 Web(如 Apache/FPM)用了两套配置、甚至两个二进制。运行 php -v 看到的是命令行版本,而浏览器访问显示的是 Web 服务器加载的 PHP 模块版本。
必须先确认实际生效的配置位置:php --ini —— 查 CLI 的配置路径phpinfo()(写个临时 PHP 文件用浏览器打开)—— 查 Web 环境的 Loaded Configuration File
- 两个环境的
php.ini可能完全不同,改错地方等于白改 - Web 环境下,Apache 用
libphp模块,Nginx + PHP-FPM 则由php-fpm进程控制,改完要重启对应服务(systemctl restart apache2或systemctl restart php8.1-fpm) - FPM 配置文件通常在
/etc/php/8.1/fpm/php.ini,别只改/etc/php/8.1/cli/php.ini
用 apt 安装多个 PHP 版本后,怎么切系统默认的 php 命令?
Ubuntu/Debian 默认只允许一个 php 命令指向一个版本,靠 update-alternatives 管理,不是简单 ln -sf。
操作前先确认已安装的版本:
ls /usr/bin/php* —— 看有没有 php8.1、php8.2 这类带版本号的二进制
- 如果还没注册进 alternatives,先执行:
sudo update-alternatives --install /usr/bin/php php /usr/bin/php8.1 81sudo update-alternatives --install /usr/bin/php php /usr/bin/php8.2 82 - 切换时用:
sudo update-alternatives --config php—— 交互式选择 - 注意:这个只影响 CLI 的
php命令,不影响 Web 环境,也不影响 Composer(它会读PHP_BINARY或自己找)
PHP-FPM 多版本共存:一个站点用 8.1,另一个用 8.2,怎么配?
Nginx 不直接调用 PHP 二进制,而是把请求转发给 PHP-FPM 的 socket 或端口。所以“多版本”本质是跑多个 php-fpm 实例,每个监听不同 socket,再在 server 块里指定 fastcgi_pass。
例如让某个站点走 8.2:fastcgi_pass unix:/run/php/php8.2-fpm.sock;
- 确保对应版本的 FPM 已启用并运行:
sudo systemctl enable php8.2-fpmsudo systemctl start php8.2-fpm - 检查 socket 文件是否存在:
ls /run/php/php8.2-fpm.sock—— 如果没有,可能是 FPM 启动失败,看日志:sudo journalctl -u php8.2-fpm -n 20 - 每个 FPM 实例有独立的
www.conf(如/etc/php/8.2/fpm/pool.d/www.conf),里面listen =必须唯一,不能多个版本监听同一个 socket
升级 PHP 后网站报 Class not found 或 undefined function?优先查扩展是否启用
PHP 主版本升级(如 7.4 → 8.1)后,很多扩展默认不自动启用,尤其是非核心扩展(如 gd、mbstring、curl)。错误不是代码问题,而是扩展没加载。
立即学习“PHP免费学习笔记(深入)”;
查当前启用的扩展:php -m | grep -E 'gd|mbstring|curl'(CLI)phpinfo() 页面里搜索 “Loaded Extensions”(Web)
- Debian/Ubuntu 下,扩展包名带版本号,比如
php8.1-gd,升级 PHP 后旧扩展包不会自动迁移,得手动装:sudo apt install php8.2-gd php8.2-mbstring php8.2-curl - 扩展配置文件在
/etc/php/8.2/mods-available/,启用需软链到/etc/php/8.2/fpm/conf.d/和/etc/php/8.2/cli/conf.d/,或用:sudo phpenmod -v 8.2 gd mbstring curl - 有些扩展(如
apcu)在新版 PHP 中行为变更,即使启用了也可能抛异常,得看具体报错堆栈再判断是不是兼容性问题
版本切换最麻烦的从来不是装几个包,而是搞清 CLI、FPM、Apache 模块三者各自加载哪份配置、哪个二进制、哪个扩展目录。漏掉任意一环,就会出现“明明改了却没生效”的情况。











