APACHE_SETENV |
Fixe l'environnement d'Apache |
| PHP 4.2+ |
Syntaxe
|
function apache_setenv($variable,$value);
|
function apache_setenv($variable,$value,$walk_to_to);
|
Paramètres
| Nom |
Description |
| $variable |
Ce paramètre permet d'indiquer le nom de la variable d'environnement d'Apache |
| $value |
Ce paramètre permet d'indiquer la valeur à fixer dans la variable d'environnement d'Apache |
| $walk_to_to |
Ce paramètre permet d'indiquer le mode de récupération des variables : |
| 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 |
| TRUE |
Cette valeur permet d'indiquer que l'opération a réussi. |
| FALSE |
Cette valeur permet d'indiquer une erreur lors de la lecture de la valeur de la variable. |
Description
Cette fonction permet de fixer une variable d'environnement d'Apache version 2 ou supérieur.
Remarques
- Définit une variable d'environnement pour Apache : La fonction apache_setenv permet de définir une variable d'environnement pour le processus
Apache. Ces variables sont souvent utilisées pour entreposer des informations de configuration ou des paramètres temporaires
spécifiques au serveur, tels que les paramètres de sécurité, les informations de base de données, ou les configurations de débogage.
- Variables d'environnement spécifiques au processus Apache : Les variables définies par apache_setenv sont spécifiques au processus
Apache et à la requête HTTP en cours. Ces variables ne sont pas persistantes
au-delà de la durée du processus de traitement de la requête. Cela signifie qu'elles ne seront pas disponibles après la fin du traitement d'une requête.
- Doit être appelée avant le début de l'envoi de la réponse : La fonction apache_setenv doit être appelée avant que les entêtes
HTTP ne soient envoyés au client. Cela est dû au fait qu'Apache utilise ces variables d'environnement pour la configuration
de certains aspects de la gestion de la requête et de la réponse. Une tentative d'appel après l'envoi des entêtes peut échouer.
- Ne modifie pas les variables d'environnement du système : Bien que apache_setenv définisse des variables d'environnement dans le contexte d'Apache, ces
variables ne sont pas stockées au niveau du système d'exploitation ou du shell. Elles sont locales au processus Apache
et seront perdues une fois la requête terminée ou le processus Apache redémarré.
- Manipulation d'entêtes HTTP et d'autres aspects du serveur : Les variables d'environnement définies avec apache_setenv peuvent être utilisées pour
ajuster le comportement du serveur Apache ou de ses modules. Par exemple, certaines configurations ou logiques de traitement des requêtes peuvent être conditionnées en
fonction des valeurs de ces variables, comme dans les directives de configuration d'Apache ou dans les scripts PHP.
- Utilité dans des environnements partagés : Lors de l'hébergement de plusieurs sites sur un serveur Apache
partagé, apache_setenv peut être utilisé pour définir des variables d'environnement spécifiques à chaque application ou site. Cela permet d'adapter le comportement du
serveur pour différents environnements sans avoir besoin de modifier les configurations globales du serveur.
- Sécurité et restrictions d'accès : Les variables d'environnement définies avec apache_setenv peuvent contenir des informations sensibles, comme des
clefs API ou des identifiants de connexion. Par conséquent, il est important de s'assurer que ces variables ne sont pas accessibles de manière non sécurisée par le
biais d'entêtes HTTP ou d'autres canaux d'accès.
- Précautions avec la configuration du serveur Apache : Pour que apache_setenv fonctionne correctement, il est nécessaire que le module Apache
mod_env soit activé, car ce module est responsable de la gestion des variables d'environnement dans Apache. Si ce module est désactivé, l'appel à
apache_setenv ne produira aucun effet et la fonction retournera un échec.
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
