platform-check 是 Composer 5.0+ 默认启用的环境校验机制，安装前检查 PHP 版本、扩展及函数是否满足 composer.json 声明；它不直接检测操作系统，但因某些扩展（如 pcntl、posix）在 Windows 上不可用，OS 差异会间接导致校验失败。

Composer 本身不主动“处理”不同操作系统的依赖差异，它默认按 composer.json 中声明的依赖安装，但通过 platform-check 和相关配置，可以显式控制或规避因操作系统（如 Windows/macOS/Linux）导致的扩展、函数或二进制兼容性问题。

platform-check 是什么？

这是 Composer 5.0+ 引入的默认行为：在安装或更新依赖前，检查当前 PHP 环境是否满足 composer.json 中 require 或 require-dev 所声明的 PHP 版本、扩展（如 ext-curl）、函数（如 function-iconv）等约束。它不直接检查操作系统，但很多扩展（如 ext-pcntl、ext-posix）在 Windows 上不可用或受限，因此 platform-check 会因 OS 差异而触发报错。

如何适配多操作系统环境？

关键不是让 Composer “自动切换依赖”，而是通过配置明确告诉它哪些依赖是平台相关的：

• 用 platform 配置模拟目标环境：在 composer.json 中设置 "platform" 字段，覆盖本地 PHP 信息。例如开发在 Windows，但部署在 Linux，可写：
  "platform": {"php": "8.2.10", "ext-pcntl": "8.2.10", "ext-posix": "8.2.10"}
  这样 Composer 就不会因本地缺 pcntl 而拒绝安装依赖。
• 用 platform-check 开关控制检查时机：运行 composer install --no-platform-check 可跳过检查（不推荐长期使用）；更稳妥的是在 composer.json 中设 "platform-check": false（仅限必要场景，比如 CI 构建时临时绕过）。
• 按平台条件加载依赖（需手动管理）：Composer 不支持 if os == 'linux' 这类语法，但可通过 require-dev 分组 + 脚本配合实现。例如把仅 Linux 需要的工具（如 psy/psysh 在某些终端下依赖 ext-readline）放在 dev 里，并在部署脚本中判断 OS 再决定是否 composer install --no-dev。

常见问题与建议

遇到 The requested PHP extension ext-pcntl is missing from your system 这类报错，通常不是 Composer 故意“限制”，而是依赖包在 composer.json 中硬性声明了该扩展（比如队列组件要求 pcntl）。这时应：

• 确认该扩展是否真被项目运行时需要（开发 vs 生产）；
• 若只是本地开发不需，移至 require-dev 并避免在 Windows CI 中安装；
• 若必须运行，改用 WSL、Docker 或虚拟机提供匹配环境，而非强行绕过检查。

不复杂但容易忽略：platform-check 的本质是契约校验——它确保你声明的环境约束和实际运行环境一致。操作系统差异带来的问题，最终要靠明确的环境定义和分层依赖管理来解决，而不是让 Composer 自动适配。