TP-IGL-API

Lancer l'application Localement :

Exigences

Exigence	Version
PHP	7.3+
Composer	1.9+
MySQL	8.0+
Git	2.0+

Exécutez les commandes suivantes pour vérifier les versions installées actuelles:

php --version
git --version
composer --version

Pour MySQL Vous pouvez exécuter cette commande dans MySQL Command Line Client:

select version() ;

1. Cloner le repository :

git clone https://github.com/AbdelkhalekESI/TP-IGL-API

2. Installer les dépendances nécessaires :

composer install

3. Créez votre fichier .env à partir de .env.example et générez une clé d'application (n'oubliez pas de le configurer avec la base de données):

cp .env .env.example
php artisan key:generate  

4. Migrer la base de données et la remplir avec des données aléatoires:

php artisan migrate 
php artisan db:seed

5. Enfin, exécuter le serveur :

php artisan serve

6. Accéder à l'application via : http://127.0.0.1:8000

Lancer l'application en utilisant Docker :

Obtenir une instance locale de ce projet est très rapide en utilisant docker-compose et docker :

1. Cloner le repository :

git clone https://github.com/AbdelkhalekESI/TP-IGL-API/

2. Créer l'image de l'application et exécuter les services (Nginx,MySQL,app) :

docker-compose up -d --build database && docker-compose up -d --build web && docker-compose up -d --build app 

3. Assurer vous que vous êtes entrain d'exécuter cette commande dans le dossier racine de votre application laravel. Cette commande crée vos images de conteneur et les démarre enfin. Si tout se déroule comme prévu, vous devrier pouvoir accéder à votre application laravel exécutée à l'intérieur de votre conteneur à: http://127.0.0.1:80

Les Tests Unitaires

Dans cette application on a testé les requêtes avec phpunit , les requêtes qui sont testées sont :

• Ajouter un nouveau étudiant
• Afficher les informations d'un étudiant
• Modifier les informations d'un étudiant
• Supprimer un étudiant

Pour lancer les tests on exécute cette commande :

cd vendor/bin
phpunit ../../tests/APIs/StudentApiTest

Tests Avec Selenium

Exigences

Exigence	Version
Python	3.6+
Pip	9.0+

Avant de commancer vérifier bien que l'application est en cours d'éxecution (Front-end et Back-end) et lancer ces commandes :

cd Selenium-Test
pip install selenium
python script.py

Documentation des API

Vous pouvez accéder à la documentation généré automatiquement à partir de Laravel Swagger ici http://127.0.0.1:8000/api/docs

et voici une capture pour tous les APIs du Model Etudiant :