Composer不支持指定操作系统版本，仅依据PHP版本、扩展依赖和锁文件解析安装；config.platform通过伪造平台信息使依赖解析适配目标环境，避免CI/CD中因平台差异导致重算失败。
Composer 本身不提供“指定操作系统版本”的能力，它只按 composer.json 中声明的 PHP 版本、扩展依赖和锁文件来解析安装。所谓“特定平台版本”，实际是包作者通过 config.platform、require 中的扩展约束（如 ext-posix）或二进制分发逻辑间接触发的平台感知行为。
为什么 config.platform 能“骗过”依赖解析？
config.platform 不改变当前 PHP 环境，只告诉 Composer：“请假装我在 php:8.2.12、ext-gd:8.2.12 下运行”。这样做的效果是：
- Composer 在
update或install时，会忽略你本地缺失的扩展（比如 Windows 上没有ext-posix），但仍选中那些声明了"ext-posix": "*"的包版本 - 它让
composer.lock中的platform字段与目标环境一致，避免 CI/CD 中因平台不匹配导致依赖树重算失败 - 该配置对
require-dev同样生效，所以开发用的工具包（如phpunit）也能被正确锁定
示例配置（写入 composer.json 的 config 段）：
"config": {
"platform": {
"php": "8.2.12",
"ext-gd": "8.2.12",
"ext-mbstring": "8.2.12"
}
}
注意：platform 中的版本号必须是具体字符串（如 "8.2.12"），不能用 ^8.2 或 ~8.2，否则无效。
--ignore-platform-req 是临时解法，但别提交到 CI
当你在 Windows 上遇到 Your requirements could not be resolved 并提示 ext-posix 缺失时，--ignore-platform-req=ext-posix 可跳过该检查。但它只是绕过校验，不是解决问题：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 如果代码里真调用了
posix_getpid()，运行时仍会 fatal error - CI 脚本里加这个参数，等于把平台差异隐患带进生产构建流程
- 多个扩展要忽略时，得重复写多次：
--ignore-platform-req=ext-posix --ignore-platform-req=ext-iconv
更稳妥的做法是：确认该扩展是否真被运行时使用。如果不是（比如仅用于 CLI 工具的本地开发），把它从 require 移到 require-dev；如果是，改用 function_exists('posix_getpid') 包裹调用。
离线部署前，必须在目标系统上跑一次 composer install
很多人把 Windows 上生成的 vendor/ 直接拷到 Linux 服务器，结果报 failed to open stream: No such file or directory。这不是斜杠问题，而是：
- 某些包的安装脚本（如
post-install-cmd）在生成时硬编码了开发机路径 -
autoload_classmap.php里的路径是基于 Windows 的realpath()结果生成的，在 Linux 上失效 -
composer.lock中的content-hash和platform字段若与目标环境不一致，autoloader 可能漏加载类
正确操作顺序：
- 在与生产环境一致的 OS（如 Alpine Linux 容器）中，拉取项目源码 +
composer.lock - 执行：
php -d memory_limit=512M composer install --no-dev --optimize-autoloader --prefer-dist - 验证
vendor/autoload.php是否能被php -r "require 'vendor/autoload.php';"正常加载
最易被忽略的一点：你设了 "platform": {"php": "8.2.0"}，不代表 PHP 7.4 就能跑起来——语法错误（比如 match 表达式）会在 require 第一行就炸，platform 压根没机会起作用。
