config.platform 用于让 Composer 依生产环境平台解析依赖，确保 composer.lock 在生产环境精准复现；它不改变本地实际环境，仅“欺骗”依赖解析逻辑。
在 composer.json 中使用 config.platform，核心目的是让本地开发环境的依赖解析结果与生产环境保持一致——尤其当生产环境 PHP 或扩展版本受限时，避免因本地高版本导致装入不兼容的包。
明确 platform 配置的作用
config.platform 不会改变你本地实际运行的 PHP 版本或已安装扩展，它只是欺骗 Composer：告诉它“请按我指定的平台环境来解析和锁定依赖”，从而确保 composer install 生成的 composer.lock 文件，在生产环境执行时能精确复现依赖版本，不会因平台差异触发重解析或降级失败。
正确配置 PHP 和扩展版本
在 composer.json 的 config 段中声明 platform，需严格对齐生产环境的实际能力。例如生产环境是 PHP 8.1.20、启用了 ext-gd 但没装 ext-redis：
"config": {
"platform": {
"php": "8.1.20",
"ext-gd": "8.1.20",
"ext-iconv": "*",
"ext-json": "*"
}
}
- PHP 版本写具体小版本（如
"8.1.20"）比写"8.1"更稳妥，避免某些包因补丁版本差异被错误排除 - 只列出生产环境真实存在且启用的扩展；未启用的扩展不要写，否则可能让 Composer 误选依赖了该扩展的包版本
- 扩展版本通常填
"*"即可，除非某包明确要求扩展的特定版本（少见）
配合 platform-check 防止误配
Composer 自带 platform-check 命令（需 Composer 2.4+），运行 composer check-platform-reqs 可验证当前系统是否满足 platform 所声明的最低要求：
- 若提示缺失
ext-gd，说明你本地没开 GD，但platform声明了它——这时要么启用扩展，要么从platform中移除 - 该命令不检查 PHP 小版本号是否完全匹配，只校验主次版本（如 8.1.x），所以仍需人工核对补丁版
上线前务必重新生成 lock 文件
修改 config.platform 后，必须执行 composer update --lock（或先 composer update 再 composer install），否则旧的 composer.lock 仍基于之前平台假设生成，无法生效。
- CI/CD 流程中建议显式加入
composer install --no-dev并确保composer.lock已提交，禁止在生产环境运行update - 若团队多人协作，把
platform配置纳入代码审查重点，避免本地随意修改后忘记同步
