可通过 Composer 的 platform 配置、环境变量条件依赖、自定义脚本、replace/provide 机制及多 composer.json 文件实现多环境差异化依赖管理，确保锁文件一致性和运行时适配。
可以通过 Composer 的平台配置、环境变量、条件依赖和自定义脚本 实现不同环境安装不同依赖，不只依赖 --no-dev。
用 config.platform 模拟目标环境的 PHP/扩展版本
避免本地开发环境与生产环境因 PHP 版本或扩展差异导致依赖解析失败。例如生产是 PHP 8.1 + ext-gd，而你本地是 PHP 8.2：
{
"config": {
"platform": {
"php": "8.1.25",
"ext-gd": "8.1.25"
}
}
}
这样 composer install 会按平台声明解析兼容包，确保锁文件（composer.lock）在各环境行为一致。
用环境变量 + require 条件语法动态启用依赖
Composer 支持基于环境变量的条件依赖（需 Composer 2.2+）：
- 在
composer.json中写：
"require": {
"monolog/monolog": "^2.0",
"ext-pcntl": "*"
},
"require-dev": {
"phpunit/phpunit": "^9.5"
},
"require-env": {
"prod": {
"ext-opcache": "*",
"blackfire/php-sdk": "^1.29"
},
"dev": {
"symfony/var-dumper": "^6.3",
"roave/security-advisories": "dev-master"
}
}
⚠️ 注意：require-env 不是原生字段，需配合自定义脚本或插件（如 ergebnis/composer-normalize 不支持；推荐用 maglnet/ComposerRequireChecker 或自定义 scripts）。更实用的方式是：
- 设环境变量：
export COMPOSER_ENV=prod - 在
composer.json的scripts中定义钩子：
"scripts": {
"post-install-cmd": [
"@php -r \"if (getenv('COMPOSER_ENV') === 'prod') { copy('vendor-prod/autoload.php', 'vendor/autoload.php'); }\""
]
}
再配合 composer require --no-update + 手动修改 require 区块后 composer update --lock，适合 CI 流水线中分步控制。
用 replace 和 provide 屏蔽或替换特定环境的包
适用于生产环境已有系统级扩展或替代实现，无需 Composer 安装：
- 让 Composer 认为某个包“已存在”，跳过安装：
"replace": {
"ext-apcu": "*",
"psr/log": ">=1.0.0"
}
或在生产环境的 composer.json 中加入：
"provide": {
"ext-redis": "7.4.0"
}
这样即使某依赖声明了 "ext-redis": "*"，Composer 也不会报错或尝试安装——前提是运行环境真有该扩展。
使用多份 composer.json 文件 + COMPOSER 环境变量切换
最直接可控的方式：维护 composer.json（通用）、composer.prod.json、composer.dev.json：
- 安装生产依赖：
COMPOSER=composer.prod.json composer install --no-dev - CI 中可统一用：
COMPOSER=composer.$COMPOSER_ENV.json composer install --no-interaction
各 JSON 文件共享基础依赖，仅在 require 和 require-dev 上差异化。注意保持 autoload 和 scripts 同步，避免功能割裂。
基本上就这些 —— 核心思路是：锁文件一致性靠 platform，环境逻辑靠变量与脚本协同，物理隔离靠多配置文件，运行时适配靠 replace/provide。不复杂但容易忽略组合使用。
