composer 默认使用 shell 环境中 which php 返回的 php 版本，不会因 composer.json 中 platform.php 配置自动切换解释器，该配置仅约束依赖解析；运行时 php 版本需与 web server 或 cli 实际使用的版本一致。
composer 命令默认用哪个 PHP？
Composer 本身是 PHP 脚本，运行时依赖当前 shell 环境的 php 可执行文件。也就是说，composer install 实际调用的是 which php 返回的那个 PHP —— 和你终端里直接敲 php -v 显示的版本一致。
它**不会自动读取项目里的 phpversion 或 platform 配置来切换解释器**，那些只是给依赖解析用的约束条件。
- 常见错误：改了
composer.json里的"platform": {"php": "8.1"}，就以为 composer 会自动切到 PHP 8.1 执行 —— 不会，它只影响包版本选择 - 真正生效的前提：你系统里得有对应版本的 PHP 二进制，并且能被
PATH正确找到 - macOS 用户尤其注意：Homebrew 安装的
php@8.1默认不替换/usr/bin/php，需要手动brew link php@8.1 --force或用绝对路径调用
用绝对路径强制指定 PHP 版本运行 composer
最直接、最可靠的方式：绕过环境变量，显式调用目标 PHP 解释器执行 composer.phar。
例如你本地装了 PHP 7.4 和 8.2，想用 7.4 安装一个老项目：
立即学习“PHP免费学习笔记（深入）”；
/usr/local/bin/php7.4 /usr/local/bin/composer install
关键点：
-
php7.4必须是可执行文件（不是软链接失效或权限不足）；可用/usr/local/bin/php7.4 -v先验证 -
composer如果是全局安装的 shell wrapper（比如通过curl -sS https://getcomposer.org/installer | php后移动的），要确保它没硬编码调用php，否则 wrapper 会再次走默认 PHP —— 推荐直接用composer.phar文件 - Windows 用户路径写法：
C:\php\php74\php.exe C:\tools\composer.phar install
用 alias 或 shell 函数简化多版本切换
频繁切换时，每次输全路径太累。可以在 shell 配置（如 ~/.zshrc）里加几个快捷命令：
alias composer74='/usr/local/bin/php7.4 ~/bin/composer.phar' alias composer81='/usr/local/bin/php8.1 ~/bin/composer.phar' alias composer82='/usr/local/bin/php8.2 ~/bin/composer.phar'
然后就能直接：composer74 update 或 composer82 install。
更进一步，可以写个函数自动识别项目 composer.json 中的 platform.php 并匹配本地 PHP：
function c() {
local platform_php=$(grep -o '"php": "[^"]*"' composer.json 2>/dev/null | cut -d'"' -f4 | head -n1)
if [ -n "$platform_php" ]; then
local php_bin=$(which php$platform_php 2>/dev/null)
if [ -x "$php_bin" ]; then
$php_bin ~/bin/composer.phar "$@"
return
fi
fi
php ~/bin/composer.phar "$@"
}
这个函数不是万能的（比如 platform.php 写的是 "8.1.10"，但你只有 php8.1），但它覆盖了大多数语义化版本场景。
为什么 vendor/autoload.php 运行时报错和 composer 指定的 PHP 版本无关？
这是最容易混淆的一点：composer 安装依赖时用的 PHP 版本，和后续项目代码（比如 index.php）加载 vendor/autoload.php 时用的 PHP 版本，**完全是两回事**。
举例：
- 你用 PHP 8.2 运行
composer install，生成了支持 PHP 8.2 的vendor/ - 但 Apache 或 Nginx 配置的是 PHP 7.4 的模块 —— 那么访问页面时，
autoload.php就会在 PHP 7.4 下执行，可能因语法不兼容直接报ParseError - 反过来，用低版本 PHP 装的包，高版本运行通常没问题（向后兼容），但低版本跑高版本装的包，很可能失败（比如用了 PHP 8.1 的枚举类，PHP 7.4 根本不认识）
所以，真正要对齐的，是「composer 安装时的 PHP」 + 「Web Server / CLI 运行时的 PHP」—— 两者必须都满足 composer.json 中声明的 require.php 和实际代码语法要求。
