Apache > Serveur HTTP > Documentation > Version 2.4 > Modules

Module Apache mod_proxy_fcgi

Langues Disponibles:  en  |  fr 

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

Sommaire

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.

A 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 sur certaines plateformes. Le framework applicatif FastCGI utilis� peut aussi fournir la gestion des processus ou des lancements de programmes externes.

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.

Directives

Ce module ne fournit aucune directive.

Sujets

Voir aussi

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 �tre 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 avez 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 une bogue pr�sente dans certaines impl�mentations de FCGI.

Langues Disponibles:  en  |  fr 

Commentaires

Notice:
This is not a Q&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 mailing lists.