Leon
b937b46625
|
||
|---|---|---|
| app | ||
| bootstrap | ||
| config | ||
| database | ||
| lang | ||
| public | ||
| resources | ||
| routes | ||
| storage | ||
| tests | ||
| .dockerignore | ||
| .editorconfig | ||
| .env.example | ||
| .gitattributes | ||
| .gitignore | ||
| .gitlab-ci.yml | ||
| AGENTS.md | ||
| Dockerfile | ||
| README.md | ||
| artisan | ||
| boost.json | ||
| compose.yaml | ||
| composer.json | ||
| composer.lock | ||
| docker-compose.prod.yml | ||
| package.json | ||
| phpunit.xml | ||
| vite.config.js | ||
README.md
Treasure Hunt API avec Laravel Sail
Ce projet se lance via Laravel Sail (Docker). Ce guide explique comment demarrer l'environnement et executer les commandes courantes.
Prerequis
- Docker Desktop ou Engine avec Docker Compose actif.
- Si
vendor/est absent, installez d'abord les dependances pour recuperer Sail:composer install(en local) ou./vendor/bin/sail composer install. - Copiez le fichier
.env.examplevers.envet adaptez les valeurs utiles (APP_PORT,VITE_PORT,DB_DATABASE,DB_USERNAME,DB_PASSWORD,FORWARD_DB_PORT).
Demarrage rapide
- Lancer la stack:
./vendor/bin/sail up -d. - Generer la cle d'application:
./vendor/bin/sail artisan key:generate. - Initialiser la base:
./vendor/bin/sail artisan migrate. - (Optionnel) Ajouter un alias shell pour simplifier:
alias sail="./vendor/bin/sail".
Ports et services
- Application:
APP_PORT(80 par defaut). - Vite:
VITE_PORT(5173 par defaut). - MySQL 8.0:
FORWARD_DB_PORT(3306 par defaut). Les donnees sont stockees dans le volume Dockersail-mysql. - Les conteneurs sont definis dans
compose.yaml(service principallaravel.testet basemysql).
Commandes courantes
- Demarrer:
sail up -d(ou./vendor/bin/sail up -dsans alias). - Arreter:
sail down. - Rebuild si l'image change:
sail up -d --buildousail build --no-cache. - Logs:
sail logs -f laravel.testousail logs -f mysql. - Shell applicatif:
sail shell(ousail bash). - Artisan:
sail artisan migrate,sail artisan migrate:fresh --seed,sail artisan tinker. - Tests:
sail artisan test.
Base de donnees
- Acces host:
127.0.0.1:<FORWARD_DB_PORT>avec les identifiants definis dans.env. - Pour repartir de zero:
sail down -v(supprime les volumes, donc les donnees) puissail up -detsail artisan migrate --seed.
Debug et outils
- Activer Xdebug en ajoutant dans
.env:SAIL_XDEBUG_MODE=develop,debugetSAIL_XDEBUG_CONFIG=client_host=host.docker.internal, puissail up -d --build. - Composer/PHP direct:
sail composer <cmd>,sail php -v. - Nettoyage des images intermediaires:
sail downpuisdocker system prune(optionnel).