File: /opt/bitnami/apache2/manual/env.html.fr.utf8
<!DOCTYPE html SYSTEM "about:legacy-compat">
<html lang="fr"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="width=device-width, initial-scale=1" name="viewport">
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Apache httpd et les variables d'environnement - Serveur HTTP Apache Version 2.4</title>
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="./style/css/prettify.css">
<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Signaler un bug</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="./images/feather.png"></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif"></a></div>
<div id="path">
<a href="https://www.apache.org/">Apache</a> > <a href="https://httpd.apache.org/">Serveur HTTP</a> > <a href="https://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Apache httpd et les variables d'environnement</h1>
<button aria-label="Toggle language list" class="lang-toggle"><svg xmlns="http://www.w3.org/2000/svg" stroke-width="2" stroke="currentColor" fill="none" viewBox="0 0 24 24" height="16" width="16"><circle r="10" cy="12" cx="12"/><line y2="12" x2="22" y1="12" x1="2"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg></button>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/env.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/env.html" title="Français"> fr </a> |
<a href="./ja/env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/env.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<div class="outofdate">Cette traduction peut être périmée. Vérifiez la version
anglaise pour les changements récents.</div>
<p>Deux types de variables d'environnement affectent le serveur
HTTP Apache.</p>
<p>Le premier type correspond aux variables d'environnement
contrôlées par le système d'exploitation sous-jacent et définies
avant le démarrage du serveur. Leurs valeurs peuvent être utilisées
directement dans les fichiers de configuration, et peuvent
éventuellement être transmises aux scripts CGI et SSI à l'aide de la
directive PassEnv.</p>
<p>Le second type correspond aux variables nommées appelées aussi
<em>variables d'environnement</em> dans lesquelles le serveur HTTP
Apache stocke des informations via un mécanisme spécial. Ces
informations peuvent servir à contrôler diverses opérations comme
l'enregistrement des traces ou le contrôle d'accès. On utilise aussi ces
variables dans le mécanisme de communication avec les programmes externes
comme les scripts CGI. Ce document présente différentes méthodes pour
manipuler et utiliser ces variables.</p>
<p>Bien que ces variables soient référencées comme <em>variables
d'environnement</em>, il ne faut pas les confondre avec les variables
d'environnement contrôlées par le système d'exploitation sous-jacent.
En fait, ces variables sont stockées et manipulées dans une structure
interne à Apache httpd. Elles ne deviennent de véritables variables
d'environnement du système d'exploitation que lorsqu'elles sont mises à la
disposition de scripts CGI et de scripts inclus côté serveur (SSI). Si vous
souhaitez manipuler l'environnement du système d'exploitation sous lequel
le serveur s'exécute, vous devez utiliser les mécanismes standards de
manipulation de l'environnement fournis par l'interpréteur de commandes
(shell) de votre système d'exploitation.</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif"> <a href="#setting">Définition des variables d'environnement</a></li>
<li><img alt="" src="./images/down.gif"> <a href="#using">Utilisation des variables d'environnement</a></li>
<li><img alt="" src="./images/down.gif"> <a href="#cgi">Variables d'environnement de CGI</a></li>
<li><img alt="" src="./images/down.gif"> <a href="#special">Variables d'environnement à usage spécial</a></li>
<li><img alt="" src="./images/down.gif"> <a href="#redirect-vars">Variables REDIRECT_</a></li>
<li><img alt="" src="./images/down.gif"> <a href="#examples">Exemples</a></li>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
<h2 id="setting">Définition des variables d'environnement <a title="Lien permanent" href="#setting" class="permalink">¶</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code></li><li><code class="module"><a href="./mod/mod_env.html">mod_env</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li><li><code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code></li><li><code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvifnocase">SetEnvIfNoCase</a></code></li><li><code class="directive"><a href="./mod/mod_env.html#unsetenv">UnsetEnv</a></code></li></ul></td></tr></table>
<h3 id="basic-manipulation">Manipulations de base de l'environnement</h3>
<p>La méthode la plus élémentaire pour définir une variable
d'environnement au niveau d'Apache httpd consiste à utiliser la directive
inconditionnelle <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code>. Les variables peuvent aussi être transmises depuis
l'environnement du shell à partir duquel le serveur a été démarré en
utilisant la directive
<code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code>.</p>
<h3 id="conditional">Définitions conditionnelles en fonction des requêtes</h3>
<p>Pour plus de souplesse, les directives fournies par le module
<code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code> permettent de définir les
variables d'environnement en tenant compte des caractéristiques
de chaque requête. Par exemple, une
variable pourrait n'être définie que lorsqu'un navigateur spécifique
(User-Agent) a généré la requête, ou seulement quand un en-tête
Referer particulier est présent. La directive
<code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> du module
<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> qui utilise l'option
<code>[E=...]</code> pour définir
les variables d'environnement apporte encore plus de souplesse.</p>
<h3 id="unique-identifiers">Identifiants uniques</h3>
<p>Finalement, le module <code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code> définit la variable
d'environnement <code>UNIQUE_ID</code> pour chaque requête à une valeur
qui est garantie unique parmi « toutes » les requêtes
sous des conditions très spécifiques.</p>
<h3 id="standard-cgi">Variables CGI standards</h3>
<p>En plus de l'ensemble des variables d'environnement internes à la
configuration d'Apache httpd et de celles transmises depuis le shell,
les scripts CGI et les pages SSI
se voient affectés un ensemble de variables
d'environnement contenant des méta-informations à propos de la requête
comme préconisé dans la spécification
sur les CGIs (<a href="https://www.rfc-editor.org/rfc/rfc3875">RFC 3875</a>).</p>
<h3 id="caveats">Quelques mises en garde</h3>
<ul>
<li>Les directives de manipulation de l'environnement ne permettent
pas de supplanter ou modifier les variables CGI standards.</li>
<li>Lorsqu'on utilise <code class="program"><a href="./programs/suexec.html">suexec</a></code> pour exécuter des
scripts CGI, l'environnement est nettoyé et réduit à un ensemble de
variables <em>sûres</em> avant l'exécution du script. La liste des
variables <em>sûres</em> est définie à la compilation dans
<code>suexec.c</code>.</li>
<li>Pour des raisons de portabilité, les noms des variables
d'environnement ne peuvent contenir que des lettres, des chiffres et
le caractère « souligné ». En outre, le premier caractère ne doit pas
être un chiffre. Les caractères qui ne satisfont pas à ces conditions
seront remplacés par un caractère « souligné » quand ils seront
transmis aux scripts CGI et aux pages SSI.</li>
<li>Les contenus d'en-têtes HTTP transmis aux scripts de type
CGI ou autre à l'aide de variables d'environnement constituent un
cas particulier (voir plus loin). Leur nom est converti en
majuscules et seuls les tirets sont remplacés par des
caractères '_' (« souligné ») ; si le format du nom de l'en-tête
n'est pas valide, celui-ci est ignoré. Voir <a href="#fixheader">plus loin</a> pour une solution de
contournement du problème.</li>
<li>La directive <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> s'exécute assez tard au
cours du traitement de la requête, ce qui signifie que des
directives telles que <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> et <code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> ne verront pas
les variables qu'elle aura définies.</li>
<li>Lorsque le serveur cherche un chemin via une <a class="glossarylink" href="./glossary.html#subrequest" title="voir glossaire">sous-requête</a> interne (par exemple la
recherche d'un <code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>), ou lorsqu'il génère un
listing du contenu d'un répertoire à l'aide du module
<code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code>, la sous-requête n'hérite pas des
variables d'environnement spécifiques à la requête. En outre, à cause
des phases de l'API auxquelles <code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code> prend
part, les directives <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> ne sont pas évaluées
séparément dans la sous-requête.</li>
</ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
<h2 id="using">Utilisation des variables d'environnement <a title="Lien permanent" href="#using" class="permalink">¶</a></h2>
<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_authz_core.html#require">Require</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="./mod/mod_access_compat.html#allow">Allow</a></code></li><li><code class="directive"><a href="./mod/mod_access_compat.html#deny">Deny</a></code></li><li><code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li></ul></td></tr></table>
<h3 id="cgi-scripts">Scripts CGI</h3>
<p>La communication d'informations aux scripts CGI constitue une des
principales utilisations des variables d'environnement. Comme indiqué
plus haut, l'environnement transmis aux scripts CGI comprend des
méta-informations standards à propos de la requête, en plus des
variables définies dans la configuration d'Apache httpd. Pour plus de
détails, se référer au
<a href="howto/cgi.html">tutoriel CGI</a>.</p>
<h3 id="ssi-pages">Pages SSI</h3>
<p>Les documents inclus côté serveur (SSI) traités par le filtre
<code>INCLUDES</code> du module <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>,
peuvent afficher les
variables d'environnement à l'aide de l'élément <code>echo</code>,
et peuvent utiliser des variables d'environnement dans les éléments
de contrôle de flux pour rendre certaines parties d'une page
conditionnelles en fonction des caractéristiques de la requête.
Apache httpd fournit aussi les variables d'environnement CGI standards
aux pages SSI
comme indiqué plus haut. Pour plus de détails, se référer au
<a href="howto/ssi.html">tutoriel SSI</a>.</p>
<h3 id="access-control">Contrôle d'accès</h3>
<p>L'accès au serveur peut être contrôlé en fonction de
variables d'environnement à l'aide des directives
<code>Require env</code> et <code>Require not env</code>.
En association avec la directive
<code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>, cela confère une
grande souplesse au contrôle d'accès au serveur en fonction des
caractéristiques du client. Par exemple, vous pouvez utiliser ces
directives pour interdire l'accès depuis un navigateur particulier
(User-Agent).
</p>
<h3 id="logging">Enregistrement conditionnel des traces</h3>
<p>Les variables d'environnement peuvent être enregistrées dans le
fichier de log des accès à l'aide de l'option <code>%e</code> de la
directive <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code>.
En outre, la décision de tracer ou non les requêtes peut être prise
en fonction de l'état de variables d'environnement en utilisant la
forme conditionnelle de la directive
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>. En
association avec la directive <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>, cela confère une grande souplesse au contrôle
du traçage des requêtes. Par exemple, vous pouvez choisir de ne pas
tracer les requêtes pour des noms de fichiers se terminant par
<code>gif</code>, ou encore de ne tracer que les requêtes des clients
n'appartenant pas à votre sous-réseau.</p>
<h3 id="response-headers">En-têtes de réponse conditionnels</h3>
<p>La directive <code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code>
peut se baser sur la présence ou l'absence d'une variable
d'environnement pour décider si un certain en-tête HTTP sera placé
dans la réponse au client. Cela permet, par exemple, de n'envoyer un
certain en-tête de réponse que si un en-tête correspondant est présent
dans la requête du client.</p>
<h3 id="external-filter">Activation de filtres externes</h3>
<p>Les filtres externes configurés par le module
<code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code> à l'aide de la directive <code class="directive"><a href="./mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code> peuvent être
activés de manière conditionnelle en fonction d'une variable
d'environnement à l'aide des options
<code>disableenv=</code> et <code>enableenv=</code>.</p>
<h3 id="url-rewriting">Réécriture d'URL</h3>
<p>La forme <code>%{ENV:<em>variable</em>}</code> de
<em>TestString</em> dans la
directive <code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
permet au moteur de réécriture du module
<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> de prendre des
décisions conditionnées par des variables d'environnement.
Notez que les variables accessibles dans
<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> sans le préfixe
<code>ENV:</code> ne sont pas de véritables variables
d'environnement. Ce sont plutôt des variables spécifiques à
<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>
qui ne sont pas accessibles pour les autres modules.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
<h2 id="cgi">Variables d'environnement de CGI <a title="Lien permanent" href="#cgi" class="permalink">¶</a></h2>
<p>La spécification sur les CGIs (<a href="https://www.rfc-editor.org/rfc/rfc3875#section-4.1">RFC 3875</a>) définit un
certain nombre de variables d'environnement qui s'ajoutent à celles définies
par la spécification de HTTP. Elles ont été plus largement adoptées et
constituent une méthode standard pour transmettre des informations entre le
navigateur et le serveur, et entre les processus au sein du serveur. Nous en
décrivons quelques unes ici ; consultez la spécification de CGI pour
plus de détails.</p>
<h3 id="query-string">QUERY_STRING</h3>
<p>La variable <code>QUERY_STRING</code> est définie avec tout ce
qui apparaît après un point d'interrogation à la fin de l'URL d'une
requête. Elle permet de transmettre des informations au serveur et peut
être divisée en paires clé/valeur. L'encodage de la chaîne doit être de
type URL.</p>
<div class="example"><p><code>
https://example.com/path/resource.php?key1=value1&key2=another%20value
</code></p></div>
<p>Dans cet exemple, la variable <code>QUERY_STRING</code> est définie
avec tout ce qui suit le point d'interrogation, et l'application
réceptrice (une application CGI ou un script PHP, par exemple) est
chargée d'en extraire les paires clé/valeur.</p>
<h3 id="path-info">PATH_INFO</h3>
<p>La variable <code>PATH_INFO</code> est définie avec toute valeur qui
apparaît après une ressource correspondante à la fin de l'URL,
<code>QUERY_STRING</code> non comprise. Tout paraît plus clair avec un
exemple :</p>
<div class="example"><p><code>
https://example.com/resource.php/additional/data?key1=value1
</code></p></div>
<p>Dans cet exemple, <code>PATH_INFO</code> est définie avec la chaîne
<code>/additional/data</code> et <code>QUERY_STRING</code> avec la
chaîne <code>key1=value1</code>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
<h2 id="special">Variables d'environnement à usage spécial <a title="Lien permanent" href="#special" class="permalink">¶</a></h2>
<p>Des problèmes d'interopérabilité ont conduit à l'introduction de
mécanismes permettant de modifier le comportement d'Apache httpd lorsqu'il
dialogue avec certains clients. Afin de rendre ces mécanismes aussi
souples que possible, ils sont invoqués en définissant des variables
d'environnement, en général à l'aide de la directive
<code class="directive"><a href="./mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code>, bien que les
directives <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code> et
<code class="directive"><a href="./mod/mod_env.html#passenv">PassEnv</a></code> puissent aussi être
utilisées, par exemple.</p>
<h3 id="downgrade">downgrade-1.0</h3>
<p>Cela force le traitement d'une requête comme une requête HTTP/1.0
même si elle a été rédigée dans un langage plus récent.</p>
<h3 id="force-gzip">force-gzip</h3>
<p>Si le filtre <code>DEFLATE</code> est activé, cette variable
d'environnement ignorera les réglages accept-encoding de votre
navigateur et enverra une sortie compressée inconditionnellement.</p>
<h3 id="force-no-vary">force-no-vary</h3>
<p>Cette variable entraîne la suppression de tout champ
<code>Vary</code> des en-têtes de la réponse avant que cette dernière
soit renvoyée au client. Certains clients n'interprètent pas ce champ
correctement, et la définition de cette variable permet de contourner
ce problème, mais implique aussi la définition de
<strong>force-response-1.0</strong>.</p>
<h3 id="force-response">force-response-1.0</h3>
<p>Cette variable force une réponse en langage HTTP/1.0 aux clients
qui envoient des requêtes dans le même langage. Elle fut implémentée à
l'origine suite à des problèmes avec les mandataires d'AOL. Certains
clients en langage HTTP/1.0 ne réagissent pas correctement face à une
réponse en langage HTTP/1.1, et cette variable peut être utilisée pour
assurer l'interopérabilité avec eux.</p>
<h3 id="gzip-only-text-html">gzip-only-text/html</h3>
<p>Positionnée à « 1 », cette variable désactive le filtre en sortie
<code>DEFLATE</code> fourni par le module <code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> pour les
types de contenu autres que <code>text/html</code>. Si vous préférez
utiliser des fichiers compressés statiquement,
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> évalue aussi la variable (non
seulement pour gzip, mais aussi pour tous les encodages autres que
« identity »).</p>
<h3 id="no-gzip">no-gzip</h3>
<p>Quand cette variable est définie, le filtre <code>DEFLATE</code> du
module <code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> est désactivé, et
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> refusera de délivrer des ressources
encodées.</p>
<h3 id="no-cache">no-cache</h3>
<p><em>Disponible dans les versions 2.2.12 et ultérieures d'Apache httpd</em></p>
<p>Lorsque cette variable est définie,
<code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> ne sauvegardera pas de réponse
susceptible d'être mise en cache. Cette variable d'environnement
n'a aucune incidence sur le fait qu'une réponse déjà enregistrée
dans le cache soit utilisée ou non pour la requête courante.</p>
<h3 id="nokeepalive">nokeepalive</h3>
<p>Quand cette variable est définie, la directive
<code class="directive"><a href="./mod/core.html#keepalive">KeepAlive</a></code> est désactivée.</p>
<h3 id="prefer-language">prefer-language</h3>
<p>Cette variable modifie le comportement du module
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>. Si elle contient un symbole de
langage (tel que <code>en</code>, <code>ja</code>
ou <code>x-klingon</code>), <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> essaie de
délivrer une variante dans ce langage. S'il n'existe pas de telle
variante, le processus normal de
<a href="content-negotiation.html">négociation</a> s'applique.</p>
<h3 id="redirect-carefully">redirect-carefully</h3>
<p>Cette variable force le serveur à être plus prudent lors de l'envoi
d'une redirection au client. Elle est en général utilisée quand un
client présente un problème connu avec les redirections. Elle fut
implémentée à l'origine suite a un problème rencontré avec le logiciel
WebFolders de Microsoft qui ne gère pas correctement les redirections
vers des ressources de type répertoire via des méthodes DAV.</p>
<h3 id="suppress-error-charset">suppress-error-charset</h3>
<p><em>Disponible dans les versions postérieures à 2.0.54</em></p>
<p>Quand Apache httpd génère une redirection en réponse à une requête client,
la réponse inclut un texte destiné à être affiché au cas où le client ne
suivrait pas, ou ne pourrait pas suivre automatiquement la redirection.
Habituellement, Apache httpd marque ce texte en accord avec le jeu de caractères
qu'il utilise, à savoir ISO-8859-1.</p>
<p> Cependant, si la redirection fait référence à une page qui utilise un
jeu de caractères différent, certaines versions de navigateurs obsolètes
essaieront d'utiliser le jeu de caractères du texte de la redirection
plutôt que celui de la page réelle.
Cela peut entraîner, par exemple, un rendu incorrect du Grec.</p>
<p>Si cette variable d'environnement est définie, Apache httpd omettra le jeu de
caractères pour le texte de la redirection, et les navigateurs obsolètes
précités utiliseront correctement celui de la page de destination.</p>
<div class="warning">
<h3>Note concernant la sécurité</h3>
<p>L'envoi de pages d'erreur sans spécifier un jeu de caractères peut
conduire à des attaques de type « cross-site-scripting" pour les
navigateurs qui ne respectent pas la spécification HTTP/1.1 (MSIE) et
tentent de déduire le jeu de caractères à partir du contenu. De tels
navigateurs peuvent être facilement trompés et utiliser le jeu de
caractères UTF-7 ; les contenus des données en entrée de type UTF-7
(comme les URI de requête) ne seront alors plus protégés par les
mécanismes d'échappement usuels conçus pour prévenir les attaques
de type « cross-site-scripting".</p>
</div>
<h3 id="proxy">force-proxy-request-1.0, proxy-nokeepalive, proxy-sendchunked,
proxy-sendcl, proxy-chain-auth, proxy-interim-response, proxy-initial-not-pooled</h3>
<p>Ces directives modifient le comportement protocolaire du module
<code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>. Voir la documentation sur
<code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> et <code class="module"><a href="./mod/mod_proxy_http.html">mod_proxy_http</a></code> pour plus de détails.</p>
<h3 id="cgilike">ap_trust_cgilike_cl</h3>
<p><em>Disponible à partir de la version 2.4.59 du serveur HTTP Apache</em></p>
<p>Cette variable permet à un script qui s'exécute dans un module de type CGI
de fournir son propre en-tête de réponse HTTP Content-Length. Elle ne doit
être définie que dans les sections de configuration qui contiennent des
scripts de confiance.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
<h2 id="redirect-vars">Variables REDIRECT_ <a title="Lien permanent" href="#redirect-vars" class="permalink">¶</a></h2>
<p>Lorsqu'une redirection interne se produit — provoquée par une directive
<code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>, par
<code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>, par une directive <code class="directive"><a href="./mod/mod_dir.html#fallbackresource">FallbackResource</a></code> ou par tout autre mécanisme de
redirection interne — les variables d'environnement de la requête originelle
sont transmises à la cible de la redirection avec le préfixe
<code>REDIRECT_</code>.</p>
<p>Deux variables supplémentaires sont toujours définies :</p>
<dl>
<dt><code>REDIRECT_URL</code></dt>
<dd>Le chemin URL de la requête originelle avant la redirection interne.
Cette variable n'est pas définie par un quelconque module spécifique, mais
par le cœur du serveur.</dd>
<dt><code>REDIRECT_STATUS</code></dt>
<dd>Le code d'état HTTP qui a déclenché la redirection. Pour les
documents d'erreur, il s'agit du code d'état d'erreur (par exemple 404).
Pour les redirections internes de <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> ou de la
directive <code class="directive"><a href="./mod/mod_dir.html#fallbackresource">FallbackResource</a></code>, il
s'agit en général du code d'état 200.</dd>
</dl>
<p>Par exemple, si la valeur de <code>REQUEST_URI</code> était
<code>/original/chemin</code> et qu'une redirection interne envoyait la
requête à <code>/handler.php</code>, la cible de la redirection verrait
<code>REDIRECT_URL=/original/path</code> et
<code>REQUEST_URI=/handler.php</code>.</p>
<p>Ces variables sont disponibles pour les scripts CGI, les pages SSI et
dans les <a href="expr.html">expressions</a>. Pour plus d'informations à
propos des variables REDIRECT_ dans le contexte des documents d'erreur, voir
<a href="custom-error.html">Réponses aux erreurs personnalisées</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
<h2 id="examples">Exemples <a title="Lien permanent" href="#examples" class="permalink">¶</a></h2>
<h3 id="fixheader">Transmission du contenu d'en-têtes non valides aux scripts
CGI</h3>
<p>Avec la version 2.4, Apache httpd est plus strict avec la conversion
des en-têtes HTTP en variables d'environnement dans
<code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code> et d'autres modules : dans les versions
précédentes, tout caractère non valable dans les noms d'en-têtes
était tout simplement remplacé par un caractère '_', ce qui
pouvait exposer à des attaques de type cross-site-scripting via
injection d'en-têtes.</p>
<p>Si vous devez prendre en charge un client qui envoie des en-têtes non
conformes et si ceux-ci ne peuvent pas être corrigés, il existe
une solution de contournement simple mettant en jeu les modules
<code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code> et <code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code>,
et permettant de prendre en compte ces en-têtes :</p>
<pre class="prettyprint lang-config"># L'exemple suivant montre comment prendre en compte un en-tête<br>
# Accept_Encoding non conforme envoyé par un client.
#
SetEnvIfNoCase ^Accept.Encoding$ ^(.*)$ fix_accept_encoding=$1
RequestHeader set Accept-Encoding %{fix_accept_encoding}e env=fix_accept_encoding</pre>
<h3 id="misbehaving">Modification du comportement protocolaire face à des clients
réagissant de manière non conforme</h3>
<p>Les versions antérieures recommandaient l'ajout de ces lignes dans
httpd.conf pour tenir compte de problèmes connus avec certains clients.
Comme les clients concernés sont maintenant très peu utilisés, cet
ajout n'est pratiquement plus nécessaire.</p>
<pre class="prettyprint lang-config">#
# The following directives modify normal HTTP response behavior.
# The first directive disables keepalive for Netscape 2.x and browsers that
# spoof it. There are known problems with these browser implementations.
# The second directive is for Microsoft Internet Explorer 4.0b2
# which has a broken HTTP/1.1 implementation and does not properly
# support keepalive when it is used on 301 or 302 (redirect) responses.
#
BrowserMatch "Mozilla/2" nokeepalive
BrowserMatch "MSIE 4\.0b2;" nokeepalive downgrade-1.0 force-response-1.0
#
# The following directive disables HTTP/1.1 responses to browsers which
# are in violation of the HTTP/1.0 spec by not being able to grok a
# basic 1.1 response.
#
BrowserMatch "RealPlayer 4\.0" force-response-1.0
BrowserMatch "Java/1\.0" force-response-1.0
BrowserMatch "JDK/1\.0" force-response-1.0</pre>
<h3 id="no-img-log">Ne pas tracer les requêtes pour des images dans le fichier de
trace des accès</h3>
<p>Dans cet exemple, les requêtes pour des images n'apparaissent pas
dans le fichier de trace des accès. Il peut être facilement adapté pour
empêcher le traçage de répertoires particuliers, ou de requêtes
en provenance de certains hôtes.</p>
<pre class="prettyprint lang-config">SetEnvIf Request_URI \.gif image-request
SetEnvIf Request_URI \.jpg image-request
SetEnvIf Request_URI \.png image-request
CustomLog "logs/access_log" common env=!image-request</pre>
<h3 id="image-theft">Prévention du « Vol d'image »</h3>
<p>Cet exemple montre comment empêcher les utilisateurs ne faisant pas
partie de votre serveur d'utiliser des images de votre serveur comme
images en ligne dans leurs pages. Cette configuration n'est pas
recommandée, mais elle peut fonctionner dans des circonstances bien
définies. Nous supposons que toutes vos images sont enregistrées dans
un répertoire nommé <code>/web/images</code>.</p>
<pre class="prettyprint lang-config">SetEnvIf Referer "^http://www\.example\.com/" local_referal
# Autorise les navigateurs qui n'envoient aucune information de Referer
SetEnvIf Referer "^$" local_referal
<Directory "/web/images">
Require env local_referal
</Directory></pre>
<p>Pour plus d'informations sur cette technique, voir le tutoriel sur
ServerWatch
"<a href="https://www.serverwatch.com/guides/keeping-your-images-from-adorning-other-sites/">Keeping Your Images from Adorning Other Sites</a>".</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/env.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/env.html" title="Français"> fr </a> |
<a href="./ja/env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/env.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Autorisé sous <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Signaler un bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
var langToggle = document.querySelector('.lang-toggle');
var topLang = document.querySelector('.toplang');
if (langToggle && topLang) {
langToggle.addEventListener('click', function() { topLang.classList.toggle('open'); });
}
var qv = document.getElementById('quickview');
if (qv) {
document.body.appendChild(qv);
var qvBtn = document.createElement('button');
qvBtn.className = 'qv-toggle';
qvBtn.setAttribute('aria-label', 'Toggle page navigation');
qvBtn.innerHTML = '☰';
document.body.appendChild(qvBtn);
qvBtn.addEventListener('click', function() {
var isOpen = qv.classList.toggle('open');
if (isOpen) {
qv.style.top = window.scrollY + 10 + 'px';
}
});
window.addEventListener('scroll', function() { qv.classList.remove('open'); });
}
//--><!]]></script>
</body></html>