Composer不提供--php-version开关，其PHP版本由实际调用的php二进制文件决定；确认方式为composer --version（首行显示真实PHP路径与版本）或head -1 $(which composer)查shebang；临时指定需直接以目标php路径运行composer命令，如/usr/bin/php8.1 /usr/local/bin/composer install。
Composer 本身不提供 --php-version 或类似开关来“指定” PHP 版本，它完全依赖当前 shell 调用的 PHP 解释器。所谓“用 PHP 8.1 运行 Composer”，本质是让 composer 命令启动时，背后执行的是 php8.1 二进制文件，而不是系统默认的 php。
怎么确认 Composer 正在用哪个 PHP？
别信 php -v ——它只反映当前 shell 的默认 PHP。Composer 可能绑着另一个。最准的方法只有两个：
-
composer --version：第一行会明确写出它用的 PHP 路径和版本（例如PHP 8.2.5 (cli)） -
head -1 $(which composer)：查 shebang 行，比如#!/usr/bin/env php或#!/usr/bin/php8.1，这直接决定它调用谁
临时用 PHP 8.1 运行 composer install/update
这是最干净、最可控的方式，绕过所有 PATH、alias、shebang 干扰，CI/CD 脚本里也最可靠：
- Linux/macOS：
/usr/bin/php8.1 /usr/local/bin/composer install - macOS Homebrew 用户：
/opt/homebrew/bin/php@8.1 /usr/local/bin/composer update（注意带@） - Windows：
C:\php-8.1\php.exe composer install - 如果用
composer.phar，确保有执行权限：chmod +x composer.phar，再运行/usr/bin/php8.1 ./composer.phar update
composer.json 里写 "php": "^8.1" 是干什么的？
它只在 composer install 或 composer update 阶段做一次校验，不是运行时锁死机制：
立即学习“PHP免费学习笔记（深入）”；
- 写在
require下才生效（不是config或require-dev） - 作用是阻止在不满足版本的环境中安装依赖，比如你在 PHP 7.4 下执行
composer install，会直接报错 - 它不影响运行时行为——哪怕你用 PHP 7.4 执行
vendor/autoload.php，也不会自动拦截；语法错误或扩展缺失仍会崩 - 写成
"php": "8.1"或"php": "8.1.*"会被忽略，必须用^8.1或>=8.1.0
config.platform.php 是“假装 PHP 8.1”，不是“强制使用 PHP 8.1”
这个配置只影响依赖解析逻辑，常见于 CI 场景，但容易被误用：
- 正确写法：
"config": { "platform": { "php": "8.1.10" } }（必须是完整小版本号，"^8.1"无效） - 效果：即使你本地是 PHP 7.4，Composer 也会按 8.1.10 解析依赖，生成适配 8.1 的
composer.lock - 风险：它不解决运行时问题——若某个包用了
str_contains()（PHP 8.1+），而你本地 PHP 是 8.0，运行时照样 fatal error - 必须配合删掉
composer.lock和vendor/后重装，否则旧锁文件会覆盖 platform 配置
最容易被忽略的一点：修改 require.php 或 config.platform.php 后，不删 composer.lock 就跑 composer install，几乎等于没改——因为锁文件会锁定旧解析结果。
