Serveur Apache HTTP Version 2.4
Description: | Module fournissant le support de FastCGI à
mod_proxy |
---|---|
Statut: | Extension |
Identificateur de Module: | proxy_fcgi_module |
Fichier Source: | mod_proxy_fcgi.c |
Compatibilité: | Disponible depuis la version 2.3 d'Apache |
Pour fonctionner, ce module nécessite le chargement de
mod_proxy
. Il fournit le support du protocole FastCGI.
Ainsi, pour pouvoir traiter le protocole FastCGI
,
mod_proxy
et mod_proxy_fcgi
doivent être chargés dans le serveur.
À la différence de mod_fcgid et mod_fastcgi,
mod_proxy_fcgi
n'est pas en mesure de démarrer le
processus de l'application ; fcgistarter
est
fourni à cet effet.
N'activez pas la fonctionnalité de mandataire avant d'avoir sécurisé votre serveur. Les serveurs mandataires ouverts sont dangereux non seulement pour votre réseau, mais aussi pour l'Internet au sens large.
Ce module ne fournit aucune directive.
Pour que ces exemples fonctionnent, vous ne devez pas oublier
d'activer mod_proxy
et
mod_proxy_fcgi
.
ProxyPass /mon_appli/ fcgi://localhost:4000/
Cette application doit être en mesure de gérer plusieurs
connexions simultanées. Par défaut, mod_proxy
permet la réutilisation des connexions, si bien que lorsque le
traitement d'une requête est terminé, le processus enfant httpd
garde la connexion ouverte, et cette dernière ne sera pas réutilisée
avant que le même processus httpd ne redirige une autre requête vers
l'application. Si l'application FastCGI n'est pas en mesure de gérer
un nombre suffisant de connexions simultanées avec httpd, les
requêtes peuvent rester bloquées jusqu'à ce que l'application ferme
une connexion existante. Pour remédier à ce problème, on peut
désactiver la réutilisation des connexions à l'aide de la directive
ProxyPass
, comme indiqué dans l'exemple
suivant :
ProxyPass /mon_appli/ fcgi://localhost:4000/ disablereuse=on
La passerelle à répartition de charge nécessite le chargement du
module mod_proxy_balancer
et d'au moins un module
fournissant un algorithme de répartition de charge, comme
mod_lbmethod_byrequests
en plus des modules
déjà cités. mod_lbmethod_byrequests
est le module
par défaut et sera utilisé dans cet exemple de configuration.
ProxyPass /myapp/ balancer://myappcluster/ <Proxy balancer://myappcluster/> BalancerMember fcgi://localhost:4000/ BalancerMember fcgi://localhost:4001/ </Proxy>
En plus des directives de configuration qui contrôlent le
comportement de mod_proxy
, de nombreuses
variables d'environnement permettent de piloter le
fournisseur du protocole FCGI :
mod_proxy_fcgi
ne créera jamais
ni n'exportera la variable d'environnement PATH_INFO,
ce qui permet au serveur FCGI d'arrière-plan de déterminer
correctement SCRIPT_NAME et Script-URI, et
de se conformer à la section 3.3 de la RFC 3875. Si au contraire
vous souhaitez que mod_proxy_fcgi
génère une
"estimation la plus exacte possible" de PATH_INFO,
définissez la variable d'environnement
proxy-fcgi-pathinfo. Ceci peut servir de
contournement pour un bogue présent dans certaines
implémentations de FCGI.