mod_proxy_fcgi
Module fournissant le support de FastCGI à mod_proxy
Extension
mod_proxy_fcgi.c
proxy_fcgi_module
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.

# Avertissement

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.

fcgistarter
mod_proxy

# Exemples

Pour que ces exemples fonctionnent, vous ne devez pas oublier d'activer mod_proxy et mod_proxy_fcgi.

## Instance d'application unique

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 :

## Instance d'application unique, pas de réutilisation des connexions

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.

## Passerelle à répartition de charge vers plusieurs instances de l'application

ProxyPass /myapp/ balancer://myappcluster/ <Proxy balancer://myappcluster/> BalancerMember fcgi://localhost:4000 BalancerMember fcgi://localhost:4001 </Proxy>

# Variables d'environnement

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 :

proxy-fcgi-pathinfo
  Par défaut, 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.