Module Apache mod_cgi

Langues Disponibles: en | fr | ja | ko

Description:	Exï¿½cution des scripts CGI
Statut:	Base
Identificateurï¿½deï¿½Module:	cgi_module
Fichierï¿½Source:	mod_cgi.c

Sommaire

Tout fichier pris en compte par le gestionnaire cgi-script sera traitï¿½ en tant que script CGI et exï¿½cutï¿½ par le serveur, sa sortie ï¿½tant renvoyï¿½e au client. Les fichiers sont associï¿½s ï¿½ ce gestionnaire soit parce qu'ils possï¿½dent un nom contenant une extension dï¿½finie par la directive AddHandler, soit parce qu'ils se situent dans un rï¿½pertoire dï¿½fini par une directive ScriptAlias.

Comme introduction ï¿½ l'utilisation des scripts CGI avec Apache, voir notre tutoriel Les contenus dynamiques avec CGI.

Il est recommandï¿½ d'utiliser le module mod_cgid ï¿½ la place de mod_cgi lorsqu'on utilise un module MPM multi-threadï¿½ sous Unix. Vus de l'utilisateur, les deux modules sont pratiquement identiques.

ï¿½ des fins de compatibilitï¿½ ascendante, le gestionnaire cgi-script sera aussi activï¿½ pour tout fichier possï¿½dant le type MIME application/x-httpd-cgi. L'utilisation du type MIME magic est obsolï¿½te.

Les variables d'environnement CGI

Le serveur va dï¿½finir les variables d'environnement CGI comme dï¿½crit dans la Spï¿½cification CGI, de la maniï¿½re suivante :

PATH_INFO: Cette variable ne sera pas disponible si la directive AcceptPathInfo est explicitement dï¿½finie ï¿½ off. Par dï¿½faut, si la directive AcceptPathInfo n'est pas dï¿½finie, mod_cgi acceptera des informations de chemin (en ajoutant /infos/chemin aprï¿½s le nom du script dans l'URI), alors que le serveur de base retournera une erreur 404 NOT FOUND pour les requï¿½tes contenant des informations de chemin supplï¿½mentaires. Ne pas dï¿½finir la directive AcceptPathInfo a le mï¿½me effet sur les requï¿½tes avec mod_cgi que de la dï¿½finir ï¿½ On.
REMOTE_HOST: Cette variable ne sera dï¿½finie que si la directive HostnameLookups est dï¿½finie ï¿½ on (elle est ï¿½ off par dï¿½faut), et si une recherche DNS inverse sur l'adresse IP de l'hï¿½te client aboutit effectivement ï¿½ un nom d'hï¿½te.
REMOTE_IDENT: Cette variable ne sera dï¿½finie que si la directive IdentityCheck est dï¿½finie ï¿½ on, et si l'hï¿½te client supporte le protocole ident. Notez que l'on ne peut accorder une confiance aveugle au contenu de cette variable car il peut ï¿½tre aisï¿½ment falsifiï¿½, et si un mandataire s'intercale entre le client et le serveur, il est totalement inutilisable.
REMOTE_USER: Cette variable ne sera dï¿½finie que si le script CGI fait l'objet d'une authentification.

Dï¿½bogage des scripts CGI

Le dï¿½bogage des scripts CGI ï¿½tait difficile par le passï¿½, principalement parce qu'il n'ï¿½tait pas possible d'ï¿½tudier la sortie (sortie standard et erreurs) des scripts dont l'exï¿½cution ï¿½chouait. Les directives qui suivent permettent une journalisation plus dï¿½taillï¿½e des erreurs.

Format du fichier journal CGI

Lorsqu'il est configurï¿½, le journal des erreurs CGI enregistre la sortie de tout programme CGI dont l'exï¿½cution ne s'effectue pas correctement. Un script CGI dont l'exï¿½cution ï¿½choue provoque la journalisation d'une grande quantitï¿½ d'informations. Les deux premiï¿½res lignes possï¿½dent toujours le format suivant :

%% [date] requï¿½te %% ï¿½tat HTTP nom du script CGI

Si le script CGI n'a pas pu dï¿½marrer, le fichier journal contiendra les deux lignes supplï¿½mentaires suivantes :

%%erreur message d'erreur

