Serveur Apache HTTP Version 2.4

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

- Exemples
- Variables d'environnement

### Voir aussi

- `mod_proxy`
- `mod_proxy_balancer`

- Commentaires

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

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

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

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

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