<-
Apache > Serveur HTTP > Documentation > Version 2.4 > Modules

Module Apache mod_proxy_scgi

Langues Disponibles:  en  |  fr 

Description:Module fournissant le support de la passerelle SCGI � mod_proxy
Statut:Extension
Identificateur�de�Module:proxy_scgi_module
Fichier�Source:mod_proxy_scgi.c
Compatibilit�:Disponible depuis la version 2.2.14 d'Apache

Sommaire

Pour pouvoir fonctionner, ce module requiert le chargement de mod_proxy. Il fournit le support du protocole SCGI, version 1.

Ainsi, pour �tre en mesure de traiter le protocole SCGI, mod_proxy et mod_proxy_scgi doivent �tre charg�s dans le serveur.

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

Sujets

Voir aussi

top

Exemples

Rappelez-vous, pour que les exemples suivants puissent fonctionner, vous devez activer mod_proxy et mod_proxy_scgi.

Passerelle simple

ProxyPass /scgi-bin/ scgi://localhost:4000/

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

ProxyPass /scgi-bin/ balancer://somecluster/
<Proxy balancer://somecluster>
    BalancerMember scgi://localhost:4000
    BalancerMember scgi://localhost:4001
</Proxy>
top

Variables d'environnement

En plus des directives de configuration qui permettent de contr�ler le comportement de mod_proxy, de nombreuses variables d'environnement permettent de contr�ler le fournisseur de protocole SCGI :

proxy-scgi-pathinfo
Par d�faut, mod_proxy_scgi ne cr�era ni exportera jamais la variable d'environnement PATH_INFO. Ceci permet au serveur SCGI d'arri�re-plan de d�terminer correctement SCRIPT_NAME et Script-URI, et de rester en conformit� avec la section 3.3 de la RFC 3875. Si au contraire vous souhaitez que mod_proxy_scgi g�n�re une estimation la plus pr�cise possible de PATH_INFO, d�finissez cette variable d'environnement.
top

ProxySCGIInternalRedirect Directive

Description:Active ou d�sactive les r�ponses de redirection interne en provenance du serveur cible.
Syntaxe:ProxySCGIInternalRedirect On|Off
D�faut:ProxySCGIInternalRedirect On
Contexte:configuration du serveur, serveur virtuel, r�pertoire
Statut:Extension
Module:mod_proxy_scgi

La directive ProxySCGIInternalRedirect permet au serveur cible de rediriger en interne la passerelle vers une URL diff�rente. Cette fonctionnalit� trouve son origine dans mod_cgi qui redirige la r�ponse en interne si l'�tat de la r�ponse est OK (200), et si la r�ponse contient un en-t�te Location dont la valeur d�bute par un slash (/). Cette valeur est interpr�t�e comme une nouvelle URL locale vers laquelle Apache httpd effectue sa redirection.

De ce point de vue, mod_proxy_scgi fait la m�me chose que mod_cgi, mais vous pouvez en plus d�sactiver la fonctionnalit�.

Exemple

ProxySCGIInternalRedirect Off
top

ProxySCGISendfile Directive

Description:Active l'�valuation du pseudo en-t�te de r�ponse X-Sendfile
Syntaxe:ProxySCGISendfile On|Off|nom-en-t�te
D�faut:ProxySCGISendfile Off
Contexte:configuration du serveur, serveur virtuel, r�pertoire
Statut:Extension
Module:mod_proxy_scgi

La directive ProxySCGISendfile permet au serveur cible SCGI de faire servir les fichiers directement par la passerelle. Ceci s'av�re b�n�fique en mati�re de performances — httpd peut alors utiliser sendfile ou d'autres optimisations, ce qui n'est pas possible si les fichiers passent par la socket du serveur cible. En outre, les fichiers ne sont transmis qu'une seule fois.

L'argument de la directive ProxySCGISendfile d�termine le comportement de la passerelle :

Off
Aucun traitement particulier n'est effectu�.
On
La passerelle recherche un en-t�te dans la r�ponse du serveur cible nomm� X-Sendfile, et interpr�te sa valeur comme le nom du fichier � servir. L'en-t�te est ensuite supprim� de la r�ponse finale. Cet argument produit le m�me effet que ProxySCGISendfile X-Sendfile.
toute autre valeur
Identique � On, mais au lieu de rechercher le nom d'en-t�te cod� en dur X-Sendfile, c'est la valeur de l'argument qui constitue le nom de l'en-t�te � rechercher.

Exemple

    # Utilise le nom d'en-t�te par d�faut (X-Sendfile)
    ProxySCGISendfile On

    # Utilise un nom d'en-t�te diff�rent
    ProxySCGISendfile X-Send-Static

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.