Un projet de découverte de Symfony pour la création d'une API.

https://documenter.getpostman.com/view/2209621/2s93JwP2cv

• DBBrowser https://sqlitebrowser.org/dl/

:

Requis: Vous devez avoir le module sqlite3 d'activé sur votre installation PHP. Pour vérifier: php -m

Installation de Symfony en version minimale (aucune dépendance, il faudra tout installer manuellement)

symfony new API-Gestion-Stages-Etudiants --version="5.4"

Via composer, vous allez ajouter les dépendances suivantes, elles seront utiles ultérieurement.

# Uniquement en environnement de dev, un bundle facilitant la création d'éléments dans Symfony
composer require symfony/maker-bundle --dev

# Si vous utilisez un serveur Apache
composer require symfony/apache-pack

# Pour la base de données
composer require doctrine/annotations
composer require orm

# Pour sérialiser et normaliser les données
composer require symfony/serializer-pack

Récupérez le projet depouis GitHub.

git clone [email protected]:LiliwoL/Symfony-API-Gestion-Stages-Etudiants.git
cd Symfony-API-Gestion-Stages-Etudiants

Dans le fichier composer.json, toutes les dépendances nécessaires sont listées. Installez-les avec la commande :

composer install

Comme dans tous les projets Symfony, la configuration se fait dans un fichier d'environnement. Créez le fichier .env dans lequel on va spécifier un secret, mais surtout l'emplacement de la base de données sqlite. Vous pouvez recopier le fichier .env.sample comme exemple.

Les entités sont la représentation objet des tables qui figureront dans la base de données

symfony console make:entity

Répondez aux questions.

On va appliquer à la base de données les déclarations objets. En résumé, les entités seront transformées en tables dans la base.

# Génération de fichiers de migration
symfony console make:migration

# Application des migrations dans la base
symfony console doctrine:migration:migrate

Pour ajouter les données dans sqlite, utilisez les fichiers sql placés dans le dossier DATA.

symfony console make:controller ApiStudentController

Afin d'afficher sous forme de tableau un objet, on va recourir à la normalisation. Dans le sens inverse, ce sera de la sérialization.

Symfony propose des interfaces performantes pour cela.

On utilisera le composant serializer-pack. Il a normalement été installé à la création, ou au clonage du projet.

composer require symfony/serializer-pack

On va renvoyer un objet de la base de données au format JSON

Lancez votre serveur web Apache ou utilisez le serveur intégré à Symfony.

symfony serve

Avec l'utilitaire Postman, ouvrez la collection de requêtes située dans PostmanRequestsCollection.

Vérifiez les routes existantes.

• Améliorez l'existant (vérification, retirer les commandes de debug dd, contenu des réponses)
• Ajouter un contrôleur Company sur le même modèle.
• Publiez le résultat dans votre GitHub et fournissez l'url à l'enseignant.
• Générer une documentation de l'API
  • https://github.com/slatedocs/slate
  • https://github.com/nelmio/NelmioApiDocBundle
  • https://swagger.io/solutions/api-documentation/
  • https://readme.com/documentation
  • https://github.com/Mermade/widdershins
  • https://www.postman.com/api-documentation-tool/

symfony console make:entity

symfony console make:entity

Entité: Internship

Champ: idStudent Type: relation RelationType: ManyToOne Nullable: no Add a property to Student: yes New field inside Student: internships OrphanRemoval: no

Champ: idCompany Type: relation RelationType: ManyToOne Nullable: no Add a property to Student: yes New field inside Student: internships OrphanRemoval: no

Champ: startDate Type: date

Champ: endDate Type: date

symfony console make:migration

symfony console d:m:m

On fait ensuite le controller ApiInternshipController avec les actions

• index
• add

Problème: Si on retente les routes pour lister les étudiants

Message Circular Reference

Il faut ajouter un contexte au normalizer.

GET /api/student

POST /api/student

Attention au Header, qui DOIT être en json

Payload à fournir:

{
    "name":"didier",
    "firstname":"favreau",
    "picture": "TEST image vide",
    "date_of_birth": "15-05-1981",
    "grade": "PROF"
}

https://openclassrooms.com/fr/courses/7709361-construisez-une-api-rest-avec-symfony/7795148-authentifiez-et-autorisez-les-utilisateurs-de-l-api-avec-jwt https://dev.to/loopdelicious/using-jwt-to-authenticate-and-authorize-requests-in-postman-3a5h https://jwt.io/introduction

https://miniwebtool.com/fr/random-string-generator/