« Programmation PHP avec Symfony/API » : différence entre les versions

Un livre de Wikilivres.
Contenu supprimé Contenu ajouté
Aucun résumé des modifications
Aucun résumé des modifications
Ligne 26 : Ligne 26 :
* jms/serializer-bundle, avec des contrôleurs <code>extends RestController</code> et des méthodes aux annotations <code>@ApiDoc()</code>.
* jms/serializer-bundle, avec des contrôleurs <code>extends RestController</code> et des méthodes aux annotations <code>@ApiDoc()</code>.


=== symfony/serializer ===
==== symfony/serializer ====
<source lang=bash>
<source lang=bash>
composer require "symfony/serializer"
composer require "symfony/serializer"
</source>
</source>


=== jms/serializer-bundle ===
==== jms/serializer-bundle ====
<source lang=bash>
<source lang=bash>
composer require "jms/serializer-bundle"
composer require "jms/serializer-bundle"

Version du 30 mars 2019 à 20:17

Installation

Pour créer une interface de programmation (API) REST avec Symfony :

    composer require "friendsofsymfony/rest-bundle"

Pour éviter de tester les API en copiant-collant leurs chemins dans une commande cURL ou des outils comme Postman, on peut installer une interface graphique ergonomique :

    composer require "nelmio/api-doc-bundle"

Son URL se configure ensuite dans routes/nelmio_api_doc.yml :

app.swagger_ui:
    path: /api/doc
    methods: GET
    defaults: { _controller: nelmio_api_doc.controller.swagger_ui }

Sérialiseur

Enfin pour la sérialisation, on distingue deux solutions :

  • symfony/serializer, qui donne des contrôleurs extends FOSRestController et des méthodes aux annotations @Rest\Post()[1].
  • jms/serializer-bundle, avec des contrôleurs extends RestController et des méthodes aux annotations @ApiDoc().

symfony/serializer

    composer require "symfony/serializer"

jms/serializer-bundle

    composer require "jms/serializer-bundle"

Références