Composer不支持操作系统感知，仅通过config.platform模拟PHP环境（版本+扩展）影响依赖解析；它绕过本地缺失扩展的安装报错，但无法解决运行时兼容问题，如Windows上ext-pcntl不可用仍会导致pcntl_fork()致命错误。
不支持“管理不同平台的系统要求”，Composer 本身没有操作系统感知能力；它只通过 config.platform 模拟 PHP 运行环境（PHP 版本 + 扩展），从而影响依赖解析结果。所谓“跨平台兼容”，本质是绕过本地缺失扩展导致的安装失败，而非适配 Windows/macOS/Linux 差异。
为什么 platform 不能解决 ext-pcntl 在 Windows 上不可用的问题
Windows 不提供 pcntl 扩展，而某些包（如 roave/security-advisories 或开发工具）在 require-dev 中声明了 "ext-pcntl": "*"。Composer 不会自动跳过——它查不到就报错：Your requirements could not be resolved。
-
config.platform.ext-pcntl: true告诉 Composer “假装有”，让它继续选包，但不会让代码在 Windows 上真正运行成功（调用pcntl_fork()仍会 fatal error） - 真正安全的做法是：把这类仅用于开发/CI 的包移入
require-dev，然后上线时用composer install --no-dev排除 - 若必须保留且确定不执行相关代码，可用
COMPOSER_PLATFORM_CHECK=0或--ignore-platform-reqs，但后者会跳过所有检查（包括 PHP 版本），风险更高
platform 配置写错位置就完全无效
这是 CI/CD 中最常踩的坑：配置写了，composer install 却依然失败，composer config --list | grep platform 也看不到输出。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- ❌ 错误写法：
"platform": { "php": "8.1.25" }（顶层字段，和require并列） - ❌ 错误写法：
"config": { "platform.php": "8.1.25" }（键名错误） - ❌ 错误写法：
"config": { "platform": "8.1.25" }（值不是对象） - ✅ 正确结构必须是：
"config": { "platform": { "php": "8.1.25", "ext-openssl": "*" } } - 验证是否生效：
composer config platform.php应返回8.1.25；composer config --list | grep platform应显示带(local)标记的行
删不掉 composer.lock 就白配 platform
composer.lock 缓存的是上次 composer install/update 时的完整依赖树，它不随 config.platform 变更自动刷新。
- 改完
composer.json中的config.platform后，必须删掉composer.lock和vendor/，再运行composer install，否则旧锁文件会复用历史解析结果，platform形同虚设 - 如果不想删 lock 文件，可用
composer update --with-all-dependencies强制重算，但注意这会更新所有包，可能引入意外变更 - CI 环境中建议加一步校验：
composer validate --strict确保 JSON 结构合法，再执行 install
最容易被忽略的一点：platform 只骗 Composer 自己，不骗 PHP。你设了 "ext-sodium": "*"，不代表 SodiumException 类就能加载；它只影响“装什么”，不影响“跑不跑得通”。真实环境的扩展启用状态、PHP 版本、函数可用性，全得靠运维或部署脚本保障。
