php版本冲突指开发、线上、ci/cd或docker中实际运行的php可执行文件版本不一致，导致语法错误、扩展缺失或函数行为差异；需通过which php、php -i、phpinfo()、docker镜像标签等精准定位并统一各环节版本。
PHP 版本冲突通常指什么
不是代码里写了两个 PHP 版本，而是你本地开发环境、线上服务器、CI/CD 流水线或 Docker 容器中实际运行的 php 可执行文件版本不一致，导致：ParseError（比如用了 match 表达式但服务器是 PHP 7.4）、扩展缺失（ext-json 在 PHP 8.0+ 默认启用，旧版需手动开）、函数行为差异（str_contains() 在 8.0 才加入）。
检查当前 PHP 版本和实际生效路径
别只信 php -v，它可能被 alias、PATH 顺序或 shell 缓存干扰。必须确认真实调用链：
- 运行
which php查看命令实际指向 - 运行
php -i | grep "Configuration File"看加载的php.ini路径，再检查该 ini 中是否启用了必要扩展 - 在 Web 环境中，建个
info.php文件写<?php phpinfo(); ?>，直接看 Apache/Nginx 下实际加载的模块和版本 - 如果用 Docker，进容器执行
php -v和ls -l $(which php)，确认基础镜像版本（如php:8.2-apachevsphp:7.4-cli）
多版本共存时如何精准指定
Mac 用户常用 brew install php@8.1、php@8.2，但 php 命令默认只指向最新版。要强制使用某版本：
- 临时切换：
export PATH="/opt/homebrew/opt/php@8.1/bin:$PATH"（Mac Intel 路径为/usr/local/opt/php@8.1/bin） - 永久生效：把上面 export 加到
~/.zshrc或~/.bash_profile，然后source它 - Web 服务中指定：Apache 需改
LoadModule指向对应libphp.so；Nginx + PHP-FPM 则改fastcgi_pass指向对应版本的 socket 或端口（如127.0.0.1:9081对应 PHP 8.1 FPM） - Composer 项目级约束：在
composer.json的"config": {"platform": {"php": "8.1.10"}}可模拟目标环境，避免装错扩展版本
CI/CD 或部署脚本中避免隐性版本漂移
GitHub Actions、GitLab CI、Jenkins 等环境默认 PHP 版本常会升级，导致昨天能过的构建今天失败。
立即学习“PHP免费学习笔记（深入）”；
- GitHub Actions 显式声明：
uses: shivammathur/setup-php@v2+with: { php-version: '8.1' } - GitLab CI 使用
image: php:8.1-cli，而非php:latest - Shell 部署脚本里加校验：
if [[ $(php -v | head -1 | cut -d' ' -f2 | cut -d'.' -f1,2) != "8.1" ]]; then echo "PHP version mismatch"; exit 1; fi - Dockerfile 中禁止写
FROM php:latest，必须写死小版本号，如FROM php:8.1.25-apache（注意：PHP 官方镜像 tag 支持精确小版本）
php -v、php -m | grep pdo、php -r "echo str_contains('abc', 'a');" 这三件事。 
