Composer 默认忽略平台差异，需通过 config.platform 显式声明目标环境（如 PHP 版本、扩展）才能在依赖解析阶段排除不兼容包；platform 不影响 install 行为，必须 update 生成新 lock 文件才生效。
Composer 会忽略平台差异，除非你显式配置 platform
默认情况下，composer install 或 composer update 完全不检查当前 PHP 版本、扩展是否匹配 require 中声明的约束。它只校验 composer.json 里写的版本范围是否满足，并下载对应包——哪怕目标机器缺 ext-gd 或 PHP 是 7.4，只要 lock 文件存在，就照装不误。这是跨平台“能装上但跑不起来”的根源。
真正起作用的是 config.platform：它让 Composer 在依赖解析阶段假装运行在指定平台上，从而提前排除不兼容的版本。比如你在 macOS 开发，但部署到 CentOS 的 PHP 8.1 + opcache 环境，就得主动锁定平台能力：
{
"config": {
"platform": {
"php": "8.1.25",
"ext-opcache": "8.1.25"
}
}
}
这样 composer update 就不会选那些声明 "ext-opcache": "^8.2" 的包版本，哪怕本地没装 opcache 也能正确解析依赖树。
platform 配置不生效？检查 lock 文件是否被跳过
常见错误是改了 config.platform 却没更新 composer.lock。Composer 只在 update 时重新解析依赖；install 严格按 lock 文件还原，完全无视当前 platform 设置。
- CI/CD 流水线里执行
composer install前，必须确保composer.lock是用目标平台配置生成的 - 本地开发改了
platform后，要composer update --lock（或直接composer update）才能写入新约束 - 如果 lock 文件里已有不兼容包（比如含
"ext-redis": "^5.3"，但目标环境只有 Redis 4.x），仅改platform不会自动降级——得删 lock 文件再 update
Windows 和 Linux 下扩展名差异会导致 autoload 失败
某些包（如 ext-yaml、ext-apcu）在 Windows 下扩展文件是 .dll，Linux/macOS 是 .so，但 Composer 的 autoload 机制本身不处理这个。问题出在包内代码硬编码了扩展加载逻辑，或 require 条件写死了扩展名。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
典型表现是：PHP Warning: extension_loaded('yaml') 返回 false，即使扩展已启用。解决方法不是靠 Composer，而是：
- 避免在
composer.json中用ext-yaml这类名称做 require（它不区分平台），改用更松散的运行时检测（如function_exists('yaml_parse')） - 若必须强制依赖，可在
config.platform中设"ext-yaml": "*"，让 Composer 忽略扩展存在性检查，把验证交给运行时 - CI 中用
php -m | grep yaml显式验证扩展是否可用，别依赖 Composer 的“安装成功”信号
PHP 主版本不一致时，platform.php 无法绕过语法错误
config.platform.php 只影响依赖选择，不改变 PHP 解析器行为。如果某包用了 PHP 8.0 的联合类型语法，而你设 "php": "7.4"，Composer 仍可能选中它——因为它的 composer.json 可能只声明 "php": "^7.4 || ^8.0"，且没有在 autoload 或 require 中进一步限制语言特性。
这种情况下，composer install 成功，但 require 包时直接 Parse Error。应对方式很实在：
- 用
composer show vendor/package查看该包实际支持的 PHP 版本（看其composer.json的require.php字段，不是你本地的 platform） - 加
--ignore-platform-req=php是危险操作，仅用于临时调试，绝不能进 CI - 生产环境务必用与目标一致的 PHP 版本执行
composer update，而不是靠 platform 模拟
跨平台兼容性最常被忽略的一点：lock 文件本质是“快照”，不是“契约”。它记录的是某次 update 的结果，不保证在其他平台可复现——除非你控制了 PHP 版本、扩展集、Composer 版本三者全部一致。
