<-
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

top

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>
top

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 

top

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.