APACHE_REQUEST_HEADERS |
Requête d'entête d'Apache |
|---|---|
| PHP 4.3.0+ | |
Syntaxe
| function apache_request_headers() |
Retour
| Valeur | Description |
|---|---|
| tableau | Ce type de données permet d'indiquer, à l'aide d'une liste de chaîne de caractères, chacune des lignes d'envois de l'entête HTTP : Accept, Accept-Language, Accept-Encoding, User-Agent, Host, Connection,... |
| FALSE | Cette valeur permet d'indiquer qu'il y a une erreur pendant la demande. |
Description
Cette fonction permet de demander l'entête de requête d'envoi HTTP.
Remarques
- Récupère les en-têtes de la requête HTTP : La fonction apache_request_headers permet de récupérer tous les entêtes de la requête HTTP envoyée au serveur Apache. Ces entêtes contiennent des informations importantes comme le type de contenu, les cookies, la langue préférée de l'utilisateur, ou encore l'adresse IP du client, pouvant être utilisées pour gérer la réponse du serveur.
- Retourne un tableau associatif : Lorsqu'elle est appelée, apache_request_headers retourne un tableau associatif où chaque clef correspond à un entête de la requête et chaque valeur à sa valeur associée. Par exemple, l'entête User-Agent pourrait être récupéré avec la clef User-Agent, et sa valeur serait le type de navigateur utilisé par le client.
- Limité à l'environnement Apache avec mod_php : Cette fonction est disponible uniquement dans un environnement Apache où PHP est exécuté comme module (mod_php). Elle ne fonctionne pas dans d'autres environnements tels que PHP-FPM, CGI, ou Nginx, ce qui limite son utilisation à des serveurs Apache spécifiques.
- Utilisation dans le traitement des requêtes : apache_request_headers est utile pour interagir avec des entêtes HTTP personnalisés ou pour effectuer des actions en fonction des informations dans ces en-têtes. Par exemple, elle peut être utilisée pour vérifier un jeton d'authentification ou pour examiner les paramètres d'une requête avant de répondre au client.
- Entêtes HTTP standard et personnalisés : La fonction permet de récupérer aussi bien les entêtes HTTP standards (comme Accept, Host, Content-Type) que les entêtes personnalisés définis par le client (par exemple, X-Requested-With). Cependant, certains entêtes personnalisés peuvent être manipulés par Apache, ce qui pourrait affecter leur disponibilité.
- Problèmes de disponibilité sur certains serveurs : Dans certains cas, certains entêtes HTTP peuvent ne pas être accessibles via apache_request_headers si Apache a été configuré de manière restrictive ou si des modules modifiant les entêtes sont en place. De plus, les informations sensibles peuvent être filtrées pour des raisons de sécurité, comme dans le cas des cookies sécurisés.
- Retourne false si non disponible : Si la fonction est appelée dans un environnement où elle n'est pas disponible, par exemple lorsqu'on n'utilise pas Apache ou lorsqu'un serveur ne permet pas l'accès aux entêtes, elle retourne false. Il est donc important de vérifier la disponibilité de la fonction avec function_exists('apache_request_headers') pour éviter des erreurs dans des environnements non compatibles.
- Ne modifie pas les en-têtes de la requête : Contrairement à d'autres fonctions pouvant modifier les entêtes HTTP (comme header()), apache_request_headers se contente de lire les en-têtes de la requête et de les retourner sous forme de tableau. Cela permet aux développeurs d'analyser ou d'examiner le journaux de ces entêtes sans avoir d'impact direct sur la réponse envoyée au client.
Voir également
Serveur ou service logiciel - Apache - Introduction
Index des extensions de fichier - Format de fichier : httpd.conf
Index des extensions de fichier - Format de fichier : .htaccess
Index des extensions de fichier - Format de fichier : .htpasswd
Dernière mise à jour : Dimanche, le 22 mars 2015