Composer 唯一真正生效的 PHP 路径控制方式是 PHP_BINARY 环境变量，它优先于系统 PATH 和 platform.php 配置，决定实际执行的 PHP 解释器版本。
Composer 本身没有“设置 PHP 路径”的配置入口，它不读取任何 config 文件来决定用哪个 php 启动自己——实际调用的 PHP 解释器由环境变量或命令行显式控制。
PHP_BINARY 环境变量是唯一真正生效的绑定方式
Composer 在启动时优先检查 PHP_BINARY 环境变量；如果设了，就直接用它指定的路径执行自身逻辑（包括 autoload、插件、脚本等）；没设才 fallback 到 php 命令。
- 临时生效（推荐调试用）：
PHP_BINARY=/usr/bin/php8.2 composer install - Linux/macOS 永久生效：在
~/.zshrc或~/.bashrc中加export PHP_BINARY=/usr/bin/php8.2，然后source一下 - Windows 永久生效：系统属性 → 环境变量 → 新建用户/系统变量
PHP_BINARY，值填C:\php-8.2\php.exe（注意路径必须存在且可执行） - 验证是否生效：
composer --version输出第一行会明确写 “PHP 8.2.x (cli)”，不是php -v的结果
别信 composer config --global platform.php
这个配置只影响依赖解析阶段的“版本模拟”，比如告诉 Composer：“假装我在 PHP 8.1 上运行”，从而允许安装要求 "php": "^8.1" 的包。但它完全不改变实际执行 composer install 时调用的是哪个 php 二进制文件。
- 现象：设了
platform.php=8.3，但composer install报ParseError: typed property—— 因为底层 PHP 实际是 7.4 - 本质：它只是个约束过滤器，不是解释器切换开关
- 该值存于
~/.composer/config.json，对协作项目无意义，CI 中也起不到真实兼容性验证作用
Windows 上 composer.bat 是个硬编码陷阱
官方 Windows 安装包附带的 composer.bat 是个批处理文件，内部固定写死调用 php，完全忽略 PHP_BINARY 和 PATH 变更。
立即学习“PHP免费学习笔记（深入）”；
- 验证方法：用记事本打开
composer.bat，搜php "，你会看到类似php "%~dp0composer.phar" %*的行 - 最稳解法：删掉
composer.bat，改用php C:\tools\composer.phar install，或在 PowerShell 里定义函数：function composer { php C:\tools\composer.phar @args } - 次选方案：手动编辑
composer.bat，把php替换成带引号的绝对路径，例如"C:\php-8.2\php.exe"（路径含空格时双引号不可少）
PhpStorm 里配的是 CLI 路径，不是 PHP_BINARY
PhpStorm 的 Settings → PHP → Composer → Path to composer.phar 填的是一个可执行入口，它本身不控制 PHP 版本；真正起作用的是你为该项目配置的 Project SDK（即 PHP 解释器路径）。
- 填错常见表现：
Cannot find composer.phar是因为路径指向了下载链接或相对路径，而不是实际可执行文件（如/usr/local/bin/composer或C:\ProgramData\ComposerSetup\bin\composer.bat） - 即使这里填对了，如果 Project SDK 指向的是 PHP 7.4，那右键 “Composer → Install” 执行时仍会用 7.4，可能报语法错误
- 多版本切换时，建议在 PhpStorm 终端里先手动确认：
which php和echo $PHP_BINARY，再对应调整 SDK 和环境变量
真正容易被忽略的是：Composer 运行过程中可能 fork 子进程（比如某些插件、post-install-cmd 脚本），这些子进程默认继承父进程的 PHP_BINARY —— 所以设对这个变量比改 platform.php 或 shebang 更底层、更可靠。
