作为 Git 子模块的单个文件

Question

我正在尝试确定 Git 存储库之间共享代码的最佳实践。

到目前为止，我显然已经遇到了看起来几乎符合要求的子模块。我的项目是一个结构简单的 PHP MVC 框架：

• /app
• core.php
• /core

其中 app 是一个包含特定于应用程序的控制器、模型、视图等的文件夹，而 core > 包含一般用途的内容，例如登录控制器。 core.php 文件本身是所有请求的全局处理程序。

因此，我在该 MVC 框架的所有部署中共享的代码是 core.php 和 core。

我可以看到如何将 core 转变为 Git 子模块，但不能将 core.php 转变为 Git 子模块。

这可能吗？我是否需要重新构建我的框架，以便 core.php 驻留在 core 文件夹中，以便我可以将整个文件夹作为子模块，或者有更好的方法吗？

Answer 1

如果您的操作系统支持符号链接，那么您可以设置core并core.php 像这样：

# "base" repository layout:
core/
core.app

# each app repository layout:
base/
  core/
  core.php
core -> base/core/
core.php -> base/core.php
app/

在每个应用程序存储库中，base/ 目录是使用“base”存储库的子模块或“base”存储库的子树合并。

这两种方法都允许您开始在特定应用程序的上下文中更改基本代码，然后将这些更改拉回到主基本存储库中。使用子模块时，您必须小心，在发布任何引用这些新基础提交的应用程序提交之前，必须始终小心地发布新的基础提交（在使用子树合并时，这不是问题，因为每个应用程序都是“扁平”的，并且实际上拥有自己的基础提交副本）根据）。

第三方 git subtree 命令似乎是一个非常好的方法如果您决定不使用子模块，则可以管理子树合并。

子树子

git init newapp
cd newapp
ln -s base/core
ln -s base/core.php
git add core core.php
git commit -m'point to base (to be added next)'

# hook up base
git subtree add --prefix=base [email protected]:me/app_base.git master

mkdir app
# edit app/bar.php

# update base
git subtree pull --prefix=base [email protected]:me/app_base.git master

.
|-- .git/
|   |-- ...
|   `-- ...
|-- app/
|   `-- bar.php
|-- base/
|   |-- core/
|   |   `-- foo.php
|   `-- core.php
|-- core -> base/core/
`-- core.php -> base/core.php

模块

git init newapp
cd newapp
ln -s base/core
ln -s base/core.php
git add core core.php
git commit -m'point to base (to be added next)'

# hook up "base"
git submodule add [email protected]:me/app_base.git base
git commit -m'incorporate base'

mkdir app
# edit app/bar.php

# update base
(cd base && git fetch origin && git merge origin/master)
git add base
git commit -m'updated base'
.
|-- .git/
|   |-- ...
|   `-- ...
|-- .gitmodules
|-- app/
|   `-- bar.php
|-- base/
|   |-- .git/
|   |   |-- ...
|   |   `-- ...
|   |-- core/
|   |   `-- foo.php
|   `-- core.php
|-- core -> base/core/
`-- core.php -> base/core.php

Answer 2

子模块是一个 git 存储库，有自己的 .git 目录，因此它必须包含在一个目录中。我不相信有任何方法可以轻松解决这个问题。你必须以某种方式将你的东西打包到一个目录中 - 如果 core.php 与 core 中的东西一起使用，那么它们放在子模块存储库中是完全有意义的！

rmk 的答案，建议您使用 core 在一个存储库中完成这一切而 core.php 作为起点是另一个合理的起点。您应该根据预期的工作流程做出决定。如果您计划与使用它的项目分开修改核心*内容，那么子模块会很好；然后您可以更新使用它的各个项目中的子模块。如果您想修改核心*内容以适应特定项目，那么基线存储库将是很好的选择；然后，您可以从基线存储库中获取更新，将它们与您在项目存储库中所做的更改合并。

Answer 3

也许您最好将 core.php 和 core 维护在单独的存储库中，然后将其用作远程库。
然后您可以通过将其拉入任何使用它的项目来管理它。为此，只需将新项目作为单独的 git 存储库启动，然后将“核心”存储库作为子树拉入。

本章向您展示如何执行此操作：

更新的参考：http ://git-scm.com/book/en/v2/Git-Tools-Advanced-Merging#_subtree_merge
原始参考： https://git-scm.com/book/ en/v1/Git-Tools-Subtree-Merging

这比本书上一节（6.6）中建议的设置对您来说要好一些。

看看它；这可能会有所帮助。