APACHE_LOOKUP_URI |
Regarde URI avec Apache |
|---|---|
| PHP 3+ | |
Syntaxe
| function apache_lookup_uri($filename) |
Paramètres
| Nom | Description |
|---|---|
| $filename | Ce paramètre permet d'indiquer le nom du fichier ou de l'URI |
Retour
| Valeur | Description | |
|---|---|---|
| Objet | Ce type de données contient les informations suivantes : | |
| Champs | Description | |
| "allowed" | Ce champs permet d'indiquer le code d'état de la page alloué | |
| "args" | Ce champs permet d'indiquer les paramètres de l'URI | |
| "boundary" | Ce champs permet d'indiquer les limites | |
| "byterange" | Ce champs permet d'indiquer le nombre d'octets de la page | |
| "bytes_sent" | Ce champs permet d'indiquer le nombre d'octets de la page envoyé au navigateur | |
| "clength" | Ce champs permet d'indiquer la valeur du compteur de longueur | |
| "content_type" | Ce champs permet d'indiquer le type de page MIME | |
| "filename" | Ce champs permet d'indiquer le nom de la page | |
| "method" | Ce champs permet d'indiquer la méthode de requête: GET, POST,... | |
| "mtime" | Ce champs permet d'indiquer le temps | |
| "no_cache" | Ce champs permet d'indiquer le code d'état de tampon d'accélération | |
| "no_local_copy" | Ce champs permet d'indiquer le code d'état de la présence d'une copie locale | |
| "path_info" | Ce champs permet d'indiquer des informations sur le chemin de la page | |
| "request_time" | Ce champs permet d'indiquer le temps de la requête | |
| "send_bodyct" | Ce champs permet d'indiquer le code d'état de l'envoi du corps de la page | |
| "status" | Ce champs permet d'indiquer un code d'état. | |
| "status_line" | Ce champs permet d'indiquer la ligne d'état de la page. | |
| "the_request" | Ce champs permet d'indiquer la requête demander par le navigateur Internet. | |
| "unparsed_uri" | Ce champs permet d'indiquer le chemin URI | |
| "uri" | Ce champs permet d'indiquer l'adresse URI de la page | |
Description
Cette fonction permet de demander les informations de l'URI spécifié.
Remarques
- Recherche des informations de la requête Apache : La fonction apache_lookup_uri permet de récupérer des informations détaillées sur une ressource URI spécifique dans le contexte d'un serveur Apache. Elle permet de simuler une requête pour une URI donnée, renvoyant des informations telles que le chemin local, les variables de requête, et l'état de la ressource, ce qui peut être utile pour des tests ou du traitement conditionnel.
- Retourne un tableau avec les résultats : Lorsque la fonction est appelée, elle retourne un tableau associatif contenant plusieurs clefs, telles que filename, uri, status, et args. Ces données peuvent être utilisées pour analyser et traiter la requête, et peuvent servir à simuler ou à tester des requêtes sans réellement accéder aux ressources.
- Limité à Apache et mod_php : apache_lookup_uri est disponible uniquement lorsque PHP fonctionne comme un module d'Apache (mod_php). Elle n'est pas accessible dans des environnements comme PHP-FPM, CGI ou d'autres serveurs Web comme Nginx, ce qui limite son utilisation à des serveurs spécifiques.
- Utilisation dans des scénarios de test ou de gestion d'URL : Cette fonction est particulièrement utile dans des situations où il est nécessaire de tester ou manipuler des URI avant de réellement traiter une requête. Par exemple, dans des scripts qui valident ou traitent des redirections, cette fonction peut être utilisée pour vérifier comment une URI serait traitée par Apache.
- Simulation des requêtes Apache sans exécuter la demande réelle : apache_lookup_uri peut être utilisée pour obtenir des informations sur une URI sans qu'une demande réelle ne soit envoyée au serveur. Cela peut être utile dans des contextes où il est nécessaire de manipuler des requêtes sans interagir avec le fichier système ou effectuer des appels réseau.
- Dépendance à la configuration du serveur : Les résultats retournés par apache_lookup_uri peuvent dépendre des configurations spécifiques du serveur Apache, comme les directives DocumentRoot ou RewriteRule. Les variations dans la configuration d'Apache peuvent donc entraîner des résultats différents pour la même URI.
- Retourne des données comme dans un traitement de requête : Les données retournées par apache_lookup_uri ressemblent à celles que l'on obtiendrait après qu'Apache ait traité une requête réelle. Cela inclut des informations comme le chemin absolu du fichier local (filename), l'état de la requête (status), et d'autres paramètres comme args pouvant contenir des variables de requête.
- Utilisation moins courante en production : Bien que la fonction puisse être utile pour des tests internes ou des scripts d'administration, elle est rarement utilisée dans des applications de production. Son rôle se limite principalement aux environnements de développement ou de diagnostic où il est nécessaire de tester ou de comprendre le comportement d'Apache avec des URIs spécifiques.
Exemple
L'exemple permet d'afficher les informations sur le fichier «apache_lookup_uri_samples.php» lequel est situé dans le dossier «C:/www/gladir/samples/» :
- <?php
- echo "Affiche les information en lien avec la page «apache_lookup_uri_samples.php» :<br />";
- var_dump(apache_lookup_uri('apache_lookup_uri_samples.php'));
- ?>
on obtiendra un résultat ressemblant à ceci :
Affiche les information en lien avec la page «apache_lookup_uri_samples.php» :object(stdClass)#1 (16) { ["status"]=> int(200) ["the_request"]=> string(51) "GET /samples/apache_lookup_uri_samples.php HTTP/1.1" ["method"]=> string(3) "GET" ["mtime"]=> int(0) ["clength"]=> int(0) ["chunked"]=> int(0) ["content_type"]=> string(23) "application/x-httpd-php" ["no_cache"]=> int(0) ["no_local_copy"]=> int(1) ["unparsed_uri"]=> string(38) "/samples/apache_lookup_uri_samples.php" ["uri"]=> string(38) "/samples/apache_lookup_uri_samples.php" ["filename"]=> string(55) "C:/www/gladir/samples/apache_lookup_uri_samples.php" ["allowed"]=> int(0) ["sent_bodyct"]=> int(0) ["bytes_sent"]=> int(0) ["request_time"]=> int(1371138684) }
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
Références
PHP 4 - Guide du développeur, Edition First Interactive, Blake Schwendiman, 2002, ISBN: 2-84427-283-5, page 357
Dernière mise à jour : Dimanche, le 22 mars 2015