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

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