Soporte GitHub del curso

Este documento proporciona información sobre cómo utilizar GitHub para el curso, incluyendo la estructura del repositorio y las ramas disponibles.

Se recomienda que los alumnos realicen las prácticas de los temas, e incluso utilicen su propio github para almacenar sus proyectos. Dejando este repositorio como referencia para poder consultar los ejemplos y el código fuente proporcionado por el instructor.

Aunque este proyecto de GitHub es público, solo es posible clonarlo y no se permite hacer "fork" o "pull request". Por tanto las modificaciones que haga cada alumno no podrán ser almacenadas en este proyecto.

En este documento se proporcionan las herramientas mínimas de git para clonar y manejar las ramas del repositorio. la aplicación git queda fuera del alcance de este curso.

Repositorio del curso

El repositorio del curso se encuentra en la siguiente URL: 2025_Laravel_32_act.

En este repositorio encontraremos los ejemplos que se iran desarrollando a lo largo del curso.

Ramas del respositorio

El funcionamiento he intentado que sea lo más simple posible. Por ello, existen múltiples ramas. Por cada tema tenemos una rama de inicio y una rama de finalización.

rama	descripción
main	Rama principal del repositorio.
tema02-inicio	Rama con el código inicial del tema 2.
tema02-final	Rama con el código final del tema 2. Antes de la instalación de laravel
tema02-laravel-inicio	Rama con el código inicial del tema 2, antes de instalar laravel.
tema02-laravel-final	Rama con el código final del tema 2, con Laravel ya instalado.
tema03-inicio	Rama con el código inicial del tema 3.
tema03-final	Rama con el código final del tema 3.
tema04-inicio	Rama con el código inicial del tema 4.
tema04-final	Rama con el código final del tema 4.
tema05-inicio	Rama con el código inicial del tema 5.
tema05-final	Rama con el código final del tema 5.
tema06-inicio	Rama con el código inicial del tema 6.
tema06-final	Rama con el código final del tema 6.
tema07-inicio	Rama con el código inicial del tema 7.
tema07-final	Rama con el código final del tema 7.
tema08-inicio	Rama con el código inicial del tema 8.
tema08-final	Rama con el código final del tema 8.
tema09-inicio	Rama con el código inicial del tema 9.
tema09-final	Rama con el código final del tema 9.

El tema 10 que es el de despliegue no tiene contenido en el repositorio.

Clonar el repositorio

Lo primero que tenemos que hacer es situarnos en la carpeta que contendrá el proyecto y luego clonar el repositorio en nuestro equipo local. Para ello, abrimos un terminal y ejecutamos el siguiente comando:

git clone https://github.com/jbeteta-ies/2025_Laravel_32_act.git

Cambiar de rama

Para cambiar de rama, primero nos situamos en la carpeta que contendrá el proyecto y luego ejecutamos el siguiente comando, sustituyendo <nombre-de-la-rama> por la rama a la que queremos cambiar:

cd 2025_Laravel_32_act
git checkout `nombre-de-la-rama`

Actualizar el repositorio

Para actualizar el repositorio y obtener los últimos cambios, ejecutamos el siguiente comando:

git pull origin `nombre-de-la-rama`

Sustituyendo <nombre-de-la-rama> por la rama en la que estamos trabajando.

Puesta en marcha del repositorio

Lo primero será siempre levantar el entorno (docker compose) explicado en el tema 2. Las carpetas mysql\data y mysql\tmp no se almacenan en el repositorio. Por tanto es responsabilidad del usuario hacer un primer --build del entorno para que mysql inicie las estructuras de la base de datos.

Hay que tener en cuenta que no todo el contenido del proyecto se guarda en el repositorio. Por ello, una vez que hemos cambiado a la rama deseada, debemos seguir los pasos habituales para poner en marcha un proyecto Laravel, que incluyen:

Instalar las dependencias con Composer:

EL siguiente paso será meternos en el contenedor php y ejecutar el siguiente comando:
```
composer install
```
Este comando debe instalar todas las dependencias, ya que no se almacenan en el repositorio.
Configurar el archivo .env:

El fichero .env por seguridad, np se almacena en el repositorio. Por tanto, debemos crear uno nuevo a partir del archivo de ejemplo .env.example ejecutando el siguiente comando:
```
cp .env.example .env
```
Luego, editar el archivo .env para configurar la base de datos y otras variables de entorno.
Generar la clave de la aplicación:
```
php artisan key:generate
```
Ejecutar las migraciones
```
php artisan migrate
```