Lista de requisitos obligatorios para levantar el proyecto:
Habilita la virtualizacion en la BIOS
NOTA: Si al instalar docker no te inicia y te da un mensaje pidiendote activar WSDL 2 sigue la guía que se muestra a continuación hasta el paso 5 (incluido):
Descarga la version 8.x de php, la manera más sencilla es instalando XAMPP que ya trae php consigo (la ruta de instalacion es indiferente, puedes modificarla y no usar la por defecto):
Una vez tengas php disponible en tu pc (para comprobar que lo tienes abre un terminal y escribe php -v tendra que responderte algo asi:
PHP 8.1.4 (cli) (built: Mar 16 2022 09:33:31) (ZTS Visual C++ 2019 x64) )
Tenemos disponible un instalador (setup) para windows:
Tambien es necesario NPM para compilar las fuentes del front (si procede):
Chocolatey es un programa que nos ayuda a descargar e instalar otros programas, vendria a ser parecido a los comandos npm install xxx o composer install xxx
En nuestro caso usamos make para instalar una herramienta propia de sistemas linux.
Una vez tenemos todos los requisitos previos instalados y funcionando procederemos a hacer el clone del proyecto desde nuestro repositorio
Ejecutamos el script init-script.bat para que se copien los archivos de ejemplo necesarios (.env.example, nginx_example.conf, mysqld-example.conf, etc)
Una vez hemos copiado estos dos ficheros de configuracion, podemos abrir un terminal en la ruta raiz del proyecto y ejecutar el comando
- make up
A continuacion se empezarán a crear las imagenes y contenedores docker, si no hay error ejecutamos el siguiente comando en la misma terminal
- make composer-install
- make app-init
y ya estarías listo para poder desarrollar y trabajar en nuestro back
Para lanzar los test unitarios debemos copiar el siguiente archivo:
-
./Track-Stars-back/application <- entramos a esta ruta copiamos el fichero phpunit.example.xml y lo pegamos renombrandolo como "phpunit.xml"
-
Despues ejecutamos el comando make test tambien tenemos otros comandos disponibles como make test-feature para ejecutar solamente los tests de la carpeta Feature e ignorar los tests unitarios
Te recomendamos instalar en tu proyecto laravel la siguiente libreria para autocompletado de codigo (barryvdh/laravel-ide-helper)