Publication de plugins WordPress à l'aide de Git

Si vous avez hébergé un plugin sur un dépôt WordPress, vous serez assez familier avec SVN et certaines de ses commandes. Dans ce tutoriel, je vais vous montrer comment utiliser Git, un autre système de contrôle de version popularisé par GitHub, pour publier et maintenir votre plugin.

---

Qu’est-ce que Git ?

Git et SVN sont tous deux des exemples de systèmes de contrôle de version. Le référentiel de WordPress utilise ce dernier (si vous disposez d'un plugin hébergé sur WordPress, vous serez familier avec le « check-in » pour apporter des modifications à ce référentiel). Ils vous permettent tous deux de suivre les modifications apportées à votre code, mais il existe de grandes différences dans la manière dont ils le font.

SVN s'appuie sur un seul « référentiel central » de code (dans notre contexte : le référentiel de plugins WordPress). Chaque fois que vous souhaitez modifier un plugin, vous devez en faire une copie locale, apporter vos modifications, puis « enregistrer » ces modifications dans le référentiel WordPress.

Git est un système de contrôle de version décentralisé. Non seulement vous disposez d’une copie locale du plugin, vous disposez également d’un clone complet du référentiel du plugin avec toutes ses modifications. Le référentiel existe désormais indépendamment sur votre ordinateur. Vous pouvez valider et suivre les modifications, annuler les modifications ou « brancher » le plugin dans différentes directions sur votre ordinateur local. Ce n’est que si vous souhaitez mettre à jour le plugin que vous pousserez les modifications vers le référentiel WordPress pour les rendre publiques.

Pour ce tutoriel, je suppose que vous disposez déjà d'un plugin hébergé sur le référentiel de plugins WordPress, ou au moins que votre demande d'hébergement a été approuvée. Si vous ne savez pas comment héberger votre plugin sur WordPress, je vous recommande de lire notre article sur la façon de publier sur un référentiel de plugins WordPress.

---

Quels sont les avantages d’utiliser Git par rapport à SVN ?

Il existe de nombreux arguments pour et contre l'utilisation de Git au lieu de SVN (et des systèmes de contrôle de version décentralisés en général). Beaucoup d’entre eux proviennent des façons fondamentalement différentes dont Git et SVN suivent les modifications. L'article Git vs SVN de CodeForest fournit une analyse approfondie et approfondie de Git et SVN, mais pour les développeurs WordPress :

• Accès hors ligne – Vous pouvez effectuer et suivre les validations sur votre propre « référentiel de développement » personnel. L'accès au référentiel WordPress n'est requis que si vous souhaitez rendre publiques vos modifications.
Git est
• beaucoup plus facile à utiliser une fois que vous l'avez appris - cet article vous guidera à travers le flux de travail de base requis pour apporter des modifications et des mises à jour dans votre référentiel. J'ai créé un lien vers certaines ressources en bas qui fournissent plus de détails sur l'utilisation de Git. GitHub – Soyons réalistes, c'est ainsi que la plupart d'entre nous ont entendu parler de Git. La nature décentralisée de Git lui permet d'encourager le « codage social ». Vous pouvez conserver une copie du plugin sur GitHub, encourageant la participation de la communauté et les améliorations ou extensions, que vous pouvez ensuite inclure. En général, c'est une bonne idée d'exposer votre plugin à d'autres développeurs.
• "fork" facilement votre plugin - Vous pouvez créer une branche "expérimentale" sur votre copie locale pour tester d'éventuelles nouvelles fonctionnalités, puis, si elles fonctionnent, les fusionner à nouveau lorsque la prochaine version du plugin sera publiée.
L'un des inconvénients de l'utilisation de Git est qu'il fonctionne bien avec les référentiels SVN. Grâce à

, ce n’est en fait pas si difficile et cet article est là pour vous guider dans cette démarche.

git svn

---

Étape 1

Télécharger Git Si Git n’est pas encore installé, vous devez l’installer. Comment installer Git est détaillé dans le Git Community Book et le Pro Git Book (deux

excellentes

ressources si vous êtes nouveau sur Git). La manière dont vous installez Git dépend de votre système d’exploitation et des programmes GUI disponibles. Dans ce tutoriel, je ferai tout via la ligne de commande – je vous encourage à faire de même. À la fin de l'article, je recommanderai quelques programmes GUI que vous pouvez utiliser, mais en général, je les utilise uniquement pour visualiser les branches d'un référentiel.

---

Étape 2

Clonez le référentiel d'hébergement WordPress du plugin Comme mentionné précédemment, avec Git, vous n'avez pas besoin de "extraire" une copie du plugin - vous pouvez cloner le référentiel et inclure un historique des modifications que vous avez apportées, ainsi que toutes ses branches et balises. L’étape 1 consiste à cloner le référentiel d’hébergement WordPress du plugin. A titre d'exemple, je publierai un plugin "Post Type Archive Link" basé sur un tutoriel précédent. Ainsi (une fois que vous êtes accepté dans le référentiel WordPress), ouvrez votre interface de ligne de commande et accédez à l'endroit où vous souhaitez stocker la version locale de votre plugin. Je vais le mettre dans un dossier appelé "

Plugins

". Une fois sur place, nous voulons indiquer à Git où trouver notre plugin. Au moment d’écrire ces lignes, il existe près de 20 000 plugins hébergés dans le référentiel WordPress avec plus de 500 000 révisions. Nous ne voulons pas attendre que Git parcoure chacun d'entre eux pour trouver notre plugin. Alors d’abord, on trouve la version de départ du plugin (nous voulons que ce soit tout l’historique). Pour ce faire, nous récupérons le premier log du plugin (lors de son ajout initial au référentiel) :

svn log -r 1:HEAD --limit 1 http://plugins.svn.wordpress.org/your-plug-in-name

Il réfléchira pendant un moment et vous devriez alors voir quelque chose comme ceci :

r520657 | plugin-master | 2012-03-19 03:56:31 +0000 (Mon, 19 Mar 2012) | 1 line

我的插件的第一个数字“520657”是第一个修订版。我们将在下一个命令中使用它，告诉 Git 克隆我们插件的历史记录。将 XXXXXX 替换为您的修订号。

git svn clone -s -rXXXXXX --no-minimize-url http://plugins.svn.wordpress.org/your-plug-in-name
cd your-plugin-name
git svn fetch
git svn rebase

“-s”告诉 Git 期望 SVN 存储库的标准（标签、主干、分支）布局。 '--no-minimize-url' 会阻止它在插件文件夹之外查找。 确保它没有丢失。如果您忽略它，您最终可能会复制整个 WordPress 插件存储库。 -rXXXXXX 告诉 Git 要查找的修订版本。如果你忽略它，Git 将搜索存储库的整个历史记录。修改次数超过 500,000 次。我有一次遗漏了这个，花了大约两个小时。安装完毕后，应该只需要几分钟。

完成后，您应该会发现它在“插件”文件夹中创建了一个名为“您的插件名称”的文件夹。让我们来探索一下。导航到“您的插件名称”文件夹并运行命令以查看存在哪些“分支”：

git branch -a

这将列出所有分支，本地和远程。唯一的本地分支应该是 Master （星号表示这是您所在的分支）。其他分支是“主干”，如果有的话，每个标签都有一个分支（SVN 将标签视为分支，但 Git 比这更聪明）。

转到“本地文件夹”“plugins/your-plugin-name”，您应该会看到插件文件（如果有）。在其中创建或编辑任何文件之前，我们将创建一个单独的分支来处理。

更新：由于 Neerav 和 John Eckman 在下面的评论中指出的问题，上述命令已更新。上面的代码现在反映了 Stephen Harris 的建议。

---

第3步（可选）推送到GitHub

使用 Git 的好处之一是您可以轻松地在 GitHub 上维护插件的版本。这使得其他开发人员更容易访问您的插件，他们可能会提出改进建议，甚至进行自己的修改，您可以将其拉入您自己的存储库中。如果您已经设置了 GitHub，此时您可能希望将插件推送到您的帐户。为此，首先在 GitHub 帐户上为自己创建一个新存储库，然后将其作为远程分支添加到本地存储库：

git remote add origin git@github.com:<your-user-name>/<your-repo-name>.git

“your-user-name”是指您的 GitHub 用户名，“your-repo-name”是指您在其上创建的存储库的名称GitHub。然后你只需推送本地存储库：

git push origin master

---

第 4 步编辑插件：工作流程概要

我们将创建一个新的分支“work”。我们将在这个分支内更改插件、进行更改并添加功能等。这意味着我们的“主”分支保持其原始状态。这允许我们切换回 Master 分支，并再次分支。特别是，假设当您在“工作”分支中开发一些新功能时，您的插件中发现了一个主要错误。您可以切换回您的“主”分支（其中不包括您当前正在处理的任何功能），提交错误修复，然后将其推送到 WordPress 存储库。然后，您可以切换回工作分支并从上次中断的地方继续。 （注意：Git 不会创建文件的副本 - 您的本地文件夹中始终只有一组文件。这些文件包含的内容取决于您所在的分支。）

事实上，为要添加到插件中的每个新功能创建一个分支是个好主意。完成后，您只需将它们合并回主分支即可。如果这导致任何“冲突”，系统会要求您手动解决这些问题。

首先创建一个名为“work”的分支：

git branch work

然后“签出”（转到）分支“工作”：

git checkout work

一条消息将告诉您您已切换到“工作”分支。现在，使用您最喜欢的文本编辑器打开本地文件夹中的插件文件（如果还没有任何文件，则创建它们）。创建一些文件后，您可能想查看更改了哪些文件。您可以使用简单的命令来完成此操作：

git status

这将列出已跟踪和未跟踪文件的更改。可能存在您不希望 Git 跟踪的文件（例如临时文件），但如果您向该文件夹添加了任何新文件，则需要告诉 Git 跟踪它们。您可以使用以下命令执行此操作：

git add <file-name>

我在本地文件夹中创建了两个文件“post-type-archive-links.php”和“metabox.js”，因此我添加了他们告诉 Git 跟踪他们。您必须确保您正在跟踪您的自述文件。

您还可以查看自上次提交以来的更改（这是 GUI 程序变得非常方便的地方）

git diff

一旦您想要将更改提交到本地存储库：

git commit -a -m "Did abc to xyz"

提供提交中包含的更改的（详细）消息。

在进行更改的过程中，您可以（并且应该）尽可能频繁地提交 - 但以合乎逻辑的方式，最好为您所做的每件“事情”进行一次提交。您还应该确保您的提交中没有明显的错误。 “撤消”一次提交既快速又轻松：您可以通过执行另一次提交来逆转前一次提交来完成此操作：

git revert HEAD

（系统会提示您输入一条消息来描述此提交。）

---

第 5 步提交到 WordPress 存储库

假设您现在想要将所有更改推送到 SVN 存储库。在这样做之前，我们需要记住一些事情。 Git 鼓励您经常提交，对于开发而言，这样做是一个很好的实践。不过，您的 WordPress 插件存储库可供分发。它不需要每一次提交。事实上，正如 Otto（WordPress 核心贡献者）警告的那样，它也确实不想要它：

“如果我发现你[分别推送每个提交]，那么我将禁止你访问 WordPress.org。SVN 只需要提交你的最终工作版本，而不是数百个的整个历史记录。您使用 Git 所做的更改。将您的更改扁平化为单个提交。”

为了避免这种情况，当我们准备好推送到 WordPress 存储库时，我们会将所有提交合并为一个提交。有几种方法可以做到这一点。我们将把工作分支中的更改合并（并同时压缩）到主分支中。然后我们所有的更改都会作为主分支上的一次提交出现。然后我们删除工作分支并将主分支推送到插件的 SVN 主干。

首先，我们要切换回 Master 分支：

git checkout master

然后将工作分支更改压缩并合并到主分支中：

git merge --squash work

如果对主分支进行了更改，则合并中可能会出现冲突。系统会提示您在合并完成之前手动解决这些冲突。合并后，提交更改（这一提交将包含我们工作分支的所有提交）：

git commit -a -m "Made changes a,b,c,d"

最后，我们删除工作分支

git branch -D work

如果您有多个分支想要合并，那么您可以对每个分支执行此操作。还有一些替代方法可以扁平化您的历史记录（例如交互式变基），我不会介绍这些方法。

此时，如果您愿意，您可以将最新更改推送到您的 GitHub 帐户：

git push -u origin master

要推送到 WordPress 存储库，我们首先确保我们的本地存储库是“最新的”：

git svn rebase

然后，Git 将获取您的 subversion 存储库，并将其中的任何更改与我们刚刚所做的更改合并。通常情况下，WordPress 存储库不应有任何更改，因此您应该看到以下消息：当前分支 master 已更新。

现在我们可以将更改推送到 WordPress 存储库

git svn dcommit

然后，Git 可能会提示您输入 WordPress.org 凭据。输入后，您的更改将提交到 WordPress 存储库。很快您就会收到来自 WordPress 存储库的一封电子邮件，通知您提交情况。

---

第 6 步标记新版本

目前，这些更改将放在后备箱中。如果我们想标记插件的新版本怎么办？为插件创建下一个版本时，您应该更新自述文件，以便稳定标签指向您的新版本（例如“2.0”）。您还应该在 your-plug-in-name.php 文件中更新插件的标头信息。如果您忘记执行此操作，只需执行上述过程并进行这些更改即可。

一旦您的“主干”完全更新（包括最新版本信息），我们只需在 WordPress 存储库中创建新标签即可：

git svn tag "2.0"

这会将 trunk 中的所有内容复制到 tags/2.0 中（通常使用 svn cp trunktags/2.0 在 SVN 中实现的效果）。

如果您想在本地存储库中标记版本：

git tag -a 2.0 -m"Tagging 2.0"

---

第 7 步（可选）在 GitHub 上标记新版本

与我们对 WordPress 存储库所做的类似，确保我们的存储库同意，然后推送我们的更改和标签：

git pull --rebase origin master 
git push origin master 
git push origin --tags

---

Git 命令的有用资源

• Git 参考（有一个关于“如何像 Git 一样思考”的很好的部分）
• Git 社区书籍
• Pro Git 书籍
• Git Ready（与其说是指南，不如说是“片段”集合）
• SVN 到 Git 速成课程（如果您已经使用 SVN 一段时间，会有帮助）
• Git Magic（Git 的友好介绍）

最后，还有一些可能会派上用场的 Git “备忘单”：此处和此处。

---

GUI Git 程序

窗口

• TortoiseGit（与 Windows 资源管理器集成良好的流行程序）
• msysgit

苹果电脑

• Git 塔
• GitHub for Mac（来自为您带来 GitHub 的人）

Linux / 跨平台

• GitG（这是我使用的）
• QGit
• Git Cola（跨平台）

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!