Par contre, si l'erreur provient du renvoi par le script d'informations incorrectes dans les en-tï¿½tes (dï¿½ souvent ï¿½ une bogue du script), les informations suivantes sont journalisï¿½es :

%requï¿½te Tous les en-tï¿½tes de requï¿½te HTTP reï¿½us Les entitï¿½s POST ou PUT (s'il en existe) %rï¿½ponse Tous les en-tï¿½tes gï¿½nï¿½rï¿½s par le script CGI %stdout la sortie standard CGI %stderr la sortie d'erreurs standard CGI

(Les parties %stdout et %stderr seront absentes si le script n'a rien envoyï¿½ sur la sortie standard ou la sortie d'erreurs).

ScriptLog Directive

Description:	Chemin du fichier journal des erreurs du script CGI
Syntaxe:	`ScriptLog chemin fichier`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Base
Module:	`mod_cgi`, `mod_cgid`

La directive ScriptLog permet de dï¿½finir le chemin du fichier journal des erreurs du script CGI. Si cette directive n'est pas dï¿½finie, aucune journalisation des erreurs n'est effectuï¿½e. Si elle est dï¿½finie, toute erreur CGI sera enregistrï¿½e dans le fichier dont le nom est fourni en argument. S'il s'agit d'un chemin de fichier relatif, il est considï¿½rï¿½ par rapport au rï¿½pertoire dï¿½fini par la directive ServerRoot.

Exemple

ScriptLog logs/cgi_log

Ce journal sera ouvert par l'utilisateur sous lequel les processus enfants s'exï¿½cutent, c'est ï¿½ dire l'utilisateur spï¿½cifiï¿½ par la directive du serveur User. Ceci implique que le rï¿½pertoire dans lequel se trouve le journal doit ï¿½tre accessible en ï¿½criture pour cet utilisateur, ou bien que le fichier est crï¿½ï¿½ manuellement et accessible en ï¿½criture pour cet utilisateur. Si vous placez le journal du script dans votre rï¿½pertoire principal des journaux, ne modifiez JAMAIS les permissions de ce dernier afin de le le rendre accessible en ï¿½criture par l'utilisateur sous lequel les processus enfants s'exï¿½cutent.

Notez que l'on ne doit activer la journalisation des scripts qu'ï¿½ des fins de dï¿½bogage lors de l'ï¿½criture de scripts CGI, et non de maniï¿½re permanente sur un serveur en production. Elle n'est pas optimisï¿½e en terme de performances et d'efficacitï¿½, et peut prï¿½senter des problï¿½mes de sï¿½curitï¿½ si on l'utilise dans un cadre autre que celui pour lequel elle a ï¿½tï¿½ conï¿½ue.

ScriptLogBuffer Directive

Description:	Taille maximale des requï¿½tes PUT ou POST qui seront enregistrï¿½es dans le journal du script
Syntaxe:	`ScriptLogBuffer octets`
Dï¿½faut:	`ScriptLogBuffer 1024`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Base
Module:	`mod_cgi`, `mod_cgid`

Cette directive permet de limiter la taille du corps de toute entitï¿½ PUT ou POST qui sera enregistrï¿½e dans le journal, afin de prï¿½venir une croissance trop importante et trop rapide du fichier journal due ï¿½ la rï¿½ception de corps de requï¿½te de grandes tailles. Cette directive permet de modifier cette taille maximale, dont la valeur par dï¿½faut est de 1024 octets.

ScriptLogLength Directive

Description:	Taille maximale du fichier journal des scripts CGI
Syntaxe:	`ScriptLogLength octets`
Dï¿½faut:	`ScriptLogLength 10385760`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Base
Module:	`mod_cgi`, `mod_cgid`

La directive ScriptLogLength permet de dï¿½finir la taille maximale du fichier journal des scripts CGI. Comme le fichier journal accumule une grande quantitï¿½ d'informations par erreur CGI (tous les en-tï¿½tes de la requï¿½te, toutes les sorties du script), il peut vite atteindre une grande taille. En limitant la taille du fichier, cette directive permet d'ï¿½viter les problï¿½mes que causerait sa croissance sans limites. Lorsque le fichier a atteint cette taille maximale, plus aucune information n'y est enregistrï¿½e.

Module Apache mod_cgi

Sommaire

Directives

Sujets

Voir aussi