blob: fe5878416049471dab6cae17b1b565048c19684a [file]
<!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>mod_proxy_fcgi - Serveur HTTP Apache Version 2.5</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>
<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.5</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> &gt; <a href="https://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="https://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Module Apache mod_proxy_fcgi</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/mod/mod_proxy_fcgi.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_proxy_fcgi.html" title="Fran&ccedil;ais">&nbsp;fr&nbsp;</a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module fournissant le support de FastCGI &agrave;
<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></td></tr>
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur&nbsp;de&nbsp;Module:</a></th><td>proxy_fcgi_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Fichier&nbsp;Source:</a></th><td>mod_proxy_fcgi.c</td></tr>
<tr><th><a href="module-dict.html#Compatibility">Compatibilit&eacute;:</a></th><td>Disponible depuis la version 2.3 d'Apache</td></tr></table>
<h3>Sommaire</h3>
<p>Pour fonctionner, ce module <em>n&eacute;cessite</em> le chargement de
<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. Il fournit le support du protocole <a href="https://fastcgi-archives.github.io/">FastCGI</a>.</p>
<p>Ainsi, pour pouvoir traiter le protocole <code>FastCGI</code>,
<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> et <code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code>
doivent &ecirc;tre charg&eacute;s dans le serveur.</p>
<p>A la diff&eacute;rence de <a href="http://httpd.apache.org/mod_fcgid/">mod_fcgid</a>,
<code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code> n'est pas en mesure de d&eacute;marrer le
processus de l'application ; <code class="program"><a href="../programs/fcgistarter.html">fcgistarter</a></code> est
fourni &agrave; cet effet sur certaines plateformes. Le framework
applicatif FastCGI utilis&eacute; peut aussi fournir la gestion des
processus ou des lancements de programmes externes.</p>
<div class="warning"><h3>Avertissement</h3>
<p>N'activez pas la fonctionnalit&eacute; de mandataire avant d'avoir <a href="mod_proxy.html#access">s&eacute;curis&eacute; votre serveur</a>. Les
serveurs mandataires ouverts sont dangereux non seulement pour
votre r&eacute;seau, mais aussi pour l'Internet au sens large.</p>
</div>
</div>
<div id="quickview"><h3>Sujets</h3>
<ul id="topics">
<li><img alt="" src="../images/down.gif"> <a href="#examples">Exemples</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#env">Variables d'environnement</a></li>
</ul><h3 class="directives">Directives</h3>
<ul id="toc">
<li><img alt="" src="../images/down.gif"> <a href="#proxyfcgibackendtype">ProxyFCGIBackendType</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#proxyfcgisetenvif">ProxyFCGISetEnvIf</a></li>
</ul>
<h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&amp;list_id=144532&amp;product=Apache%20httpd-2&amp;query_format=specific&amp;order=changeddate%20DESC%2Cpriority%2Cbug_severity&amp;component=mod_proxy_fcgi">Probl&egrave;mes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&amp;component=mod_proxy_fcgi">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
<ul class="seealso">
<li><code class="program"><a href="../programs/fcgistarter.html">fcgistarter</a></code></li>
<li><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></li>
<li><code class="module"><a href="../mod/mod_authnz_fcgi.html">mod_authnz_fcgi</a></code></li>
</ul></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">&para;</a></h2>
<p>Pour que ces exemples fonctionnent, vous ne devez pas oublier
d'activer <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> et
<code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code>.</p>
<div class="example"><h3>Instance d'application unique</h3><pre class="prettyprint lang-config">ProxyPass "/mon_appli/" "fcgi://localhost:4000/"</pre>
</div>
<p><code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code> interdisant par d&eacute;faut la
r&eacute;utilisation des connexions, lorsqu'une requ&ecirc;te a &eacute;t&eacute; trait&eacute;e, la
connexion ne sera pas maintenue ouverte par le processus enfant
httpd, et ne sera donc pas r&eacute;utilis&eacute;e. Cependant, si l'application
FastCGI supporte les connexions httpd simultan&eacute;es, vous pouvez opter
pour la r&eacute;utilisation des connexions comme dans l'exemple suivant :</p>
<div class="example"><h3>Instance d'application unique, r&eacute;utilisation
des connexions (versions 2.4.11 et sup&eacute;rieures)</h3><pre class="prettyprint lang-config">ProxyPass "/myapp/" "fcgi://localhost:4000/" enablereuse=on</pre>
</div>
<div class="note"><h3>Active la r&eacute;utilisation des connexions vers un serveur FCGI
d'arri&egrave;re-plan tel que PHP-FPM</h3>
<p>Il faut garder &agrave; l'esprit que PHP-FPM (en f&eacute;vrier 2018) utilise un mod&egrave;le
du style prefork ; autrement dit, chacun de ses processus de travail ne peut
g&eacute;rer qu'une connexion &agrave; la fois.<br> Par d&eacute;faut, lorsqu'il est configur&eacute;
avec <code>enablereuse=on</code> et lorsqu'un MPM &agrave; base de threads est
utilis&eacute; (comme <code class="module"><a href="../mod/worker.html">worker</a></code> ou <code class="module"><a href="../mod/event.html">event</a></code>), mod_proxy
autorise un jeu de <code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code> connexions vers le serveur
d'arri&egrave;re-plan pour chaque processus httpd, et par cons&eacute;quent, il faut
pr&ecirc;ter une attention particuli&egrave;re aux situations suivantes :</p>
<ul>
<li>Avec une charge en HTTP/1, il est fort probable que le nombre de
connexions vers le serveur FCGI d'arri&egrave;re-plan augmente jusqu'&agrave; atteindre
<code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code>.</li>
<li>Avec une charge en HTTP/2, et vue la mani&egrave;re dont
<code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> est impl&eacute;ment&eacute;, il y a des threads de travail
h2 additionnels qui peuvent forcer la cr&eacute;ation de connexions
suppl&eacute;mentaires vers le serveur d'arri&egrave;re-plan. Le nombre total de
connexions que contiennent les jeux de connexions peut alors d&eacute;passer
<code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code>.</li>
</ul>
<p>Le nombre maximum de processus de travail PHP-FPM doit &ecirc;tre d&eacute;fini
judicieusement car il est possible qu'ils finissent par rester dans l'&eacute;tat
occup&eacute; ("busy") pour ne g&eacute;rer que des connexions persistantes inactives,
sans avoir la possibilit&eacute; d'en &eacute;tablir de nouvelles ; ce qui se traduira
pour l'utilisateur final par une pile de "HTTP request timeouts".</p>
</div>
<p>Dans l'exemple suivant, l'URI de la requ&ecirc;te est transmis en tant
que chemin du syst&egrave;me de fichiers pour l'ex&eacute;cution du d&eacute;mon PHP-FPM.
L'URL de la requ&ecirc;te est implicitement ajout&eacute;e au second param&egrave;tre.
PHP-FPM est &agrave; l'&eacute;coute de l'h&ocirc;te et du port qui
suivent fcgi://. La conservation/r&eacute;utilisation des connexions est activ&eacute;e.</p>
<div class="example"><h3>PHP-FPM</h3><pre class="prettyprint lang-config">ProxyPassMatch "^/myapp/.*\.php(/.*)?$" "fcgi://localhost:9000/var/www/" enablereuse=on</pre>
</div>
<p>Dans l'exemple suivant, l'URI de la requ&ecirc;te est transmis en tant
que chemin du syst&egrave;me de fichiers pour l'ex&eacute;cution du d&eacute;mon PHP-FPM.
Dans ce cas cependant, PHP-FPM est &agrave; l'&eacute;coute d'un socket de domaine
unix (UDS). Cette fonctionnalit&eacute; est disponible &agrave; partir de la
version 2.4.9. Avec cette syntaxe, si un nom d'h&ocirc;te et un port sont
ajout&eacute;s apr&egrave;s fcgi://, ils seront ignor&eacute;s.</p>
<div class="example"><h3>PHP-FPM with UDS</h3><pre class="prettyprint lang-config">ProxyPassMatch "^/(.*\.php(/.*)?)$" "unix:/var/run/php5-fpm.sock|fcgi://localhost/var/www/"</pre>
</div>
<p>Dans l'exemple suivant, on force le module &agrave; traiter les paquets de
donn&eacute;es en provenance du serveur FCGI d'arri&egrave;re-plan d&egrave;s leur r&eacute;ception, sans les
faire transiter par un tampon.
</p>
<div class="example"><h3>Force le traitement des donn&eacute;es FCGI sans mise en tampon</h3><pre class="prettyprint lang-config">ProxyPassMatch "^/myapp/.*\.php(/.*)?$" "fcgi://localhost:9000/var/www/" enablereuse=on flushpackets=on</pre>
</div>
<p>L'exemple suivant est similaire au pr&eacute;c&eacute;dent avec une diff&eacute;rence : ici,
les donn&eacute;es en provenance du serveur FCGI d'arri&egrave;re-plan sont trait&eacute;es apr&egrave;s un
temps de valeur fixe (elles sont mises en tampon). Cette m&eacute;thode est
utile si le serveur FCGI d'arri&egrave;re-plan envoie ses donn&eacute;es sous forme
de petits paquets, auquel cas le traitement imm&eacute;diat de chacun d'entre eux
serait inefficace et couteux en ressources. Notez que cet exemple ne sera
peut-&ecirc;tre pas adapt&eacute; dans le cas o&ugrave; l'envoi de paquets de donn&eacute;es par
l'application FCGI est bloqu&eacute; par l'attente de donn&eacute;es en provenance du
client.
</p>
<div class="example"><h3>Force le traitement des donn&eacute;es FCGI apr&egrave;s une mise en
tampon de 20ms</h3><pre class="prettyprint lang-config">ProxyPassMatch "^/myapp/.*\.php(/.*)?$" "fcgi://localhost:9000/var/www/" flushpackets=on flushwait=20</pre>
</div>
<p>La passerelle &agrave; r&eacute;partition de charge n&eacute;cessite le chargement du
module <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> et d'au moins un module
fournissant un algorithme de r&eacute;partition de charge, comme
<code class="module"><a href="../mod/mod_lbmethod_byrequests.html">mod_lbmethod_byrequests</a></code> en plus des modules
d&eacute;j&agrave; cit&eacute;s. <code class="module"><a href="../mod/mod_lbmethod_byrequests.html">mod_lbmethod_byrequests</a></code> est le module
par d&eacute;faut et sera utilis&eacute; dans cet exemple de configuration.</p>
<div class="example"><h3>Passerelle &agrave; r&eacute;partition de charge vers plusieurs
instances de l'application</h3><pre class="prettyprint lang-config">ProxyPass "/myapp/" "balancer://myappcluster/"
&lt;Proxy "balancer://myappcluster/"&gt;
BalancerMember "fcgi://localhost:4000"
BalancerMember "fcgi://localhost:4001"
&lt;/Proxy&gt;</pre>
</div>
<p>Vous pouvez aussi forcer le traitement d'une requ&ecirc;te en tant que requ&ecirc;te
de mandataire inverse en cr&eacute;ant un court-circuiteur de gestionnaire
appropri&eacute;. Dans l'exemple ci-dessous, toutes les requ&ecirc;tes pour des scripts
PHP seront transmises au serveur FastCGI sp&eacute;cifi&eacute; par mandat inverse. Cette
fonctionnalit&eacute; est disponible &agrave; partir de la version 2.4.10 du serveur HTTP
Apache. Pour des raisons de performances, il est recommand&eacute; de d&eacute;finir un <a href="mod_proxy.html#workers">worker (configuration d'un mandataire)</a>
repr&eacute;sentant le m&ecirc;me serveur fcgi:// d'arri&egrave;re-plan. Avec cette
configuration, il est possible d'effectuer une correspondance directe entre
l'URI et le chemin du fichier sur le serveur, et le chemin local du fichier
sera alors transmis au serveur d'arri&egrave;re-plan. Lorsque FastCGI est configur&eacute;
ainsi, le serveur est en mesure de calculer le <a class="glossarylink" href="../glossary.html#pathinfo" title="voir glossaire">PATH_INFO</a> le plus appropri&eacute;.
</p>
<div class="example"><h3>Mandataire via un gestionnaire</h3><pre class="prettyprint lang-config">&lt;FilesMatch "\.php$"&gt;
# Note : la seule partie variable est /path/to/app.sock
SetHandler "proxy:unix:/path/to/app.sock|fcgi://localhost/"
&lt;/FilesMatch&gt;
# D&eacute;finition d'une configuration de mandataire qui convient.
# La partie qui est mise en correspondance avec la valeur de
# SetHandler est la partie qui suit le "pipe". Si vous devez faire
# une distinction, "localhost" peut &ecirc;tre chang&eacute; en un nom de serveur
# unique.
&lt;Proxy "fcgi://localhost/" enablereuse=on max=10&gt;
&lt;/Proxy&gt;
&lt;FilesMatch ...&gt;
SetHandler "proxy:fcgi://localhost:9000"
&lt;/FilesMatch&gt;
&lt;FilesMatch ...&gt;
SetHandler "proxy:balancer://myappcluster/"
&lt;/FilesMatch&gt;</pre>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="env">Variables d'environnement <a title="Lien permanent" href="#env" class="permalink">&para;</a></h2>
<p>En plus des directives de configuration qui contr&ocirc;lent le
comportement de <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, de nombreuses
<dfn>variables d'environnement</dfn> permettent de piloter le
fournisseur du protocole FCGI :</p>
<dl>
<dt>proxy-fcgi-pathinfo</dt>
<dd>Lorsqu'il est configur&eacute; via les directives <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code> ou <code class="directive"><a href="../mod/mod_proxy.html#proxypassmatch">ProxyPassMatch</a></code>,
<code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code> ne d&eacute;finit pas la variable
d'environnement <var>PATH_INFO</var>,
ce qui permet au serveur FCGI d'arri&egrave;re-plan de d&eacute;terminer
correctement <var>SCRIPT_NAME</var> et <var>Script-URI</var>, et
de se conformer &agrave; la section 3.3 de la RFC 3875. Si au contraire
vous avez souhaitez que <code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code> g&eacute;n&egrave;re une
"estimation la plus exacte possible" de <var>PATH_INFO</var>,
d&eacute;finissez la variable d'environnement
<var>proxy-fcgi-pathinfo</var>. Ceci peut servir de
contournement pour une bogue pr&eacute;sente dans certaines
impl&eacute;mentations de FCGI. Cette variable peut &ecirc;tre
multivalu&eacute;e afin de pouvoir choisir la valeur la plus appropri&eacute;e
(versions 2.4.11 et sup&eacute;rieures) :
<dl>
<dt>first-dot</dt>
<dd>PATH_INFO est extrait &agrave; partir du slash qui suit le
<em>premier</em> "." de l'URL.</dd>
<dt>last-dot</dt>
<dd>PATH_INFO est extrait &agrave; partir du slash qui suit le
<em>dernier</em> "." de l'URL.</dd>
<dt>full</dt>
<dd>PATH_INFO est calcul&eacute; en supposant que l'URL correspond au
chemin du syst&egrave;me de fichiers.</dd>
<dt>unescape</dt>
<dd>PATH_INFO correspond &agrave; la partie chemin de l'URL avec ses
s&eacute;quences d'&eacute;chappement d&eacute;cod&eacute;es.</dd>
<dt>toute autre valeur</dt>
<dd>PATH_INFO correspond &agrave; la partie chemin de l'URL.
Auparavant, c'&eacute;tait la seule option pour proxy-fcgi-pathinfo.</dd>
</dl>
</dd>
</dl>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="proxyfcgibackendtype">Directive <span id="ProxyFCGIBackendType">ProxyFCGIBackendType</span> <a title="Lien permanent" href="#proxyfcgibackendtype" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sp&eacute;cifie le type de l'application FastCGI d'arri&egrave;re-plan</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFCGIBackendType FPM|GENERIC</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D&eacute;faut:</a></th><td><code>ProxyFCGIBackendType FPM</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, r&eacute;pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Surcharges autoris&eacute;es:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_fcgi</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit&eacute;:</a></th><td>Disponible &agrave; partir de la version 2.4.26 du serveur HTTP Apache</td></tr>
</table>
<p>Cette directive permet de sp&eacute;cifier le type de l'application FastCGI
d'arri&egrave;re-plan. Certains serveurs FastCGI, comme PHP-FPM, utilisent de mani&egrave;re
historique des variables d'environnement exotiques pour identifier le type du
serveur mandataire utilis&eacute;. D&eacute;finissez cette directive &agrave; "GENERIC" si votre
application n'est pas de type PHP-FPM et n'interpr&eacute;ter pas correctement des
variables d'environnement comme SCRIPT_FILENAME ou PATH_TRANSLATED telles
qu'elles sont d&eacute;finies par le serveur.</p>
<p>SCRIPT_FILENAME est un exemple de valeur modifi&eacute;e par la d&eacute;finition de cette
directive. Historiquement, lorsqu'on utilisait le module
<code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code>, SCRIPT_FILENAME &eacute;tait pr&eacute;fix&eacute; par la cha&icirc;ne
"proxy:fcgi://". C'est cette variable que lisent certaines applications FastCGI
g&eacute;n&eacute;riques en tant que valeur en entr&eacute;e pour leur script ; cependant, PHP-FPM
peut supprimer le pr&eacute;fixe, puis garder en m&eacute;moire qu'il communique avec Apache.
Avec les versions 2.4.21 &agrave; 2.4.25, ce pr&eacute;fixe &eacute;tait automatiquement supprim&eacute; par
le serveur, emp&ecirc;chant ainsi PHP-FPM de d&eacute;tecter et interop&eacute;rer avec Apache dans
certains sc&eacute;narios.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="proxyfcgisetenvif">Directive <span id="ProxyFCGISetEnvIf">ProxyFCGISetEnvIf</span> <a title="Lien permanent" href="#proxyfcgisetenvif" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet d'adapter la valeur des variables envoy&eacute;es aux serveurs
FastCGI</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFCGISetEnvIf <var>conditional-expression</var>
[!]<var>environment-variable-name</var>
[<var>value-expression</var>]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, r&eacute;pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Surcharges autoris&eacute;es:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_fcgi</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit&eacute;:</a></th><td>Disponible &agrave; partir de la version 2.4.26 du serveur HTTP Apache.</td></tr>
</table>
<p>Juste avant la transmission d'une requ&ecirc;te au serveur FastCGI configur&eacute;, le
coeur du programme du serveur web d&eacute;finit un certain nombre de variables
d'environnement en fonction de certains d&eacute;tails de la requ&ecirc;te consid&eacute;r&eacute;e. Les
programmes FastCGI utilisent souvent ces variables comme donn&eacute;es en entr&eacute;e afin
de d&eacute;terminer quels scripts sous-jacents ils vont ex&eacute;cuter, ou quelles donn&eacute;es
en sortie doivent &ecirc;tre produites.</p>
<p>Voici quelques exemples de variables d'environnement importantes :</p>
<ul>
<li>SCRIPT_NAME</li>
<li>SCRIPT_FILENAME</li>
<li>REQUEST_URI</li>
<li>PATH_INFO</li>
<li>PATH_TRANSLATED</li>
</ul>
<p>Cette directive permet de passer outre les variables d'environnement
ci-dessus, entre autres. Elle est &eacute;valu&eacute;e apr&egrave;s la d&eacute;finition de la valeur
initiale de ces variables ; elle peuvent donc &ecirc;tre utilis&eacute;es comme entr&eacute;es dans
les expressions d&eacute;finissants les conditions et les valeurs.</p>
<p>Syntaxe des param&egrave;tres :</p>
<dl>
<dt>conditional-expression</dt>
<dd>D&eacute;finit une condition en fonction de laquelle la
variable d'environnement qui suit sera modifi&eacute;e ou non. Pour la syntaxe de cette
expression, reportez-vous aux exemples qui suivent ou &agrave; la sp&eacute;cification
d&eacute;taill&eacute;e dans le document <a href="../expr.html">ap_expr</a>.
</dd>
<dt>environment-variable-name</dt>
<dd>Sp&eacute;cifie le nom de la variable d'environnement &agrave; modifier, par exemple
PATH_INFO. Si elle est pr&eacute;c&eacute;d&eacute;e d'un point d'exclamation, la d&eacute;finition de la
variable sera annul&eacute;e.</dd>
<dt>value-expression</dt>
<dd>Sp&eacute;cifie la nouvelle valeur de la variable "environment-variable-name". On
peut inclure des
r&eacute;f&eacute;rences arri&egrave;res, comme "$1", issues de captures en provenance de
l'expression rationnelle <var>conditional-expression</var>. Si cette valeur est
omise, la variable est d&eacute;finie (ou sa valeur est &eacute;cras&eacute;e) par une cha&icirc;ne vide
&mdash; voir cependant la note ci-apr&egrave;s.</dd>
</dl>
<div class="example"><pre class="prettyprint lang-config"># Une modification basique, inconditionnelle
ProxyFCGISetEnvIf "true" PATH_INFO "/example"
# Utilisation d'une variable d'environnement pour sp&eacute;cifier la nouvelle valeur
ProxyFCGISetEnvIf "true" PATH_INFO "%{reqenv:SCRIPT_NAME}"
<br>
# Utilisation de captures dans la condition et de r&eacute;f&eacute;rences arri&egrave;res dans la
# nouvelle valeur
ProxyFCGISetEnvIf "reqenv('PATH_TRANSLATED') =~ m#(/.*prefix)(\d+)(.*)#" PATH_TRANSLATED "$1$3"</pre>
</div>
<div class="note"><h3>Note : Annulation d&eacute;finition ou valeur vide</h3>
La ligne suivante annule la d&eacute;finition de la variable <code>VARIABLE</code>,
ce qui l'emp&ecirc;che d'&ecirc;tre envoy&eacute;e au serveur FastCGI :
<pre class="prettyprint lang-config">ProxyFCGISetEnvIf true !VARIABLE</pre>
La ligne suivante, quant &agrave; elle, efface la <em>valeur</em> de la variable
<code>VARIABLE</code> en lui affectant la cha&icirc;ne vide ; cette variable
<code>VARIABLE</code> sera alors tout de m&ecirc;me envoy&eacute;e au serveur FastCGI :
<pre class="prettyprint lang-config">ProxyFCGISetEnvIf true VARIABLE</pre>
La sp&eacute;cification CGI/1.1 ne fait pas de
distinction (<a href="https://www.rfc-editor.org/rfc/rfc3875#section-4.1">RFC 3875</a>) entre une variable contenant une cha&icirc;ne vide et une variable qui
n'existe pas. De nombreuses impl&eacute;mentations CGI et FastCGI font cependant
cette distinction (ou permettent aux scripts de la faire). Le choix de celle
que vous allez utiliser d&eacute;pend de votre impl&eacute;mentation et de la raison qui
vous pousse &agrave; modifier cette variable.
</div>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_fcgi.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_proxy_fcgi.html" title="Fran&ccedil;ais">&nbsp;fr&nbsp;</a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Autoris&eacute; 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 = '&#9776;';
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>