如何使用Composer在不同的环境中安装不同的依赖包？（--no-dev之外的技巧）

可通过 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 安装：

标签： php redis js json composer 环境变量 配置文件 开发环境 red