Code¶

Configuration Initiale¶

Avant de travailler sur les correctifs pour CakePHP, c’est une bonne idée de définir la configuration de votre environnement. Vous aurez besoin des logiciels suivants:

• Git

• PHP 8.1 ou supérieur

• PHPUnit 5.7.0 ou supérieur

Mettez en place vos informations d’utilisateur avec votre nom/titre et adresse e-mail de travail:

git config --global user.name 'Bob Barker'
git config --global user.email '[email protected]'

Récupérez un clone du code source de CakePHP sous GitHub:

• Si vous n’avez pas de compte github , créez-en un.

• Forkez le dépôt de CakePHP en cliquant sur le bouton Fork.

Après que le fork est fait, clonez votre fork sur votre machine locale:

git clone git@github.com:YOURNAME/cakephp.git

Ajoutez le dépôt CakePHP d’origine comme un dépôt distant. Vous utiliserez ceci plus tard pour aller chercher les changements du dépôt CakePHP. Cela vous permettra de rester à jour avec CakePHP:

cd cakephp
git remote add upstream git://github.com/cakephp/cakephp.git

Maintenant que vous avez configuré CakePHP, vous devriez être en mesure de définir une connexion à la base $test, et d’exécuter tous les tests.

Travailler sur un Correctif¶

A chaque fois que vous voulez travailler sur un bug, une fonctionnalité ou une amélioration, créez une branche avec un sujet.

La branche que vous créez devra être basée sur la version pour laquelle votre correctif/amélioration tourne. Par exemple, si vous réglez un bug dans 3.x, vous pouvez utiliser la branche master comme base de votre branche. Si vos changements ont pou objet de régler un bug pour les séries de version 2.x, vous devrez utiliser la branche 2.x. Cela simplifiera la fusion future de vos changements puisque Github ne vous permet pas de modifier la branche cible:

# régler un bug dans 3.x
git fetch upstream
git checkout -b ticket-1234 upstream/master

# régler un bug dans 2.x
git fetch upstream
git checkout -b ticket-1234 upstream/2.x

Ce qui précède va créer une branche locale basée sur la branche (CakePHP) 2.x en amont. Travaillez sur votre correctif, et faîtes autant de commits que vous le souhaitez; mais gardez à l’esprit ce qui suit:

• Suivez ceci Normes de codes.

• Ajoutez un cas de test pour montrer que le bug est réglé, ou que la nouvelle fonctionnalité marche.

• Faîtes des commits logiques, et écrivez des messages de commit bien clairs et concis.

Soumettre un Pull Request¶

Une fois que vos changements sont faits et que vous êtes prêts pour la fusion dans CakePHP, vous pouvez mettre à jour votre branche:

# Rebaser un fix en haut de la branche master
git checkout master
git fetch upstream
git merge upstream/master
git checkout <branch_name>
git rebase master

Cela récupérera et fusionnera tous les changements qui se sont passés dans CakePHP depuis que vous avez commencé. Cela rebasera - ou remettra vos changements au dessus du code actuel. Il y aura peut-être un conflit pendant le rebase. Si le rebase quitte rapidement, vous pourrez voir les fichiers qui sont en conflit/Non fusionnés avec git status. Résolvez chaque conflit et continuer le rebase:

git add <filename> # Faîtes ceci pour chaque fichier en conflit.
git rebase --continue

Vérifiez que tous les tests continuent de fonctionner. Ensuite faîtes un push de votre branche à votre fork:

git push origin <branch-name>

Si vous avez rebasé après avoir pusher votre branche, vous devrez utiliser le push avec l’option force:

git push --force origin <branch-name>

Une fois que votre branche est sur GitHub, vous pouvez soumettre un pull request sur GitHub.