vcs:gitworkflow

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
vcs:gitworkflow [2019/01/28 10:01]
nikic Update for 7.4 branch and EOLs
vcs:gitworkflow [2021/03/30 16:53] (current)
nikic Drop master.php.net ssh key reference
Line 1: Line 1:
 ====== Git Workflow ====== ====== Git Workflow ======
  
-**Also read [[vcs::gitfaq]] and [[http://git.php.net/?p=php-src.git;a=blob;f=README.GIT-RULES;hb=refs/heads/master|README.GIT-RULES]] which have other workflows and PHP git tips.**+**Also read [[vcs::gitfaq]] and [[https://github.com/php/php-src/blob/master/CONTRIBUTING.md|CONTRIBUTING.md]] which have other workflows and PHP git tips.**
  
 Git does not enforce a certain workflow. For php-src we will use a workflow that is described below. Git does not enforce a certain workflow. For php-src we will use a workflow that is described below.
  
 We will use release branches for the php-src.git repository. We will have branches for actively maintained We will use release branches for the php-src.git repository. We will have branches for actively maintained
-versions. For example: **7.2**, **7.3**, **7.4** and **master** . A patch will be applied to the oldest possible branch.+versions. For example: **7.2**, **7.3**, **7.4**, **8.0** and **master**. A patch will be applied to the oldest possible branch.
 If the Release Manager of 5.6 accepts the change, commit it to the 5.6 branch. We will use regular merging between the release branches. If the Release Manager of 5.6 accepts the change, commit it to the 5.6 branch. We will use regular merging between the release branches.
 Bigger features can use feature branches, but developers are encouraged to fork php on github and start implementing the Bigger features can use feature branches, but developers are encouraged to fork php on github and start implementing the
Line 23: Line 23:
 Let's go through the process of setting it up and doing the merges. Let's go through the process of setting it up and doing the merges.
  
-==== Developing Patches Yourself ====+==== Initial Setup ====
  
-The initial setup: +  $ git clone git@github.com:php/php-src.git 
- +  $ cd php-src 
-  $ git clone git@git.php.net:php-src.git+  $ git config merge.NEWS.name "Keep the NEWS file" 
 +  $ git config merge.NEWS.driver 'touch %A' 
 +  $ git config merge.log true
      
 Please refer to [[gitfaq|Git FAQ]] for alternative cloning methods via HTTP or the Git Protocol. Please refer to [[gitfaq|Git FAQ]] for alternative cloning methods via HTTP or the Git Protocol.
  
-Then: +==== Patching a release branch ====
-   +
-  $ cd php-src +
-  $ git checkout -b PHP-7.2 origin/PHP-7.2 +
-  $ git checkout -b PHP-7.3 origin/PHP-7.3 +
-  $ git checkout -b PHP-7.4 origin/PHP-7.4+
  
-Patching the PHP 7.2 branch+Patching the PHP 7.2 branch:
  
   $ git checkout PHP-7.2   $ git checkout PHP-7.2
Line 46: Line 43:
   ... run tests ...   ... run tests ...
   $ git checkout PHP-7.3   $ git checkout PHP-7.3
-  $ git merge --no-ff --log PHP-7.2+  $ git merge PHP-7.2
   ... run tests ...   ... run tests ...
   $ git checkout PHP-7.4   $ git checkout PHP-7.4
-  $ git merge --no-ff --log PHP-7.3+  $ git merge PHP-7.3 
 +  ... run tests ... 
 +  $ git checkout PHP-8.0 
 +  $ git merge PHP-7.4
   ... run tests ...   ... run tests ...
   $ git checkout master   $ git checkout master
-  $ git merge --no-ff --log PHP-7.4+  $ git merge PHP-8.0
   ... run tests ...   ... run tests ...
   $ gitk master   $ gitk master
   ... review the merges ...   ... review the merges ...
-  $ git push origin+  $ git push origin PHP-7.2 PHP-7.3 PHP-7.4 PHP-8.0 master
   ... push to the official repository ...   ... push to the official repository ...
      
Line 62: Line 62:
  
 ==== Reviewing and closing pull requests ==== ==== Reviewing and closing pull requests ====
 +
 Johannes has created a [[http://qa.php.net/pulls | tool]] to easily close pull requests. It requires a valid PHP account. Johannes has created a [[http://qa.php.net/pulls | tool]] to easily close pull requests. It requires a valid PHP account.
 +
 +You can also include ''Closes GH-NNNN.'' in the commit message to automatically close a pull request.
  
 ==== Merge a pull request ==== ==== Merge a pull request ====
Line 71: Line 74:
   $ wget https://github.com/php/php-src/pull/1234.patch   $ wget https://github.com/php/php-src/pull/1234.patch
   $ git am -3 1234.patch   $ git am -3 1234.patch
 +  $ git commit --am # Adjust commit message to add "Closes GH-1234."
   ... REVIEW IT ...   ... REVIEW IT ...
   $ make test                     $ make test                  
   .. you better not forget that ...   .. you better not forget that ...
   $ git checkout PHP-7.3   $ git checkout PHP-7.3
-  $ git merge --no-ff --log PHP-7.2+  $ git merge PHP-7.2
   $ make test   $ make test
   $ git checkout PHP-7.4   $ git checkout PHP-7.4
-  $ git merge --no-ff --log PHP-7.3+  $ git merge PHP-7.3 
 +  $ make test 
 +  $ git checkout PHP-8.0 
 +  $ git merge PHP-7.4
   $ make test   $ make test
   $ git checkout master   $ git checkout master
-  $ git merge --no-ff --log PHP-7.4+  $ git merge PHP-8.0
   $ make test   $ make test
-  $ git push origin PHP-7.2 PHP-7.3 PHP-7.4 master     +  $ git push origin PHP-7.2 PHP-7.3 PHP-7.4 PHP-8.0 master     
  
 Additionally, the history of pull requests often requires cleanup. For most pull requests, all commits can be squashed into one. Additionally, the history of pull requests often requires cleanup. For most pull requests, all commits can be squashed into one.
Line 94: Line 101:
   $ git cherry-pick <SHA1-OF-PATCH-TO-MOVE>   $ git cherry-pick <SHA1-OF-PATCH-TO-MOVE>
   $ git checkout PHP-7.3   $ git checkout PHP-7.3
-  $ git merge --no-ff --log PHP-7.2+  $ git merge PHP-7.2
   $ git checkout PHP-7.4   $ git checkout PHP-7.4
-  $ git merge --no-ff --log PHP-7.3+  $ git merge PHP-7.3 
 +  $ git checkout PHP-8.0 
 +  $ git merge PHP-7.4
   $ git checkout master   $ git checkout master
-  $ git merge --no-ff --log PHP-7.4+  $ git merge PHP-8.0
   $ git push   $ git push
  
-**TL;DR: Always try to merge PHP-7.2 into PHP-7.3, then PHP-7.4, and then into master.**+**TL;DR: Always try to merge PHP-7.2 into PHP-7.3, then PHP-7.4, then PHP-8.0, and then into master.**
  
 ==== Merge patches received per mail ==== ==== Merge patches received per mail ====
Line 130: Line 139:
   $ git rebase master   $ git rebase master
      
-Once the feature is accepted merge it into master:+Once the feature is accepted, make sure your branch is up to date (see above) and then fast-forward merge it into master:
  
   $ git checkout master   $ git checkout master
-  $ git merge --no-ff --log feature/featurename+  $ git merge --ff-only feature/featurename
  
 ===== Workflow for external contributors ===== ===== Workflow for external contributors =====
Line 176: Line 185:
      
 If you don't have an issue-number, just make the branch name self-descriptive (ie: "json_encoding_fix" instead of "branch-001").  If you don't have an issue-number, just make the branch name self-descriptive (ie: "json_encoding_fix" instead of "branch-001"). 
-As stated before, branch from the lowest version possible. When you want to create a patch that needs to be incorporated into several branches, like a security fix for something in PHP-7.1, PHP-7.2, PHP-7.3, PHP-7.4 and the master, make sure you checkout a branch from PHP-7.1. You don't need to create separate pull requests for PHP-7.2, PHP-7.3, PHP-7.4 and master.+As stated before, branch from the lowest version possible. When you want to create a patch that needs to be incorporated into several branches, like a security fix for something in PHP-7.1, PHP-7.2, PHP-7.3, PHP-7.4, PHP-8.0 and the master, make sure you checkout a branch from PHP-7.1. You don't need to create separate pull requests for PHP-7.2, PHP-7.3, PHP-7.4, PHP-8.0 and master.
  
  
vcs/gitworkflow.1548669674.txt.gz · Last modified: 2019/01/28 10:01 by nikic