composer报错“php version mismatch”是因为其执行依赖shell中php命令指向的版本，而非composer本身管理php版本；需通过切换php软链、显式指定php路径执行composer.phar或配置platform.php仅影响依赖解析而非运行时环境。
composer命令报错“PHP version mismatch”或直接拒绝执行
Composer 本身不管理 PHP 版本，它只是个 PHP 脚本，运行时完全依赖当前 shell 环境中 php 命令指向的解释器。所谓“切换 PHP 版本”，本质是让 composer 命令调用不同版本的 php 可执行文件。
常见错误现象：composer install 报错提示 “This package requires php ^8.2 but your PHP version (7.4.33) does not satisfy that requirement”，但你明明装了 PHP 8.2 —— 这说明 composer 正在用旧版 PHP 执行，而不是你期望的版本。
- 确认当前生效的 PHP 版本：
which php和php -v - 不要改
composer.phar文件头（如#!/usr/bin/env php），它不决定实际执行路径 - Mac 用户若用 Homebrew 安装多版本 PHP，
brew unlink php@8.1 && brew link php@8.2会更新php命令软链，但需重新打开终端或source ~/.zshrc - Linux 用户常用
update-alternatives --config php切换系统级默认 PHP，影响全局php和composer
想临时用某 PHP 版本跑 composer，又不想动系统默认设置
最可靠的方式是绕过 composer 命令别名，直接用目标 PHP 解释器执行 composer.phar。这适用于 CI/CD、多项目混用、或仅本次调试。
假设你已下载 composer.phar 到项目根目录，且本地有 /opt/homebrew/bin/php@8.2：
立即学习“PHP免费学习笔记（深入）”；
php@8.2 /path/to/composer.phar install
更通用的做法（尤其 Windows 或路径不固定时）：
- 先查清目标 PHP 路径：
which php82或ls -l $(which php)看软链指向 - Windows 下用完整路径，例如：
"C:\php\php-8.2.12\php.exe" composer.phar update - 别写成
php8.2 composer.phar—— 如果没配置php8.2命令，会报command not found - 这个方法完全绕过
composer的 shell alias 或 wrapper 脚本，100% 确定执行环境
composer global require 后命令找不到，或用了错误 PHP 版本
composer global require 安装的包（比如 laravel/installer）生成的可执行脚本，其第一行 #!/usr/bin/env php 仍绑定当前默认 php。即使你用 PHP 8.2 装了它，下次用 PHP 7.4 执行 laravel 命令，就会出兼容问题。
- 检查全局 bin 目录位置：
composer global config bin-dir --absolute - 进入该目录，用
head -1 laravel看 shebang 行，确认它是否真用了你想要的 PHP - 安全做法：不用
composer global，改用php82 /path/to/composer.phar global require，再手动把生成的脚本 shebang 改成#!/opt/homebrew/bin/php@8.2 - 或者彻底放弃 global，用
vendor/bin/laravel（项目内安装）+ 显式指定 PHP 版本执行
PHP 多版本共存时，composer.lock 中的 platform.config.php 没用？
platform.config.php 是给 Composer “假装” 当前环境 PHP 版本用的，只影响依赖解析阶段（比如 require 的 PHP 版本约束），**不影响实际执行时用哪个 PHP**。很多人以为设了它就能“骗过” composer，结果 install 成功了，run 脚本时还是报错 —— 因为 runtime 还是旧 PHP。
- 正确用途：CI 中锁定构建环境 PHP 版本，避免因本地 PHP 版本高导致误装高版本扩展
- 配置方式（
composer.json）："config": { "platform": { "php": "8.2.12" } } - 它不能解决
phpunit命令执行失败、phpstan报语法错误这类 runtime 问题 - 真正要跑起来，还得确保
vendor/bin/phpunit脚本的 shebang 或调用它的 shell 环境用了对应 PHP
最易被忽略的一点：很多团队用 Docker 或容器化开发，以为宿主机 PHP 版本不重要 —— 但只要你在宿主机敲 composer install，它就用宿主机的 php，和容器里完全无关。切版本前，先分清命令到底在哪跑。
