Composer实际使用的PHP版本由启动它的php二进制文件决定，确认方式为composer --version首行输出或head -1 $(which composer)查shebang；临时指定需用绝对路径调用如/usr/bin/php8.1 /usr/local/bin/composer install，或设PHP_BINARY环境变量。
Composer 本身不“安装” PHP，它只依赖当前 shell 调用的 php 可执行文件；所谓“指定 PHP 路径”，本质是控制 Composer 进程启动时绑定哪个解释器——不是改配置、不是写 composer.json、也不是靠 php -v 判断。
怎么确认 composer 正在用哪个 PHP？
别信 php -v，它只反映当前 shell 默认的 PHP。真正生效的是 Composer 启动时实际加载的那个二进制：
- 运行
composer --version，第一行会明确输出类似PHP 8.2.5 (cli)—— 这才是它正在用的版本和环境 - 查 shebang：
head -1 $(which composer)，看是否硬编码了路径（如#!/usr/bin/php8.1） - 对比
which php和which composer输出路径是否一致；不一致说明环境错位 - 直接问：
composer diagnose | grep "PHP binary"，它会告诉你内部读取到的解释器路径
临时指定 PHP 路径运行 composer install/update（最常用）
这是开发调试、CI/CD 中最干净可控的方式：绕过所有 PATH、alias、shebang 干扰，强制用你指定的解释器启动整个进程（含 autoload、插件、scripts）：
- Linux/macOS：
/usr/bin/php8.1 /usr/local/bin/composer install（注意两个路径都必须是绝对路径） - macOS Homebrew 用户常见路径：
/opt/homebrew/bin/php@8.1 /opt/homebrew/bin/composer update - Windows：
"C:\php\php-8.2\php.exe" composer.phar install（路径含空格必须加英文引号） - 如果用
composer.phar，先确保可执行：chmod +x composer.phar，否则调用失败
PHP_BINARY 是唯一真正起效的环境变量
PHP_BINARY 是 Composer 内部唯一识别并用于自身执行逻辑的 PHP 路径变量，优先级高于系统 PATH 和 shebang：
立即学习“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第一行必须显示对应版本 - 注意：
composer.bat（Windows 官方安装包自带）会无视PHP_BINARY，因为它硬编码调用php "%~dp0composer.phar"；稳妥解法是删掉composer.bat，改用php C:\tools\composer.phar install
config.platform.php 只骗依赖解析，不换解释器
"config": {"platform": {"php": "8.1.0"}} 的作用仅限于 composer update 阶段：让 Composer “假装”运行在 PHP 8.1 下，从而选兼容的包版本。但它完全不改变 Composer 自身的运行环境，也不影响 vendor 中生成的代码语法兼容性：
- 版本号必须是完整字符串，如
"8.1.0"，不能写"^8.1"或"8.1"，否则失效 - 对
composer install无影响（它只读composer.lock），所以生产机上即使php -v显示 8.3，只要 lock 文件锁的是 8.1 兼容包，就能跑 - 真实缺失扩展仍会崩：设了
"ext-gd": "8.1.0"，但系统没装 gd 扩展，运行时调用imagecreate()还是报Call to undefined function - scripts 里写的
"test": "php tests/run.php"不走PHP_BINARY或COMPOSER_PHP，因为那是 fork 出的新 shell；正确写法是显式路径："test": "/usr/bin/php8.1 tests/run.php"
最容易被忽略的一点：composer --version 和 php -v 输出不一致时，问题一定出在启动链上——可能是 sudo 丢掉了 PATH、IDE 自带终端隔离了环境、或 composer.bat 硬编码覆盖了所有变量。验证永远要从进程启动那一刻开始，而不是看配置写了什么。
