config.platform是唯一靠谱的项目级php环境“模拟”方式，它不改本地php，仅让composer在install/update时按目标环境选包；必须写在composer.json的config字段内，显式声明php版本和所有依赖扩展，否则会导致线上崩溃。
直接说结论：config.platform 是唯一靠谱的项目级 PHP 环境“模拟”方式，它不改你本地 PHP，只让 Composer 在 install/update 时按目标环境选包——写错位置、漏配扩展、混用 --ignore-platform-reqs，都会导致线上崩。
config.platform 必须写在 composer.json 的 config 里
很多人把 platform 写成独立文件、塞进全局配置、或丢到 composer.json 根级，结果 CI 跑通本地报错，或者队友装的包版本不一致。原因很简单：config.platform 只在项目根目录的 composer.json 中、嵌套于 "config": { "platform": { ... } } 下才稳定生效。
- ✅ 正确位置：
composer.json同级于require和autoload，且必须是"config"的子字段 - ❌ 错误写法：
"platform": {...}（根级）、"config.platform.php": "8.1"（不存在的字段）、composer config -g platform.php 8.1（污染全局） - ? 验证是否生效：运行
composer config --list | grep platform，看到带(local)标记才算对
只设 php 版本不够，扩展必须手动列全
config.platform 不读你本地 php.ini，它只认你明明白白写进去的项。设了 "php": "8.1.25"，不代表 ext-mbstring 或 ext-sodium 就自动“存在”。一旦某个包 require "ext-sodium": "*"，而你没声明，composer install 就会失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- ✅ 必须补全常见扩展：
"ext-mbstring": "*"、"ext-openssl": "*"、"ext-json": "*"、"ext-pdo": "*"、"ext-pdo_mysql": "*" - ⚠️ 扩展名严格是
ext-xxx，不是php-xxx或xxx - ? 版本号填
*可行，但建议填具体值（如"8.1.25"），避免某些包校验逻辑误判
--ignore-platform-reqs 是止痛药，不是解药
遇到 Your requirements could not be resolved 就加 --ignore-platform-reqs？这等于让 Composer 盲装——可能装上 PHP 8.2 才有的函数调用，部署到 PHP 8.1 服务器直接 Fatal error: Call to undefined function。
- ✅ 仅限调试：确认问题是否真出在 platform 配置上，用完立刻删掉
- ❌ CI/CD 构建绝对禁用：它绕过所有平台约束，失去提前发现兼容性问题的意义
- ? 真正该做的是：对照生产环境
php -v和php -m输出，把config.platform补完整
platform 不影响运行时，只管依赖解析
哪怕你设成 "php": "7.4.0"，本地 PHP 8.3 依然能跑起来——但只要某行代码用了 match 表达式，PHP 7.4 环境就必然崩。这是最容易被忽略的一点：platform 只控制 install 和 update 阶段的依赖选择，它不拦截语法错误、不替换函数、不加载 polyfill。
- ⚠️
symfony/polyfill-gd这类包虽然 provideext-gd，但它只覆盖函数，不提供 GDImage 类型或资源句柄——强依赖扩展行为的代码，仍需真实扩展 - ? 若必须兼容低版本，应把扩展依赖功能隔离（如缓存驱动抽成接口），或 fallback 到无扩展实现（如文件缓存）
- ? 检查实际生效 platform：运行
composer show -p，确认没被命令行参数或环境变量意外覆盖
