APACHE_GETENV |
Demande l'environnement d'Apache |
|---|---|
| PHP 4.3+ | |
Syntaxe
| function apache_getenv($variable); |
|
function apache_getenv($variable,$walk_to_to); |
Paramètres
| Nom | Description | |
|---|---|---|
| $variable | Ce paramètre permet d'indiquer le nom de la variable d'environnement d'Apache | |
| $walk_to_to | Ce paramètre permet d'indiquer le mode de récupération des variables : | |
| Constante | Description | |
| TRUE | Cette constante permet d'indiquer un mode de récupération de haut niveau utilisable dans tous les couches d'Apache. | |
| FALSE | Cette constante permet d'indiquer un mode de récupération normal. | |
Retour
| Valeur | Description |
|---|---|
| Chaîne de caractères | Ce type de données permet d'indiquer la valeur que contient la variable d'environnement spécifié. |
| FALSE | Cette valeur permet d'indiquer une erreur lors de la lecture de la valeur de la variable. |
Description
Cette fonction permet de demander une variable d'environnement d'Apache version 2 ou supérieur.
Remarques
- Accès aux variables d'environnement Apache : La fonction apache_getenv permet de récupérer la valeur d'une variable d'environnement spécifique configurée dans le serveur Apache. Ces variables sont souvent définies dans la configuration Apache (SetEnv ou PassEnv) et sont accessibles uniquement dans ce contexte.
- Limité à l'environnement Apache : Cette fonction est disponible uniquement lorsque PHP est exécuté en tant que module Apache (mod_php). Dans les environnements CGI, FPM, ou sous des serveurs Web comme Nginx, elle ne fonctionne pas et génère une erreur si elle est appelée.
- Alternative à la superglobale $_SERVER : Bien que les variables d'environnement puissent parfois être accessibles via la superglobale $_SERVER, apache_getenv est un moyen direct et explicite de récupérer des variables spécifiques, surtout si elles ont été définies dans la configuration d'Apache.
- Sensibilité à la casse des noms de variables : Les noms de variables passés à apache_getenv sont sensibles à la casse. Une variable définie comme SetEnv MyVariable value ne sera pas accessible si elle est appelée avec apache_getenv('myvariable').
- Retourne false si la variable n'existe pas : Si la variable demandée n'est pas définie dans la configuration Apache, apache_getenv retourne false. Cela permet de détecter facilement si une variable spécifique est configurée ou non dans l'environnement Apache.
- Dépendance à la configuration Apache : Pour que la fonction soit utile, il est nécessaire que les variables aient été définies dans le fichier de configuration d'Apache (httpd.conf, .htaccess, ou autres). Si les variables ne sont pas configurées, la fonction n'aura aucune utilité.
- Utilisation dans des scripts dynamiques : apache_getenv peut être utilisée pour adapter le comportement d'une application en fonction des configurations serveur. Par exemple, on peut récupérer des informations spécifiques comme un chemin d'accès, une clef API, ou des variables de debug définies dans Apache.
- Non portable entre serveurs Web : La dépendance à Apache fait que cette fonction n'est pas portable sur d'autres serveurs web. Pour garantir une compatibilité entre différents environnements, il est préférable d'utiliser des alternatives comme des fichiers de configuration ou des variables d'environnement définies au niveau du système.
Exemple
Voici un exemple montrant l'utilisation de cette fonction :
- <?php
- echo "Apache_GetEnv('HTTP_ACCEPT')=".apache_getenv('HTTP_ACCEPT')."<br />";
- echo "Apache_GetEnv('REMOTE_ADDR')=".apache_getenv('REMOTE_ADDR')."<br />";
- echo "Apache_GetEnv('SERVER_ADDR')=".apache_getenv('SERVER_ADDR')."<br />";
- ?>
on obtiendra un résultat ressemblant à ceci :
Apache_GetEnv('HTTP_ACCEPT')=text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8Apache_GetEnv('REMOTE_ADDR')=127.0.0.1
Apache_GetEnv('SERVER_ADDR')=127.0.0.1
Voir également
Langage de programmation - PHP - Référence des variables globales - $_SERVER
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