Código¶

Configuración inicial¶

Antes de trabajar en parches para CakePHP es una buena idea configurar tu entorno de trabajo.

Necesitarás los siguientes programas:

• Git

• PHP 8.1 o mayor

• PHPUnit 5.7.0 o mayor

Configura tu información de usuario con tu nombre/alias y correo electrónico de trabajo:

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

Clona el código fuente de CakePHP desde GitHub:

• Si no tienes una cuenta de GitHub créate una.

• Haz un fork del repositorio CakePHP haciendo clic en el botón Fork.

Después de haber hecho el fork, clónalo en tu equipo local:

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

Añade el repositorio original de CakePHP como respositorio remoto, lo usarás más adelante para buscar cambios en el repositorio de CakePHP. Esto te mantendrá actualizado con CakePHP:

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

Ahora que tienes configurado CakePHP deberías poder definir un $test de conexión de base de datos y ejecutar todos los tests.

Trabajar en un parche¶

Cada vez que quieras trabajar en un bug, una funcionalidad o en una mejora, crea una rama específica.

Tu rama debería ser creada a partir de la versión que quieras arreglar/mejorar. Por ejemplo, si estás arreglando un error en la versión 3.x deberías utilizar la rama master como rama origen. Si tu cambio es para un error de la serie 2.x deberías usar la rama 2.x. Esto hará más adelante tus merges más sencillos al no permitirte Github editar la rama destino:

# arreglando un error en 3.x
git fetch upstream
git checkout -b ticket-1234 upstream/master

# arreglando un error en 2.x
git fetch upstream
git checkout -b ticket-1234 upstream/2.x

Lo anterior creará una rama local basada en la rama upstream 2.x (CakePHP)

Trabaja en tu correción y haz tantos commits como necesites, pero ten siempre en mente lo siguiente:

• Sigue las Estándares de codificación.

• Añade un caso de prueba para mostrar el error arreglado o que la nueva funcionalidad funciona.

• Mantén lógicos tus commits y escribe comentarios de commit bien claros y concisos.

Enviar un Pull Request¶

Una vez estén hechos tus cambios y estés preparado para hacer el merge con CakePHP tendrás que actualizar tu rama:

# Hacer rebase de la corrección en el top de master
git checkout master
git fetch upstream
git merge upstream/master
git checkout <nombre_rama>
git rebase master

Esto buscará y hará merge de cualquier cambio que haya sucedido en CakePHP desde que empezaste. Entonces ejecutará rebase o replicará tus cambios en el top del actual código.

Puede que encuentres algún conflicto durante el rebase. Si este finaliza precipitadamente puedes ver qué archivos son conflictivos/un-merged con git status. Resuelve cada conflicto y continúa con el rebase:

git add <nombre_archivo> # haz esto con cada archivo conflictivo.
git rebase --continue

Comprueba que todas tus pruebas continúan pasando. Entonces sube tu rama a tu fork:

git push origin <nombre-rama>

Si has vuelto a hacer rebase después de hacer el push de tu rama necesitarás forzar el push:

git push --force origin <nombre-rama>

Una vez tu rama esté en GitHub puedes enviar un pull request en GitHub.