www/apache
1
0
Fork 0
mirror of https://github.com/apache/httpd.git synced 2025-11-02 06:53:27 +03:00
Code Activity
Files
c98d42a659d9ca25fe81668c51a7a312ddafcc8d
apache/docs/manual/mod/mod_proxy_fcgi.html.fr
Lucien Gentis 397a87ddb0 Rebuild. 
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1809438 13f79535-47bb-0310-9956-ffa450edef68
2017-09-23 16:12:14 +00:00

375 lines
24 KiB
Plaintext
Raw Blame History

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_proxy_fcgi - Serveur Apache HTTP 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" type="text/javascript">
</script>
<link href="../images/favicon.ico" 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur Apache HTTP Version 2.5</p>
<img alt="" src="../images/feather.png" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
<div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://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>
<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<61>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 <20>
<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<75>de<64>Module:</a></th><td>proxy_fcgi_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Fichier<65>Source:</a></th><td>mod_proxy_fcgi.c</td></tr>
<tr><th><a href="module-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.3 d'Apache</td></tr></table>
<h3>Sommaire</h3>
<p>Pour fonctionner, ce module <em>n<>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="http://www.fastcgi.com/">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 <20>tre charg<72>s dans le serveur.</p>
<p>A la diff<66>rence de <a href="http://httpd.apache.org/mod_fcgid/">mod_fcgid</a> et <a href="http://www.fastcgi.com/">mod_fastcgi</a>,
<code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code> n'est pas en mesure de d<>marrer le
processus de l'application ; <code class="program"><a href="../programs/fcgistarter.html">fcgistarter</a></code> est
fourni <20> cet effet sur certaines plateformes. Le framework
applicatif FastCGI utilis<69> 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<69> de mandataire avant d'avoir <a href="mod_proxy.html#access">s<>curis<69> votre serveur</a>. Les
serveurs mandataires ouverts sont dangereux non seulement pour
votre r<>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<62>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>
<li><a href="#comments_section">Commentaires</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="examples" id="examples">Exemples</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<>faut la
r<>utilisation des connexions, lorsqu'une requ<71>te a <20>t<EFBFBD> trait<69>e, la
connexion ne sera pas maintenue ouverte par le processus enfant
httpd, et ne sera donc pas r<>utilis<69>e. Cependant, si l'application
FastCGI supporte les connexions httpd simultan<61>es, vous pouvez opter
pour la r<>utilisation des connexions comme dans l'exemple suivant :</p>
<div class="example"><h3>Instance d'application unique, r<>utilisation
des connexions (versions 2.4.11 et sup<75>rieures)</h3><pre class="prettyprint lang-config">ProxyPass "/myapp/" "fcgi://localhost:4000/" enablereuse=on</pre>
</div>
<p>Dans l'exemple suivant, l'URI de la requ<71>te est transmis en tant
que chemin du syst<73>me de fichiers pour l'ex<65>cution du d<>mon PHP-FPM.
L'URL de la requ<71>te est implicitement ajout<75>e au second param<61>tre.
PHP-FPM est <20> l'<27>coute de l'h<>te et du port qui
suivent fcgi://. La conservation/r<>utilisation des connexions est activ<69>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<71>te est transmis en tant
que chemin du syst<73>me de fichiers pour l'ex<65>cution du d<>mon PHP-FPM.
Dans ce cas cependant, PHP-FPM est <20> l'<27>coute d'un socket de domaine
unix (UDS). Cette fonctionnalit<69> est disponible <20> partir de la
version 2.4.9. Avec cette syntaxe, si un nom d'h<>te et un port sont
ajout<75>s apr<70>s fcgi://, ils seront ignor<6F>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 <20> traiter les paquets de
donn<6E>es en provenance du serveur FCGI d'arri<72>re-plan d<>s leur r<>ception, sans les
faire transiter par un tampon.
</p>
<div class="example"><h3>Force le traitement des donn<6E>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<70>c<EFBFBD>dent avec une diff<66>rence : ici,
les donn<6E>es en provenance du serveur FCGI d'arri<72>re-plan sont trait<69>es apr<70>s un
temps de valeur fixe (elles sont mises en tampon). Cette m<>thode est
utile si le serveur FCGI d'arri<72>re-plan envoie ses donn<6E>es sous forme
de petits paquets, auquel cas le traitement imm<6D>diat de chacun d'entre eux
serait inefficace et couteux en ressources. Notez que cet exemple ne sera
peut-<2D>tre pas adapt<70> dans le cas o<> l'envoi de paquets de donn<6E>es par
l'application FCGI est bloqu<71> par l'attente de donn<6E>es en provenance du
client.
</p>
<div class="example"><h3>Force le traitement des donn<6E>es FCGI apr<70>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 <20> r<>partition de charge n<>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<>partition de charge, comme
<code class="module"><a href="../mod/mod_lbmethod_byrequests.html">mod_lbmethod_byrequests</a></code> en plus des modules
d<>j<EFBFBD> cit<69>s. <code class="module"><a href="../mod/mod_lbmethod_byrequests.html">mod_lbmethod_byrequests</a></code> est le module
par d<>faut et sera utilis<69> dans cet exemple de configuration.</p>
<div class="example"><h3>Passerelle <20> r<>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<71>te en tant que
requ<71>te de mandataire inverse en cr<63>ant un court-circuiteur de
gestionnaire appropri<72>. Dans l'exemple ci-dessous, toutes les
requ<71>tes pour des scripts PHP seront transmises au serveur FastCGI
sp<73>cifi<66> par mandat inverse. Cette fonctionnalit<69> est disponible <20>
partir de la version 2.4.10 du serveur HTTP Apache. Pour des raisons
de performances, il est recommand<6E> de d<>finir un <a href="mod_proxy.html#workers">worker (configuration d'un
mandataire)</a> repr<70>sentant le m<>me serveur fcgi:// d'arri<72>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<72>re-plan. Lorsque FastCGI est configur<75> ainsi, le serveur est
en mesure de calculer le PATH_INFO le plus appropri<72>.
</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<>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 <20>tre chang<6E> 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><a name="env" id="env">Variables d'environnement</a></h2>
<p>En plus des directives de configuration qui contr<74>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<75> 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<>finit pas la variable
d'environnement <var>PATH_INFO</var>,
ce qui permet au serveur FCGI d'arri<72>re-plan de d<>terminer
correctement <var>SCRIPT_NAME</var> et <var>Script-URI</var>, et
de se conformer <20> 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<>n<EFBFBD>re une
"estimation la plus exacte possible" de <var>PATH_INFO</var>,
d<>finissez la variable d'environnement
<var>proxy-fcgi-pathinfo</var>. Ceci peut servir de
contournement pour une bogue pr<70>sente dans certaines
impl<70>mentations de FCGI. Cette variable peut <20>tre
multivalu<6C>e afin de pouvoir choisir la valeur la plus appropri<72>e
(versions 2.4.11 et sup<75>rieures) :
<dl>
<dt>first-dot</dt>
<dd>PATH_INFO est extrait <20> partir du slash qui suit le
<em>premier</em> "." de l'URL.</dd>
<dt>last-dot</dt>
<dd>PATH_INFO est extrait <20> partir du slash qui suit le
<em>dernier</em> "." de l'URL.</dd>
<dt>full</dt>
<dd>PATH_INFO est calcul<75> en supposant que l'URL correspond au
chemin du syst<73>me de fichiers.</dd>
<dt>unescape</dt>
<dd>PATH_INFO correspond <20> la partie chemin de l'URL avec ses
s<>quences d'<27>chappement d<>cod<6F>es.</dd>
<dt>toute autre valeur</dt>
<dd>PATH_INFO correspond <20> la partie chemin de l'URL.
Auparavant, c'<27>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><a name="proxyfcgibackendtype" id="proxyfcgibackendtype">Directive</a> <a name="ProxyFCGIBackendType" id="ProxyFCGIBackendType">ProxyFCGIBackendType</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sp<53>cifie le type de l'application FastCGI d'arri<72>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<>faut:</a></th><td><code>ProxyFCGIBackendType FPM</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</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<69>:</a></th><td>Disponible <20> partir de la version 2.4.26 du serveur HTTP Apache</td></tr>
</table>
<p>Cette directive permet de sp<73>cifier le type de l'application FastCGI
d'arri<72>re-plan. Certains serveurs FastCGI, comme PHP-FPM, utilisent de mani<6E>re
historique des variables d'environnement exotiques pour identifier le type du
serveur mandataire utilis<69>. D<>finissez cette directive <20> "GENERIC" si votre
application n'est pas de type PHP-FPM et n'interpr<70>ter pas correctement des
variables d'environnement comme SCRIPT_FILENAME ou PATH_TRANSLATED telles
qu'elles sont d<>finies par le serveur.</p>
<p>SCRIPT_FILENAME est un exemple de valeur modifi<66>e par la d<>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 <20>tait pr<70>fix<69> par la cha<68>ne
"proxy:fcgi://". C'est cette variable que lisent certaines applications FastCGI
g<EFBFBD>n<EFBFBD>riques en tant que valeur en entr<74>e pour leur script ; cependant, PHP-FPM
peut supprimer le pr<70>fixe, puis garder en m<>moire qu'il communique avec Apache.
Avec les versions 2.4.21 <20> 2.4.25, ce pr<70>fixe <20>tait automatiquement supprim<69> par
le serveur, emp<6D>chant ainsi PHP-FPM de d<>tecter et interop<6F>rer avec Apache dans
certains sc<73>narios.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="proxyfcgisetenvif" id="proxyfcgisetenvif">Directive</a> <a name="ProxyFCGISetEnvIf" id="ProxyFCGISetEnvIf">ProxyFCGISetEnvIf</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<6F>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 du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</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<69>:</a></th><td>Disponible <20> partir de la version 2.4.26 du serveur HTTP Apache.</td></tr>
</table>
<p>Juste avant la transmission d'une requ<71>te au serveur FastCGI configur<75>, le
coeur du programme du serveur web d<>finit un certain nombre de variables
d'environnement en fonction de certains d<>tails de la requ<71>te consid<69>r<EFBFBD>e. Les
programmes FastCGI utilisent souvent ces variables comme donn<6E>es en entr<74>e afin
de d<>terminer quels scripts sous-jacents ils vont ex<65>cuter, ou quelles donn<6E>es
en sortie doivent <20>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 <20>valu<6C>e apr<70>s la d<>finition de la valeur
initiale de ces variables ; elle peuvent donc <20>tre utilis<69>es comme entr<74>es dans
les expressions d<>finissants les conditions et les valeurs.</p>
<p>Syntaxe des param<61>tres :</p>
<dl>
<dt>conditional-expression</dt>
<dd>D<>finit une condition en fonction de laquelle la
variable d'environnement qui suit sera modifi<66>e ou non. Pour la syntaxe de cette
expression, reportez-vous aux exemples qui suivent ou <20> la sp<73>cification
d<EFBFBD>taill<EFBFBD>e dans le document <a href="../expr.html">ap_expr</a>.
</dd>
<dt>environment-variable-name</dt>
<dd>Sp<53>cifie le nom de la variable d'environnement <20> modifier, par exemple
PATH_INFO. Si elle est pr<70>c<EFBFBD>d<EFBFBD>e d'un point d'exclamation, la d<>finition de la
variable sera annul<75>e.</dd>
<dt>value-expression</dt>
<dd>Sp<53>cifie la nouvelle valeur de la variable "environment-variable-name". On
peut inclure des
r<EFBFBD>f<EFBFBD>rences arri<72>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<>finie (ou sa valeur est <20>cras<61>e) par une cha<68>ne vide
&#8212; voir cependant la note ci-apr<70>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<73>cifier la nouvelle valeur
ProxyFCGISetEnvIf "true" PATH_INFO "%{reqenv:SCRIPT_NAME}"
<br />
# Utilisation de captures dans la condition et de r<>f<EFBFBD>rences arri<72>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<>finition ou valeur vide</h3>
La ligne suivante annule la d<>finition de la variable <code>VARIABLE</code>,
ce qui l'emp<6D>che d'<27>tre envoy<6F>e au serveur FastCGI :
<pre class="prettyprint lang-config">ProxyFCGISetEnvIf true !VARIABLE</pre>
La ligne suivante, quant <20> elle, efface la <em>valeur</em> de la variable
<code>VARIABLE</code> en lui affectant la cha<68>ne vide ; cette variable
<code>VARIABLE</code> sera alors tout de m<>me envoy<6F>e au serveur FastCGI :
<pre class="prettyprint lang-config">ProxyFCGISetEnvIf true VARIABLE</pre>
La sp<73>cification CGI/1.1 <a href="https://tools.ietf.org/html/rfc3875#section-4.1">ne fait pas de
distinction</a> entre une variable contenant une cha<68>ne vide et une variable qui
n'existe pas. De nombreuses impl<70>mentations CGI et FastCGI font cependant
cette distinction (ou permettent aux scripts de la faire). Le choix de celle
que vous allez utiliser d<>pend de votre impl<70>mentation et de la raison qui
vous pousse <20> 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<61>ais">&nbsp;fr&nbsp;</a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_proxy_fcgi.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2017 The Apache Software Foundation.<br />Autoris<69> sous <a href="http://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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html>
View Git Blame Copy Permalink