Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/belarif/bile-mo

Créez un web service exposant une API
https://github.com/belarif/bile-mo

api-rest jms-serializer jwt php8 swagger-ui symfony5

Last synced: about 1 month ago
JSON representation

Créez un web service exposant une API

Awesome Lists containing this project

README

        

## Installation du projet
### Copie du projet en local

1. Cliquez sur le bouton "code", puis sur la section HTTPS qui affiche l'url suivante :
####
https://github.com/belarif/bile-mo.git

copiez cette url à utiliser pour installer le projet en local.

2. Ouvrez le terminal de votre IDE. Si vous utilisez le server WampServer64, positionnez vous sur le chemin c:/wamp64/www comme suit :
####
cd c:/wamp64/www
si vous utilisez un server autre que WampServer64, positionnez vous sur le chemin qui permettra l'exécution de l'API.

3. Sur le même chemin, tapez la commande suivante pour cloner le projet :
####
git clone https://github.com/belarif/bile-mo.git

Après exécution de la commande, le projet sera copié dans le répertoire www

### Installation des dépendances
composer install

### Génération de SSL keys privé et public pour JWT
php bin/console lexik:jwt:generate-keypair

### Création de la base de données
1. Créer votre base de données en local
2. Modifier le fichier .env pour adapater les accès à votre SGBD
3. Créer le schéma de votre base de données:
####
php bin/console doctrine:migrations:migrate

### Chargement des fixtures
php bin/console doctrine:fixtures:load
### Lancement de l'API
php -S localhost:8000 -t public/

### Génération du token depuis Postman :
- username : [email protected]
- password : admin1

### Lancement de la documentation de l'API
1. génération du fichier swagger.json
####

./vendor/bin/openapi --format json --output ./public/swagger/swagger.json ./src/swagger/swagger.php src
2. consultation de la documentation
####
http://localhost:8000/swagger/index.html#/