本地调试 Composer 包需主项目与本地包均声明 PHP 版本约束：主项目 require.php 写死最低版本（如 ">=8.1.0"），本地包也须声明自身兼容版本，否则依赖解析或运行时加载会失败。
本地调试 Composer 包时，PHP 版本约束必须分两层处理：主项目要声明真实运行环境要求（require.php），而本地包本身也得带自己的 php 约束；否则你改完本地包代码，一跑测试就因语法不兼容直接报错，根本来不及调试。
主项目 require.php 必须写死最低支持版本
这是硬性门槛。如果本地包用了 PHP 8.1 的枚举，但主项目的 composer.json 里没写 "php": "^8.1"，那么在 PHP 7.4 环境下执行 composer install 可能成功（尤其加了 --ignore-platform-reqs），但后续 vendor/autoload.php 加载时就会炸——因为 Composer 不校验运行时，只管安装阶段。
- 写
"php": ">=8.1.0"比"^8.1"更稳妥，避免某些包对^解析不一致 - 团队协作时，这个字段必须提交进 Git，不能靠口头约定或 CI 单独配置
- 执行前先确认
php -v和composer diagnose | grep "PHP binary"输出的路径一致，否则你以为在 8.2，实际用的是 7.4
本地包 composer.json 的 php 字段决定它自己能被装进去的条件
你写的本地包，如果 composer.json 里漏了 "php": "^8.0"，那即使主项目写了 "php": "^8.1"，Composer 在解析依赖时也可能跳过对该包的 PHP 兼容性检查——因为它压根没声明自己需要什么。
- 本地包的
php约束只影响“能否被主项目选中”，不影响主项目本身的运行时版本 - 建议和主项目保持一致或更严格，比如主项目是
^8.1，本地包可写^8.1 || ^8.2（注意：Composer 实际支持逗号分隔的交集，不支持||，所以应写成">=8.1.0, ） - 别依赖
config.platform.php来“绕过”本地包的php约束——它只作用于远程包版本选择，对本地path仓库无效
config.platform.php 对本地包完全不起作用
config.platform.php 是给 Packagist 上的包用的，目的是让 Composer 在解析时“假装”运行在某个 PHP 版本下，从而排除掉不兼容的远程版本。但它对 type: path 本地包无效——Composer 直接读你本地包 composer.json 里的 version 和 php 字段，不走平台模拟逻辑。
立即学习“PHP免费学习笔记（深入）”；
- 如果你在主项目里配了
"platform": {"php": "8.0.0"}，又试图调试一个用了match表达式的本地包（PHP 8.0 不支持），composer install不会报错，但运行时必崩 - 这种场景下，唯一靠谱的做法是：确保本地开发环境 PHP 版本 ≥ 本地包声明的最低版本
- CI 构建时若需多版本验证，应分别用不同 PHP 二进制执行
/path/to/php81 composer install，而不是靠 platform 配置
最常被忽略的一点：本地包的 php 字段不是摆设，它和主项目的 require.php 是两级校验。少写一个，就可能让语法错误拖到运行时才暴露，而不是在 composer update 阶段就被拦住。
