Composer不支持运行时自动切换依赖分支，需通过显式指定PHP二进制（如/usr/bin/php8.1 composer install）或配置config.platform.php在安装时控制依赖解析，且不同PHP版本必须对应独立的composer.lock和vendor/目录。
Composer 本身不支持“运行时根据 PHP 版本自动切换依赖分支”，它只做一次性的依赖解析，且解析结果固化在 composer.lock 中。所谓“动态切换”，本质是人为控制解析环境（PHP 版本 + platform 配置），让 Composer 在不同上下文中生成不同的锁文件和 vendor 目录。
composer install 报 “PHP version does not satisfy requirement” 怎么办
这不是配置没生效，而是当前 CLI 的 php 命令版本和 composer.json 中 "php": "^8.1" 不匹配。比如你 php -v 输出的是 7.4.33，但项目要求 PHP 8.1+，composer install 就会直接退出。
- 先验证真实运行环境：
composer --version第一行会显示它实际调用的 PHP 路径和版本，比php -v更准 - 别依赖
composer config platform.php "8.1"来绕过这个错误——它只影响包选择逻辑，不改变校验环节 - 临时解决：直接用目标 PHP 二进制执行，例如
/usr/bin/php8.1 /usr/local/bin/composer install
config.platform.php 是“编译期欺骗”，不是运行时开关
config.platform.php 只在 composer update 或首次 install 时起作用，告诉依赖求解器：“请按 PHP 8.1 的能力选包”。但它完全不干预以下行为：
-
vendor/autoload_static.php的生成仍由你真实的 PHP 版本决定（PHP 8.3 下生成的文件可能含match表达式，在 PHP 8.1 下直接 ParseError） - 扩展检查（如
"ext-mbstring": "*"）仍走真实环境——platform 设成 8.1，但当前 PHP 没开 mbstring，照样失败 - CI/CD 中若用 PHP 8.1 构建，本地用 8.3 开发，仅靠 platform 无法复现构建结果
如何让同一份代码适配 PHP 7.4 和 8.0+ 的依赖
关键不是让 Composer “动态判断”，而是提前约定好兼容策略，并通过工具链强制落地：
立即学习“PHP免费学习笔记（深入）”；
- 在
composer.json的require中写宽泛约束，例如"monolog/monolog": "^1.25 || ^2.0"，让 Composer 自动选符合当前 PHP 版本的分支 - 若某包自身声明了
"php": "^7.2"（v1.x）和"php": "^8.0"（v2.x），Composer 会按你当前 PHP 版本自动匹配 - CI 流水线中显式设置 platform 并清理缓存：
composer config --unset config.platform.php && composer install，避免旧 lock 文件污染 - 不同 PHP 版本必须对应独立的
vendor/和composer.lock—— 切换 PHP 后不删它们，autoload 就会出错
为什么不能靠 dev-main 或分支名实现 PHP 版本路由
分支名（如 dev-main）和 PHP 版本没有绑定关系。Composer 不会因为当前 PHP 是 8.2 就自动拉 dev-php82 分支——它根本不知道这种命名规则。
- 分支切换必须显式触发：
composer require vendor/package:dev-main --stability=dev - 漏写
dev-前缀是 90% 的失败原因，main不是合法版本字符串 - 私有分支需先在
repositories中声明 VCS 地址，否则 Composer 看不到 - 真正起作用的是包自身的
composer.json中对php的约束，不是你拉哪个分支
最易被忽略的一点：同一个 composer.lock 文件不能跨 PHP 版本复用。哪怕你只改了 config.platform.php，只要 PHP 解释器变了，就必须重装 vendor —— 因为 autoload 文件、opcache 兼容性、甚至扩展加载顺序都可能不同。
