Récupération des données d'une requête HTTP

Translation into this language is not yet finished. You can help this project by translating the chapters and contributing your changes.

4.4. Récupération des données d'une requête HTTP

Dans la méthode d'action d'un contrôleur, vous devrez peut-être récupérer les données de la requête HTTP (les données telles que les variables GET et POST, les cookies, les en-têtes HTTP, etc.). Pour cela, Zend Framework 3 vous fournit la classe Zend\Http\Request, qui fait partie du composant Zend\Http.

Pour obtenir l'objet de requête HTTP, dans votre méthode d'action, vous pouvez utiliser le code suivant :

// Récupération de l'objet de requete HTTP
$request = $this->getRequest();

Le code ci-dessus renvoie une instance de la classe Zend\Http\Request, contenant toutes les données de la requête HTTP. Dans le tableau 4.3, vous trouverez les méthodes les plus utilisées de la classe Request avec une brève description.

Table 4.3. Méthodes de la classe `Zend\Http\Request`.

Nom de la méthode	Description
`isGet()`	Vérifie s'il s'agit d'une requête GET.
`isPost()`	Vérifie s'il s'agit d'une requête POST.
`isXmlHttpRequest()`	Vérifie si cette requête est une requête AJAX.
`isFlashRequest()`	Vérifie si cette requête est une requête Flash.
`getMethod()`	Renvoie une méthode pour cette requête.
`getUriString()`	Renvoie l'URI de cet objet requête sous forme de string.
`getQuery($name, $default)`	Renvoie un paramètre de la requête spécifique ($name) ou tous les paramètres de la requête. Si un paramètre n'est pas trouvé, renvoie la valeur `$default`.
`getPost($name, $default)`	Renvoie les paramètres post de la requete ou un seul de ces paramètres si un $name est spécifié.
`getCookie()`	Retourne l'en-tête du cookie.
`getFiles($name, $default)`	Renvoie les paramètres File liés à un fichier spécifié ($name) ou à l'ensemble des fichiers.
`getHeaders($name, $default)`	Renvoie l'ensemble des en-têtes passé dans la requete ou de tous les en-têtes d'un certain nom/type.
`getHeader($name, $default)`	Renvoie un en-tête par `$name`. Si un en-tête est introuvable, renvoie la valeur $default.
`renderRequestLine()`	Renvoie la ligne de requête formatée (première ligne) pour cette requête HTTP.
`fromString($string)`	Méthode statique qui génère un objet Request à partir d'une string HTTP Request bien formatée
`toString()`	Renvoie la requête HTTP brute au format string.