如何用Git高效管理Laravel多客户端应用的版本、模块与定制？

一、仓库结构规划 #

将核心程序、功能模块、客户定制内容拆分为独立Git仓库，实现各自版本的独立迭代：

• 核心程序仓库：单独创建laravel-core仓库，维护main稳定分支，用语义化版本标签（如v1.0.0、v1.1.0）标记正式发布版本，所有核心功能迭代都在这个仓库完成。
• 功能模块仓库：每个自有模块单独建一个仓库（如module-payment、module-report），同样用版本标签管理迭代，模块与核心通过约定接口交互，不直接耦合核心代码。
• 客户部署仓库：为每个客户创建独立仓库（如client-alice、client-bob），作为整合核心、选中模块及客户定制代码的最终部署载体。

二、客户仓库初始化与整合 #

每个客户仓库通过Git子模块关联核心和模块仓库，同时存放独立定制代码：

1. 初始化客户仓库：

   mkdir client-alice && cd client-alice
   git init
   

2. 添加核心作为子模块并绑定指定版本：

   git submodule add <laravel-core仓库地址> core
   cd core && git checkout v1.0.0 && cd ..
   git add core .gitmodules
   git commit -m "绑定核心程序v1.0.0"
   

3. 添加所需模块作为子模块，同样绑定指定版本：

   git submodule add <module-payment仓库地址> modules/payment
   cd modules/payment && git checkout v2.1.0 && cd ../..
   git add modules/payment .gitmodules
   git commit -m "绑定支付模块v2.1.0"
   

4. 创建hooks/目录存放客户定制代码，直接提交到客户仓库：

   mkdir hooks
   # 放入定制代码文件
   git add hooks/
   git commit -m "提交客户定制钩子代码"
   

三、版本追踪方案 #

轻松追踪每个客户使用的核心与模块版本：

• 子模块状态查询：在客户仓库根目录执行git submodule status，会直接显示核心、各模块的当前提交哈希与版本标签（若已绑定标签），示例输出：

  5a3f2d1 core (v1.0.0)
  9b7c4e6 modules/payment (v2.1.0)
  

• 可视化版本记录（可选）：在客户仓库根目录创建version.lock文件，手动记录核心与模块的版本号，方便快速查阅：

  [core]
  version = v1.0.0
  [modules]
  payment = v2.1.0
  report = v1.3.0
  

  将该文件提交到客户仓库，无需逐个查询子模块哈希。

四、核心/模块版本更新流程 #

当核心或模块发布新版本时，手动同步到客户仓库（可控性更强，无需自动推送）：

1. 核心版本更新操作：

   # 进入客户仓库的核心子模块目录
   cd client-alice/core
   # 拉取最新标签
   git fetch --tags
   # 切换到目标新版本
   git checkout v1.1.0
   # 返回根目录，提交子模块更新
   cd ..
   git add core
   git commit -m "升级核心程序到v1.1.0"
   # 推送到客户仓库，之后部署到客户环境
   git push
   

2. 模块版本更新操作与核心完全一致，进入对应模块子模块目录，切换新版本标签后提交更新即可。

五、定制代码的独立维护 #

hooks/目录属于客户仓库的独立目录，所有定制修改直接提交到这里：

• 定制代码与核心、模块完全解耦，核心/模块的更新不会覆盖hooks/内容
• 若核心逻辑变动，仅需修改hooks/内的对应覆盖代码，无需改动核心或模块仓库

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