Fork me on GitHub

Les standards PSR supportés

Jaxon supporte désormais les standards HTTP Message Interface (PSR-7), HTTP Handlers (PSR-15), et HTTP Factories (PSR-17).

PSR-7: HTTP Message Interface

Dans le package jaxon-core et dans ses plugins de requête, la requête HTTP reçue en entrée de l'application est représentée par l'interface Psr\Http\Message\ServerRequestInterface, définie par le standard PSR-7.

Cette interface fournit des fonctions pour lire, dans la requête HTTP, les arguments, les paramètres, et les fichiers uploadés.

Les classes Jaxon renvoient toujours un objet de type Jaxon\Response\ResponseInterface, mais celui-ci possède une méthode toPsr() qui le transforme en un objet qui implémente l'interface Psr\Http\Message\ResponseInterface, définie par le standard PSR-7.

PSR-17: HTTP Factories

Jaxon utilise un package tiers qui implémente le standard PSR-17, nyholm/psr7-server, pour lire les requêtes HTTP qu'il reçoit.

Ce package fournit les fonctions pour créer, à partir du contenu de la requête HTTP, un objet qui implémente l'interface Psr\Http\Message\ServerRequestInterface définie par le standard PSR-7. Cet objet est lui-même défini dans le package nyholm/psr7.

PSR-15: HTTP Handlers

De plus en plus de frameworks PHP supportent le standard PSR-15, qui définit des interfaces pour deux types de composants qui traitent les requêtes HTTP:

  • les middlewares: Psr\Http\Server\MiddlewareInterface,
  • les request handlers: Psr\Http\Server\RequestHandlerInterface.

Jaxon fournit deux middlewares et un request handler.

Le middleware jaxon()->psr()->config($filename) prend en paramètre le chemin vers un fichier de configuration, et initialise la librairie avec son contenu.

Le middleware jaxon()->psr()->ajax() et le handler jaxon()->psr()->handler() traitent la requête Jaxon, et renvoient en réponse un objet qui implémente l'interface Psr\Http\Message\ResponseInterface. Un seul des deux sera donc utilisé dans une même application PHP.

Ces composants servent à intégrer Jaxon dans les frameworks PHP qui supportent le standard PSR-15.