config.platform必须写在composer.json的config对象内，如"config": {"platform": {"php": "8.1.25", "ext-mbstring": "*"}}，仅影响install/update阶段依赖解析，不改变运行时行为；写错位置、漏配扩展或未删lock/vendor均导致失效。
config.platform 必须写在项目 composer.json 的 config 里
很多人把 platform 配成独立文件，或塞进全局配置（比如 composer config -g platform.php 8.1），结果 CI 跑不通、同事本地装不上。根本原因：只有项目根目录 composer.json 中的 "config": { "platform": { ... } } 才会被 Composer 读取并提交到 Git，CI 和团队成员才能一致生效。
错误写法示例：
-
"config.platform.php": "8.1.25"（字段名不存在） -
"platform": { "php": "8.1.25" }写在顶层，没嵌套进"config" - 往
~/.composer/config.json里硬加platform（污染全局，且无法版本控制）
验证是否生效，运行：
composer config --list | grep platform
看到输出带 (local) 标记才算对。
只设 php 版本不够，扩展必须手动列全
config.platform 不读你本地 php.ini，它只认你明确写进去的项。哪怕你写了 "php": "8.1.25"，但没声明 "ext-sodium": "*"，而某个依赖要求 "ext-sodium": "*"，composer install 就会直接失败。
常见必须补全的扩展（名称严格为 ext-xxx）：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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-zip": "*"
版本号填 * 可行，但建议填具体值（如 "8.1.25"），避免某些包校验逻辑误判——例如 ext-gd 在 Alpine 上常报版本不匹配，填 "8.1.25" 比 "*" 更稳。
用 composer check-platform-reqs 做主动体检，不是等 install 报错才反应
composer check-platform-reqs 是唯一能提前暴露环境缺口的命令。它不走依赖解析，只比对 composer.json 中的 require 和 config.platform，再对照当前 CLI 环境（php -v 和 php -m）。
典型问题场景：
- 报
ext-gd * missing，但php -m | grep gd显示存在 → 很可能是 CLI 和 Web SAPI 使用不同php.ini，查php -i | grep "Loaded Configuration File" - 没配
config.platform，但check-platform-reqs却显示 OK → 因为它只检查require里显式写的平台包（如"php": ">=8.1"），如果require里根本没写，它就“看不见”真实需求 - 输出
php: 8.2.12 does not satisfy php ^8.3→ 先确认是不是config.platform写错了小数点（比如"8.3.0"写成"8.3.00"），而不是急着升级 PHP
--ignore-platform-reqs 是临时止痛药，不是解药
遇到 Your requirements could not be resolved 就加 --ignore-platform-reqs？这等于让 Composer 盲装——可能装上 PHP 8.2 才有的 match 表达式，部署到 PHP 8.1 服务器直接 Fatal error: Uncaught Error: Call to undefined function。
仅限以下两种情况使用：
- 调试阶段：确认问题是否真出在
platform配置上，用完立刻删掉 - CI/CD 构建中绝对禁用：它绕过所有平台约束，失去提前发现兼容性问题的意义
真正该做的是：对照生产环境执行 php -v 和 php -m 输出，把 config.platform 补完整。最容易被忽略的一点：platform 不影响运行时行为，只影响 install/update 阶段的依赖解析——哪怕你设成 "php": "7.4.0"，本地 PHP 8.3 依然能跑起来，但只要某行代码用了 match，PHP 7.4 环境就必然崩。
