多依赖多环境下Git与Composer的生产部署管理方案咨询

针对你提到的场景，以下是几个无需维护多份配置的自动化方案，按推荐优先级排序：

方案1：利用Composer分支别名+环境变量控制 #

这是最贴合需求的官方原生方案，无需额外脚本：

1. 在主项目的composer.json中，将所有内部依赖的版本统一设为@dev，同时通过config字段定义分支别名映射：

{
  "require": {
    "company/pkg1": "@dev",
    "company/pkg2": "@dev",
    // ... 其他48个内部依赖
  },
  "config": {
    "branch-alias": {
      "dev-dev": "dev",
      "dev-master": "prod"
    }
  }
}

2. 不同环境通过环境变量指定默认分支执行更新：

   • 开发环境：

   COMPOSER_DEFAULT_BRANCH=dev composer update
   

   • 生产环境：

   COMPOSER_DEFAULT_BRANCH=master composer update
   

   这个变量会让Composer解析@dev时自动拉取指定分支代码，全程无需修改配置文件。

方案2：编写轻量脚本自动替换分支 #

如果需要更灵活的分支控制（比如部分依赖固定分支、部分跟随环境），可以写个简单的shell脚本（switch-branch.sh）：

#!/bin/bash
TARGET_BRANCH=$1

# 备份原配置
cp composer.json composer.json.bak

# 批量替换所有依赖的分支后缀
sed -i "s/dev-.*/dev-$TARGET_BRANCH/" composer.json

# 执行Composer更新
composer update

# 恢复原配置（可选，若不需要保留修改后的配置）
mv composer.json.bak composer.json

使用时：

• 开发环境：./switch-branch.sh dev
• 生产环境：./switch-branch.sh master

Windows环境可改用PowerShell实现类似的字符串替换逻辑。

方案3：Composer自定义脚本+extra配置 #

把分支切换逻辑完全整合到Composer生态中，无需额外脚本文件：

1. 修改composer.json添加额外配置和自定义脚本：

{
  "require": {
    "company/pkg1": "dev-dev",
    "company/pkg2": "dev-dev",
    // ... 其他依赖
  },
  "extra": {
    "env-branches": {
      "dev": "dev",
      "prod": "master"
    }
  },
  "scripts": {
    "switch-branch": [
      "@php -r '$env = $argv[1]; $extra = json_decode(file_get_contents(\"composer.json\"), true); $branch = $extra[\"extra\"][\"env-branches\"][$env]; $content = file_get_contents(\"composer.json\"); $content = preg_replace(\"/dev-.*/\", \"dev-$branch\", $content); file_put_contents(\"composer.json\", $content);'",
      "composer update"
    ]
  }
}

2. 执行对应环境的更新命令：
   • 开发环境：composer switch-branch dev
   • 生产环境：composer switch-branch prod

额外建议 #

• 生产环境优先使用composer install而非update：在开发环境完成更新后，提交composer.lock到版本库，生产环境直接安装锁定版本，避免意外引入未测试的更新。
• 对于数月未更新的依赖，可以单独固定分支（比如写死dev-master），仅让定期更新的依赖跟随环境变量切换，降低风险。

内容的提问来源于stack exchange，提问作者shirkkan