oscar car rental

Location de voiture à Oscar

Docker exécutant Nginx, PHP-FPM, Composer, MySQL et PHPMyAdmin.

Aperçu

1. Conditions préalables à l'installation

   Avant d'installer le projet, assurez-vous que les conditions préalables suivantes sont remplies.

2. Cloner le projet

   Nous téléchargerons le code depuis son référentiel sur GitHub.

3. Exécutez l'application

   À ce stade, nous aurons tous les éléments du projet en place.

4. Utiliser les commandes Docker

   Lors de l'exécution, vous pouvez utiliser les commandes docker pour effectuer des opérations récurrentes.

5. Application d'essai

---

Conditions préalables à l'installation

Pour exécuter les commandes docker sans utiliser sudo vous devez ajouter le groupe docker à your-user :

 sudo usermod -aG docker your-user

Pour l'instant, ce projet a été principalement créé pour Unix (Linux/MacOS) . Peut-être que cela pourrait fonctionner sous Windows.

Tous les éléments requis doivent être disponibles pour votre distribution. Les plus importants sont :

• Git
• Docker
• Docker Composer

Vérifiez si docker-compose est déjà installé en entrant la commande suivante :

which docker-compose

Vérifiez la compatibilité Docker Compose :

• Composer la référence de la version 3 du fichier

Sur Ubuntu et Debian, ceux-ci sont disponibles dans le méta-paquet build-essential. Sur d'autres distributions, vous devrez peut-être installer le compilateur GNU C++ séparément.

sudo apt install build-essential

Images à utiliser

• Nginx
• MySQL
• PHP-FPM
• Compositeur
• PHPMonAdmin

Vous devez être prudent lorsque vous installez des serveurs Web tiers tels que MySQL ou Nginx.

Ce projet utilise les ports suivants :

Serveur	Port
MySQL	8989
PHPMonAdmin	8080
Nginx	8000

---

Cloner le projet

Pour installer Git, téléchargez-le et installez-le en suivant les instructions :

git clone https://github.com/sahedbs23/oscar-car-rental.git

Allez dans le répertoire du projet :

 cd oscar-car-rental

Arbre du projet

 .
├── Makefile
├── README.md
├── data
│   └── db
│       ├── dumps
│       └── mysql
├── doc
├── docker-compose.yml
├── etc
│   ├── nginx
│   │   ├── default.conf
│   │   └── default.template.conf
│   ├── php
│   │   └── php.ini
│   └── ssl
└── web
    ├── app
    │   ├── composer.json.dist
    │   ├── phpunit.xml.dist
    │   ├── src
    │   │   └── App.php
    │   └── test
    │       └── bootstrap.php
    └── public
        └── index.php

1. Démarrez l'application :

   docker-compose up -d

   Veuillez patienter, cela peut prendre plusieurs minutes...

   docker-compose logs -f # Follow log output

2. Ouvrez votre navigateur préféré :

   • http://localhost:8000
   • http://localhost:8080 PHPMyAdmin (nom d'utilisateur : dev, mot de passe : dev)

3. Arrêter et effacer les services

   docker-compose down -v

---

Utiliser les commandes Docker

Installation du package avec composer

docker run --rm -v $( pwd ) /web/app:/app composer require symfony/yaml

Mise à jour des dépendances PHP avec composer

docker run --rm -v $( pwd ) /web/app:/app composer update

Tester une application PHP avec PHPUnit

docker-compose exec -T php ./app/vendor/bin/phpunit --colors=always --configuration ./app

Analyser le code source avec PHP Mess Detector

docker-compose exec -T php ./app/vendor/bin/phpmd ./app/src text cleancode,codesize,controversial,design,naming,unusedcode

Vérification des extensions PHP installées

docker-compose exec php php -m

Gestion de la base de données

Accès au shell MySQL

docker exec -it mysql bash

et

mysql -u " $MYSQL_ROOT_USER " -p " $MYSQL_ROOT_PASSWORD " 

Création d'une sauvegarde de toutes les bases de données

mkdir -p data/db/dumps

 source .env && docker exec $( docker-compose ps -q mysqldb ) mysqldump --all-databases -u " $MYSQL_ROOT_USER " -p " $MYSQL_ROOT_PASSWORD " > " data/db/dumps/db.sql " 

Restauration d'une sauvegarde de toutes les bases de données

 source .env && docker exec -i $( docker-compose ps -q mysqldb ) mysql -u " $MYSQL_ROOT_USER " -p " $MYSQL_ROOT_PASSWORD " < " data/db/dumps/db.sql " 

Création d'une sauvegarde d'une seule base de données

Notice: Remplacez "YOUR_DB_NAME" par votre nom personnalisé.

 source .env && docker exec $( docker-compose ps -q mysqldb ) mysqldump -u " $MYSQL_ROOT_USER " -p " $MYSQL_ROOT_PASSWORD " --databases YOUR_DB_NAME > " data/db/dumps/YOUR_DB_NAME_dump.sql " 

Restauration d'une sauvegarde d'une seule base de données

 source .env && docker exec -i $( docker-compose ps -q mysqldb ) mysql -u " $MYSQL_ROOT_USER " -p " $MYSQL_ROOT_PASSWORD " < " data/db/dumps/YOUR_DB_NAME_dump.sql " 

Exécutez l'application

L'application a exposé quelques points de terminaison d'API

Notice: Importez la collection Postman depuis api-doc/postman_collection.json

Notice: Importez l'environnement Postman depuis api-doc/postman_environment.json

Notice: Un permis voiture est unique au niveau de la base de données. Vous pouvez importer le contenu du fichier une seule fois.

• OBTENEZ http://localhost:8000/cars pour lister et rechercher des collections de voitures.
• OBTENEZ http://localhost:8000/cars/{car id} pour lire les détails d'une voiture.
• POST http://localhost:8000/cars pour créer une nouvelle voiture.
• Obtenez http://localhost:8000/read-files pour lire le contenu des fichiers CSV et JSON.
• POST http://localhost:8000/write-files pour importer le contenu des fichiers CSV et JSON dans la base de données.