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 自动适配。
