1<?xml version="1.0" encoding="ISO-8859-1"?> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!-- 4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 5 This file is generated from xml source: DO NOT EDIT 6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 7 --> 8<title>mod_cgi - Serveur Apache HTTP</title> 9<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> 10<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> 11<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" /> 12<script src="/style/scripts/prettify.min.js" type="text/javascript"> 13</script> 14 15<link href="/images/favicon.ico" rel="shortcut icon" /></head> 16<body> 17<div id="page-header"> 18<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p> 19<p class="apache">Serveur Apache HTTP Version 2.4</p> 20<img alt="" src="/images/feather.gif" /></div> 21<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div> 22<div id="path"> 23<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Modules</a></div> 24<div id="page-content"> 25<div id="preamble"><h1>Module Apache mod_cgi</h1> 26<div class="toplang"> 27<p><span>Langues Disponibles: </span><a href="/en/mod/mod_cgi.html" hreflang="en" rel="alternate" title="English"> en </a> | 28<a href="/fr/mod/mod_cgi.html" title="Fran�ais"> fr </a> | 29<a href="/ja/mod/mod_cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 30<a href="/ko/mod/mod_cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> 31</div> 32<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Ex�cution des scripts CGI</td></tr> 33<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> 34<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>cgi_module</td></tr> 35<tr><th><a href="module-dict.html#SourceFile">Fichier�Source:</a></th><td>mod_cgi.c</td></tr></table> 36<h3>Sommaire</h3> 37 38 <p>Tout fichier pris en compte par le gestionnaire 39 <code>cgi-script</code> sera trait� en tant que script CGI et 40 ex�cut� par le serveur, sa sortie �tant renvoy�e au client. Les 41 fichiers sont associ�s � ce gestionnaire soit parce qu'ils poss�dent 42 un nom contenant une extension d�finie par la directive <code class="directive"><a href="/mod/mod_mime.html#addhandler">AddHandler</a></code>, soit parce qu'ils se 43 situent dans un r�pertoire d�fini par une directive <code class="directive"><a href="/mod/mod_alias.html#scriptalias">ScriptAlias</a></code>.</p> 44 45 <p>Comme introduction � l'utilisation des scripts CGI avec Apache, 46 voir notre tutoriel <a href="/howto/cgi.html">Les contenus 47 dynamiques avec CGI</a>.</p> 48 49 <p>Il est recommand� d'utiliser le module <code class="module"><a href="/mod/mod_cgid.html">mod_cgid</a></code> 50 � la place de <code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code> lorsqu'on utilise un module MPM 51 multi-thread� sous Unix. Vus de l'utilisateur, les deux modules 52 sont pratiquement identiques.</p> 53 54 <p>� des fins de compatibilit� ascendante, le gestionnaire 55 cgi-script sera aussi activ� pour tout fichier poss�dant le type 56 MIME <code>application/x-httpd-cgi</code>. L'utilisation du type 57 MIME magic est obsol�te.</p> 58</div> 59<div id="quickview"><h3 class="directives">Directives</h3> 60<ul id="toc"> 61<li><img alt="" src="/images/down.gif" /> <a href="#scriptlog">ScriptLog</a></li> 62<li><img alt="" src="/images/down.gif" /> <a href="#scriptlogbuffer">ScriptLogBuffer</a></li> 63<li><img alt="" src="/images/down.gif" /> <a href="#scriptloglength">ScriptLogLength</a></li> 64</ul> 65<h3>Sujets</h3> 66<ul id="topics"> 67<li><img alt="" src="/images/down.gif" /> <a href="#env">Les variables d'environnement CGI</a></li> 68<li><img alt="" src="/images/down.gif" /> <a href="#cgi-debug">D�bogage des scripts CGI</a></li> 69</ul><h3>Voir aussi</h3> 70<ul class="seealso"> 71<li><code class="directive"><a href="/mod/core.html#acceptpathinfo">AcceptPathInfo</a></code></li> 72<li><code class="directive"><a href="/mod/core.html#options">Options</a></code> ExecCGI</li> 73<li><code class="directive"><a href="/mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li> 74<li><code class="directive"><a href="/mod/mod_mime.html#addhandler">AddHandler</a></code></li> 75<li><a href="/suexec.html">Ex�cuter des programmes CGI sous des 76utilisateurs diff�rents</a></li> 77<li><a href="http://www.ietf.org/rfc/rfc3875">La sp�cification 78CGI</a></li> 79</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> 80<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 81<div class="section"> 82<h2><a name="env" id="env">Les variables d'environnement CGI</a></h2> 83 <p>Le serveur va d�finir les variables d'environnement CGI comme 84 d�crit dans la <a href="http://www.ietf.org/rfc/rfc3875">Sp�cification CGI</a>, de la 85 mani�re suivante :</p> 86 87 <dl> 88 <dt>PATH_INFO</dt> 89 90 <dd>Cette variable ne sera pas disponible si la directive 91 <code class="directive"><a href="/mod/core.html#acceptpathinfo">AcceptPathInfo</a></code> est 92 explicitement d�finie � <code>off</code>. Par d�faut, si la 93 directive <code class="directive">AcceptPathInfo</code> n'est pas d�finie, 94 <code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code> acceptera des informations de chemin (en 95 ajoutant /infos/chemin apr�s le nom du script dans l'URI), alors 96 que le serveur de base retournera une erreur 404 NOT FOUND pour 97 les requ�tes contenant des informations de chemin suppl�mentaires. 98 Ne pas d�finir la directive <code class="directive">AcceptPathInfo</code> 99 a le m�me effet sur les requ�tes avec <code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code> que 100 de la d�finir � <code>On</code>.</dd> 101 102 <dt>REMOTE_HOST</dt> 103 104 <dd>Cette variable ne sera d�finie que si la directive <code class="directive"><a href="/mod/core.html#hostnamelookups">HostnameLookups</a></code> est d�finie � 105 <code>on</code> (elle est � <code>off</code> par d�faut), et si 106 une recherche DNS inverse sur l'adresse IP de l'h�te client 107 aboutit effectivement � un nom d'h�te.</dd> 108 109 <dt>REMOTE_IDENT</dt> 110 111 <dd>Cette variable ne sera d�finie que si la directive <code class="directive"><a href="/mod/mod_ident.html#identitycheck">IdentityCheck</a></code> 112 est d�finie � <code>on</code>, et si l'h�te client supporte le 113 protocole ident. Notez que l'on ne peut accorder une confiance 114 aveugle au contenu de cette variable car il peut �tre ais�ment 115 falsifi�, et si un mandataire s'intercale entre le client et le 116 serveur, il est totalement inutilisable.</dd> 117 118 <dt>REMOTE_USER</dt> 119 120 <dd>Cette variable ne sera d�finie que si le script CGI fait 121 l'objet d'une authentification.</dd> 122 </dl> 123</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 124<div class="section"> 125<h2><a name="cgi-debug" id="cgi-debug">D�bogage des scripts CGI</a></h2> 126 <p>Le d�bogage des scripts CGI �tait difficile par le pass�, 127 principalement parce qu'il n'�tait pas possible d'�tudier la sortie 128 (sortie standard et erreurs) des scripts dont l'ex�cution �chouait. 129 Les directives qui suivent permettent une journalisation plus d�taill�e des 130 erreurs.</p> 131 132 <h3>Format du fichier journal CGI</h3> 133 <p>Lorsqu'il est configur�, le journal des erreurs CGI enregistre 134 la sortie de tout programme CGI dont l'ex�cution ne s'effectue pas 135 correctement. Un script CGI dont l'ex�cution �choue provoque la 136 journalisation d'une grande quantit� d'informations. Les deux 137 premi�res lignes poss�dent toujours le format suivant :</p> 138 139 <div class="example"><p><code> 140 %% [<var>date</var>] <var>requ�te</var><br /> 141 %% <var>�tat HTTP</var> <var>nom du script CGI</var> 142 </code></p></div> 143 144 <p>Si le script CGI n'a pas pu d�marrer, le fichier journal 145 contiendra les deux lignes suppl�mentaires suivantes :</p> 146 147 <div class="example"><p><code> 148 %%erreur<br /> 149 <var>message d'erreur</var> 150 </code></p></div> 151 152 <p>Par contre, si l'erreur provient du renvoi par le script 153 d'informations incorrectes dans les en-t�tes (d� souvent � une 154 bogue du script), les informations suivantes sont journalis�es 155 :</p> 156 157 <div class="example"><p><code> 158 %requ�te<br /> 159 <var>Tous les en-t�tes de requ�te HTTP re�us</var><br /> 160 <var>Les entit�s POST ou PUT (s'il en existe)</var><br /> 161 %r�ponse<br /> 162 <var>Tous les en-t�tes g�n�r�s par le script CGI</var><br /> 163 %stdout<br /> 164 <var>la sortie standard CGI</var><br /> 165 %stderr<br /> 166 <var>la sortie d'erreurs standard CGI</var><br /> 167 </code></p></div> 168 169 <p>(Les parties %stdout et %stderr seront absentes si le script 170 n'a rien envoy� sur la sortie standard ou la sortie 171 d'erreurs).</p> 172 173</div> 174<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 175<div class="directive-section"><h2><a name="ScriptLog" id="ScriptLog">ScriptLog</a> <a name="scriptlog" id="scriptlog">Directive</a></h2> 176<table class="directive"> 177<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Chemin du fichier journal des erreurs du script 178CGI</td></tr> 179<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptLog <var>chemin fichier</var></code></td></tr> 180<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 181<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 182<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code>, <code class="module"><a href="/mod/mod_cgid.html">mod_cgid</a></code></td></tr> 183</table> 184 <p>La directive <code class="directive">ScriptLog</code> permet de d�finir 185 le chemin du fichier journal des erreurs du script CGI. Si cette 186 directive n'est pas d�finie, aucune journalisation des erreurs n'est 187 effectu�e. Si elle est d�finie, toute erreur CGI sera enregistr�e 188 dans le fichier dont le nom est fourni en argument. S'il s'agit d'un 189 chemin de fichier relatif, il est consid�r� par rapport au 190 r�pertoire d�fini par la directive <code class="directive"><a href="/mod/core.html#serverroot">ServerRoot</a></code>. 191 </p> 192 193 <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">ScriptLog logs/cgi_log</pre> 194</div> 195 196 <p>Ce journal sera ouvert par l'utilisateur sous lequel les 197 processus enfants s'ex�cutent, c'est � dire l'utilisateur sp�cifi� 198 par la directive du serveur <code class="directive"><a href="/mod/mod_unixd.html#user">User</a></code>. Ceci implique que le 199 r�pertoire dans lequel se trouve le journal doit �tre accessible en 200 �criture pour cet utilisateur, ou bien que le fichier est cr�� 201 manuellement et accessible en �criture pour cet utilisateur. Si vous 202 placez le journal du script dans votre r�pertoire principal des 203 journaux, ne modifiez <strong>JAMAIS</strong> les permissions de ce 204 dernier afin de le le rendre accessible en �criture par 205 l'utilisateur sous lequel les processus enfants s'ex�cutent.</p> 206 207 <p>Notez que l'on ne doit activer la journalisation des scripts 208 qu'� des fins de d�bogage lors de l'�criture de scripts CGI, et non 209 de mani�re permanente sur un serveur en production. Elle n'est pas 210 optimis�e en terme de performances et d'efficacit�, et peut 211 pr�senter des probl�mes de s�curit� si on l'utilise dans un cadre 212 autre que celui pour lequel elle a �t� con�ue.</p> 213 214</div> 215<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 216<div class="directive-section"><h2><a name="ScriptLogBuffer" id="ScriptLogBuffer">ScriptLogBuffer</a> <a name="scriptlogbuffer" id="scriptlogbuffer">Directive</a></h2> 217<table class="directive"> 218<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille maximale des requ�tes PUT ou POST qui seront 219enregistr�es dans le journal du script</td></tr> 220<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptLogBuffer <var>octets</var></code></td></tr> 221<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ScriptLogBuffer 1024</code></td></tr> 222<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 223<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 224<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code>, <code class="module"><a href="/mod/mod_cgid.html">mod_cgid</a></code></td></tr> 225</table> 226 <p>Cette directive permet de limiter la taille du corps de toute 227 entit� PUT ou POST qui sera enregistr�e dans le journal, afin 228 de pr�venir une croissance trop importante et trop rapide du fichier 229 journal due � la r�ception de corps de requ�te de grandes tailles. 230 Cette directive permet de modifier cette taille maximale, dont la 231 valeur par d�faut est de 1024 octets.</p> 232 233</div> 234<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 235<div class="directive-section"><h2><a name="ScriptLogLength" id="ScriptLogLength">ScriptLogLength</a> <a name="scriptloglength" id="scriptloglength">Directive</a></h2> 236<table class="directive"> 237<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille maximale du fichier journal des scripts 238CGI</td></tr> 239<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptLogLength <var>octets</var></code></td></tr> 240<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ScriptLogLength 10385760</code></td></tr> 241<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 242<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 243<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code>, <code class="module"><a href="/mod/mod_cgid.html">mod_cgid</a></code></td></tr> 244</table> 245 <p>La directive <code class="directive">ScriptLogLength</code> permet de 246 d�finir la taille maximale du fichier journal des scripts CGI. Comme 247 le fichier journal accumule une grande quantit� d'informations par 248 erreur CGI (tous les en-t�tes de la requ�te, toutes les sorties du 249 script), il peut vite atteindre une grande taille. En limitant la 250 taille du fichier, cette directive permet d'�viter les probl�mes que 251 causerait sa croissance sans limites. Lorsque le fichier a atteint 252 cette taille maximale, plus aucune information n'y est 253 enregistr�e.</p> 254 255</div> 256</div> 257<div class="bottomlang"> 258<p><span>Langues Disponibles: </span><a href="/en/mod/mod_cgi.html" hreflang="en" rel="alternate" title="English"> en </a> | 259<a href="/fr/mod/mod_cgi.html" title="Fran�ais"> fr </a> | 260<a href="/ja/mod/mod_cgi.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 261<a href="/ko/mod/mod_cgi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> 262</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />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 <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> 263<script type="text/javascript"><!--//--><![CDATA[//><!-- 264var comments_shortname = 'httpd'; 265var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_cgi.html'; 266(function(w, d) { 267 if (w.location.hostname.toLowerCase() == "httpd.apache.org") { 268 d.write('<div id="comments_thread"><\/div>'); 269 var s = d.createElement('script'); 270 s.type = 'text/javascript'; 271 s.async = true; 272 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; 273 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); 274 } 275 else { 276 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); 277 } 278})(window, document); 279//--><!]]></script></div><div id="footer"> 280<p class="apache">Copyright 2014 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> 281<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- 282if (typeof(prettyPrint) !== 'undefined') { 283 prettyPrint(); 284} 285//--><!]]></script> 286</body></html>