<p>config.platform 用于让 Composer 在本地安装依赖时模拟生产环境，避免因本地 PHP 版本或扩展更高而装入不兼容包；需在 composer.json 中 config → platform 下精确声明 php 版本（如 "8.1.25"）和 ext- 前缀扩展（如 "ext-gd": "8.1.25"），未声明的扩展视为不存在。</p>
在 composer.json 中配置 config.platform，是为了让 Composer 在本地安装依赖时，**假装运行在目标生产环境上**，从而避免因本地 PHP 版本或扩展更高而装入不兼容的包版本。这特别适用于 CI/CD、团队协作或 Docker 构建前的本地验证。
为什么需要 config.platform？
Composer 默认根据你当前运行的 PHP 版本和已启用的扩展来解析依赖。比如你本地是 PHP 8.2，但生产环境是 PHP 8.1，某些包可能在 8.2 下装了只兼容 8.2 的版本（如带新语法的 patch 版），结果部署到 8.1 就报错。config.platform 就是用来“覆盖”这些检测值，强制 Composer 按你指定的环境去选包。
如何配置 platform 字段？
在 composer.json 的 config → platform 下，写入你生产环境的真实 PHP 和扩展信息。例如：
"config": {
"platform": {
"php": "8.1.25",
"ext-gd": "8.1.25",
"ext-mbstring": "8.1.25",
"ext-pdo_mysql": "8.1.25",
"ext-redis": "5.3.7"
}
}
说明：
-
php：必须写，格式为
X.Y.Z（推荐带补丁号），不能写^8.1或8.1 -
扩展名：用
ext-前缀，名称要和php -m输出一致（如pdo_mysql不是pdo_mysql） -
扩展版本：可写具体版本（如
5.3.7），也可统一写成 PHP 版本号（如"8.1.25"），Composer 会接受——关键是声明“这个扩展存在” - 没写的扩展，默认视为「不存在」，Composer 不会装依赖于它的包（比如没写
ext-redis，predis/predis可能被装，但phpredis相关驱动就不会被选中）
常见陷阱和建议
配置看似简单，但容易出错：
-
别漏掉关键扩展：比如 Laravel 项目用了
ext-intl或ext-bcmath，但platform没声明，可能导致线上运行时报错 -
PHP 版本要精确匹配：有些包（如
symfony/console）对 PHP 补丁版本有隐式要求，写"8.1"可能不够，建议查生产环境php -v结果照抄 -
扩展名大小写敏感：Linux 下是
pdo_mysql，不是PDO_MYSQL；Windows 下也请按php -m实际输出写 -
CI 环境中慎用 --ignore-platform-reqs：它会绕过
platform，相当于废掉了这个配置，应尽量避免
验证是否生效？
改完 composer.json 后，运行：
composer show --platform
它会列出 Composer 当前“认为”的平台信息。如果看到你配置的 PHP 版本和扩展，说明已生效。再执行 composer update，就会按这个平台重新计算依赖树。
基本上就这些。不复杂但容易忽略细节——配对了，composer install 在哪跑都更接近线上行为。
