Composer install 不支持 --php-version 参数，正确做法是通过 config.platform.php 声明目标PHP版本（如"7.4.33"），并执行 composer update --lock 使锁文件同步生效；临时覆盖可用 --platform=php:8.0.28 或 COMPOSER_PLATFORM_CHECK=0 配合 config 设置。
Composer install 本身不支持指定 PHP 版本
直接运行 composer install --php-version 8.1 会报错 —— composer install 命令根本没有 --php-version 这个参数。Composer 不负责切换或模拟 PHP 版本，它只读取当前运行环境的 PHP_VERSION，并据此检查 platform 配置和依赖兼容性。
真正起作用的是 composer.json 中的 platform 配置
当你想让 composer install 安装适配特定 PHP 版本的依赖（比如在 PHP 8.2 环境下装出 PHP 7.4 兼容的包），必须提前在 composer.json 里声明目标平台：
{
"config": {
"platform": {
"php": "7.4.33"
}
}
}
这样 Composer 就会假装自己运行在 PHP 7.4.33 下，只选择满足 "php": "^7.4" 的依赖版本（包括扩展如 ext-json、ext-mbstring 的版本约束）。
- 该配置仅影响依赖解析，不改变实际执行的 PHP 版本
- 修改后需运行
composer update --lock或删掉composer.lock再composer install才生效 - 如果项目已存在
composer.lock，且其中记录了更高版本 PHP 的依赖，则仅改platform不会自动降级 —— 必须强制重解（composer update --lock）
临时覆盖 platform 的快捷方式：使用环境变量
不想改 composer.json？可以用 COMPOSER_PLATFORM_CHECK 配合 config 命令临时生效：
立即学习“PHP免费学习笔记（深入）”；
COMPOSER_PLATFORM_CHECK=0 composer config platform.php 8.0.30 && composer install
但更干净的做法是单次覆盖：
composer install --ignore-platform-reqs && composer install --no-scripts
⚠️ 注意：--ignore-platform-reqs 是「跳过所有平台检查」，风险高 —— 它可能装入不兼容的扩展或函数（比如装了要求 ext-gd 但系统没启用），不如明确设 platform 可控。
-
COMPOSER_PLATFORM_CHECK=0只禁用检查，不设置目标版本 - 真正指定版本仍要靠
config platform.php X.Y.Z或composer.json配置 - CI 场景推荐写死在
composer.json里，避免环境变量遗漏
PHP 版本不匹配时的典型错误现象
常见报错不是“找不到 PHP”，而是依赖安装失败或运行时报错：
-
Your requirements could not be resolved to an installable set of packages.—— 因为 lock 文件记录了 PHP 8.2 下的包，但当前环境是 7.4，且没设platform -
Class "JsonException" not found——composer install装了依赖于 PHP 7.3+JsonException的包，但实际运行在 7.2 -
ext-mbstring is missing——platform没声明，Composer 检测到当前 PHP 缺扩展，直接中止
这些都不是 composer install 自身能“指定版本”解决的，本质是协调声明、锁文件、运行环境三者的一致性。最容易被忽略的是：改了 platform 后忘记更新 lock 文件，导致 install 仍沿用旧解析结果。
