Composer 运行依赖当前 shell 环境的 php 命令，需通过调整 PATH（如 export PATH="/opt/php/8.1/bin:$PATH"）或使用完整路径调用指定 PHP 版本，而非修改软链接或依赖 composer.json 的 platform 配置。
怎么让 Composer 用指定 PHP 版本执行？
Composer 本身不管理 PHP 版本，它只是个 PHP 脚本，运行时完全依赖当前 shell 环境的 php 命令指向哪个可执行文件。所以关键不是“配置 Composer”，而是控制它启动时调用的 php。
最直接有效的方式是：在运行 composer 前，临时把目标 PHP 的路径加到 PATH 开头。
- 比如你装了 PHP 8.1 在
/opt/php/8.1/bin/php，就先执行export PATH="/opt/php/8.1/bin:$PATH"，再跑composer install - 验证是否生效：运行
which php和php -v，确认输出是你想要的版本 - 别只改
php软链接——很多系统（如 Ubuntu 的update-alternatives）会覆盖你的修改，且影响全局，不安全
为什么 composer --version 显示的 PHP 版本和 php -v 不一致？
这种现象说明 Composer 正在用某个“隐藏”的 PHP 执行，常见于以下情况：
- 你用了
sudo composer：root 用户的PATH和当前用户不同，sudo默认不继承PATH，可能 fallback 到系统默认 PHP（如 Debian 的/usr/bin/php） - 你通过 alias 或 wrapper 脚本调用
composer，而该脚本内部硬编码了php路径 - 某些 IDE 或 CI 工具（如 PhpStorm、GitLab CI）有自己的环境变量隔离机制，没同步你的 shell 配置
排查方法：在出问题的上下文中直接运行 which php 和 composer show --platform | grep php，对比两者差异。
立即学习“PHP免费学习笔记（深入）”；
能否在 composer.json 里强制限定 PHP 版本？
可以声明兼容性，但不能控制运行时所用的 PHP 解释器。
"config": {"platform": {"php": "8.2.10"}} 这类配置只影响依赖解析逻辑（比如让 Composer 当作“当前是 PHP 8.2”来选包），不改变实际执行命令的 PHP 版本。
- 真正起作用的是运行
composer install时的php可执行文件 -
platform.php对require中的ext-xxx扩展检查也无效——扩展是否存在，取决于真实 PHP 加载了哪些 .so - 如果你需要构建多版本兼容包，应该用不同 PHP 环境分别跑
composer install+vendor/bin/phpunit，而不是靠配置欺骗
Mac 上用 Homebrew 多 PHP 版本时怎么快速切换？
Homebrew 安装的 PHP 通常以 php@8.1、php@8.2 形式存在，它们不会自动注册到 PATH，需要手动链接。
- 先
brew unlink php清掉当前链接 - 再
brew link php@8.2（或你想用的版本），这会在/opt/homebrew/bin/（Apple Silicon）或/usr/local/bin/（Intel）生成php软链接 - 注意：每次
brew link都会覆盖全局php，不适合并行开发；更稳妥的做法是不 link，改用完整路径调用：/opt/homebrew/bin/php@8.2 /opt/homebrew/bin/composer install
复杂点在于：有些项目依赖 php-config 或 pear，它们路径和主 php 不一定同步，得一起检查 which php-config。
