Composer 默认使用环境变量 PHP_BINARY 指定的 PHP，未设置时才查 PATH 中的 php；常见报错如 enum 语法错误却显示 php -v 为 8.2，即因 PHP_BINARY 指向旧版本。
composer 命令默认用哪个 PHP？
它不看系统 PATH 里排第一的 PHP，而是优先读环境变量 PHP_BINARY；没设的话，才去查 php 命令——也就是你终端敲 php -v 那个。很多“明明装了 PHP 8.2，composer 却报 7.4 错误”的问题，根源就在这儿。
常见错误现象：composer install 报 ParseError: syntax error, unexpected token "enum"（PHP 8.1+ 才支持 enum），但 php -v 显示的是 8.2——说明 composer 没走你看到的那个 PHP。
实操建议：
- 先运行
echo $PHP_BINARY（Linux/macOS）或echo %PHP_BINARY%（Windows），确认它是否被意外设成了旧版本路径 - 临时覆盖：直接在命令前加
PHP_BINARY=/usr/bin/php8.2 composer install - 永久生效（推荐）：把
export PHP_BINARY=/usr/bin/php8.2加到你的~/.bashrc或~/.zshrc
用 composer 指定 PHP 版本执行单条命令
不是改全局配置，而是让某次 composer require 或 composer update 强制走特定 PHP 解释器。这在多版本共存、CI 脚本或测试兼容性时最常用。
立即学习“PHP免费学习笔记（深入）”；
关键点：不能靠 php /path/to/composer.phar xxx——因为 composer.phar 内部仍会调用系统 php 执行 autoload 或插件，可能二次触发版本错配。
实操建议：
- 用
env PHP_BINARY=/usr/bin/php8.1 composer update（Linux/macOS） - Windows 下用
set PHP_BINARY=C:\php\php81\php.exe && composer update - 验证是否生效：在命令后加
--version并观察输出里的 PHP 版本提示（composer 2.5+ 会在启动时打印）
composer.json 里声明 PHP 版本只是校验，不改变运行环境
"config": { "platform": { "php": "8.2.0" } } 这段只影响依赖解析逻辑（比如不让它选只兼容 PHP 8.3 的包），**完全不会让 composer 自己换 PHP 解释器来跑**。很多人设了这个还报错，就是混淆了“声明要求”和“指定执行环境”。
容易踩的坑：
- 以为设了
platform.php就能绕过本地 PHP 版本限制——不行，autoload和脚本仍由当前 PHP 执行 - 在 GitHub Actions 等 CI 中，仅靠
platform声明无法通过 PHP 语法检查，必须配合setup-php动作或手动指定PHP_BINARY - 某些插件（如
hirak/prestissimo）会 fork 子进程，此时子进程也继承PHP_BINARY，所以设对这个变量比改platform更底层、更可靠
Windows 下 php.exe 路径含空格导致 composer 启动失败
典型错误信息：'C:\Program' is not recognized as an internal or external command。这是因为 Windows 的 cmd 对带空格路径处理不严谨，而 composer 在调用 PHP_BINARY 时没自动加引号。
实操建议：
- 避免使用
C:\Program Files\php\这类路径，改用C:\php82\等无空格路径 - 如果必须用，设置
PHP_BINARY时**不要加引号**（set PHP_BINARY=C:\Program Files\php\php.exe），让 composer 内部逻辑自己处理；加了引号反而会出错 - PowerShell 用户注意：
$env:PHP_BINARY="C:\php82\php.exe"有效，但别用单引号包裹路径，否则变量不展开
composer run-script）、插件、甚至某些 autoload 生成逻辑，都依赖同一个 PHP_BINARY 值——设错一处，整条链路都可能降级。 
