PHP版本不一致的根本原因是不同环境调用的PHP可执行文件路径不同；需逐层确认命令行（which php）、Web服务器（phpinfo()）、Composer（composer diagnose）、Docker（Dockerfile与缓存）、Apache（模块模式或php-fpm）各自使用的PHP路径与配置。
PHP 版本控制出错，通常不是 PHP 自身在“控制版本”，而是你在用 php 命令、composer、docker、php-fpm 或 Web 服务器（如 Nginx/Apache）时，实际运行的 PHP 版本和你预期的不一致。排查核心就一条：**逐层确认「谁在调用 PHP」以及「它调用的是哪个 php 可执行文件」**。
为什么 php -v 和 Web 页面里 phpinfo() 显示的版本不一样
这是最常见错觉——命令行和 Web 服务根本可能用的是两套 PHP 环境。
-
php -v查的是当前 shell 环境下的php命令路径，运行which php就能看见具体是哪个二进制文件（比如/usr/bin/php或/opt/homebrew/bin/php） - Web 页面里的
phpinfo()显示的是 Web 服务器（如 Apache 的libphp.so模块，或 Nginx +php-fpm进程）加载的 PHP 配置，它的php-fpm可能指向/usr/sbin/php-fpm8.2，配置文件在/etc/php/8.2/fpm/php.ini - 如果你用 Homebrew/MAMP/XAMPP/WAMP，它们自带独立 PHP，且默认不修改系统 PATH，
php -v很可能还是系统自带的老版本
Composer 报错 “Package requires PHP ^8.1 but your PHP version is 7.4.33” 怎么办
Composer 判断 PHP 版本，依据的是它启动时使用的 php 解释器，而不是你本地装了多少个 PHP。
- 运行
composer diagnose，第一行就会明确告诉你 “You are running Composer with PHP7.4.33” - 不要只改
PATH，还要确认composer是以脚本方式运行（#!/usr/bin/env php）还是 Phar 方式；后者会硬编码调用系统默认php - 临时指定 PHP 版本：运行
php8.1 /path/to/composer.phar install（注意是先写 php 路径，再写 composer 路径） - Mac 上用 Homebrew 安装多版本时，
brew unlink php@7.4 && brew link php@8.1才真正切换php命令指向
Docker 中 PHP 版本和宿主机不一致，但容器内 php -v 显示正确，Web 却报错
问题大概率出在构建缓存或镜像分层，你以为用了新镜像，其实复用了旧层。
立即学习“PHP免费学习笔记（深入）”；
- 检查 Dockerfile 是否写了固定 tag，比如
FROM php:8.1-cli—— 这没问题；但若写成FROM php:latest，下次 build 可能拉到 8.3，而 composer.lock 锁死的是 8.1 依赖 - 运行
docker build --no-cache强制跳过缓存，避免 COPY . /app 后因某层未变导致后续 RUN apt-get install php8.1-mbstring 被跳过 - 进入容器后执行
php -m | grep mbstring，确认扩展真实加载了；很多错误不是版本错，是扩展没装 - 如果用
docker-compose，别忘了docker-compose down && docker-compose up --build，否则旧容器可能还在用旧镜像
Apache mod_php 和 php-fpm 混用导致版本混乱
Apache 既可以加载 libphp.so（模块模式），也可以反代给 php-fpm（FastCGI 模式），两者不能共存于同一虚拟主机，且配置完全隔离。
- 检查 Apache 是否启用了
php_module：apache2ctl -M | grep php，如果看到php7_module或php_module，说明走的是模块模式，此时php.ini路径由php -i | grep "Loaded Configuration File"决定 - 如果用了
ProxyPassMatch ^/(.*\.php(/.*)?)$ fcgi://127.0.0.1:9000/var/www/，那实际 PHP 版本取决于php-fpm进程启动时加载的配置，和 Apache 模块无关 - 一个典型坑：Ubuntu/Debian 上同时安装
libapache2-mod-php8.1和php8.1-fpm，但忘记禁用前者：a2dismod php8.1，结果 Apache 优先走了模块模式，压根没走 fpm
版本问题最难缠的地方，往往不是“找不到新版”，而是多个环境变量、PATH、shebang、配置文件路径、进程继承关系层层叠加，最终某个环节悄悄 fallback 到了老版本。每次怀疑版本不对，第一反应不应该是重装，而是立刻查清楚「这个具体进程到底执行的是哪个 php 二进制，加载的是哪份 php.ini，又连上了哪个 php-fpm socket」。
