diff options
Diffstat (limited to 'usr.sbin/httpd/htdocs/manual/mod/core.html.fr')
| -rw-r--r-- | usr.sbin/httpd/htdocs/manual/mod/core.html.fr | 4115 |
1 files changed, 0 insertions, 4115 deletions
diff --git a/usr.sbin/httpd/htdocs/manual/mod/core.html.fr b/usr.sbin/httpd/htdocs/manual/mod/core.html.fr deleted file mode 100644 index 9ad34f43d6b..00000000000 --- a/usr.sbin/httpd/htdocs/manual/mod/core.html.fr +++ /dev/null @@ -1,4115 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<!--Traduction anglais 1.190 --> - -<html xmlns="http://www.w3.org/1999/xhtml"> - <head> - <meta name="generator" content="HTML Tidy, see www.w3.org" /> - <meta http-equiv="Content-Type" - content="text/html; charset=iso-8859-1" /> - - <title>Noyau d'Apache</title> - </head> - <!-- Background white, links blue (unvisited), navy (visited), red (active) --> - - <body bgcolor="#FFFFFF" text="#000000" link="#0000FF" - vlink="#000080" alink="#FF0000"> - <div align="CENTER"> - <img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]" /> - - <h3>Apache HTTP Server Version 1.3</h3> - </div> - - - <h1 align="center">Noyau d'Apache</h1> - - <p>Ces paramètres de configuration contrôlent les - fonctionnalités premières d'Apache, et sont - toujours disponibles.</p> - - <h2>Directives</h2> - - <ul> - <li><a href="#acceptfilter">AcceptFilter</a></li> - - <li><a href="#accessconfig">AccessConfig</a></li> - - <li><a href="#accessfilename">AccessFileName</a></li> - - <li><a href="#adddefaultcharset">AddDefaultCharset</a></li> - - <li><a href="#addmodule">AddModule</a></li> - - <li><a href="#allowoverride">AllowOverride</a></li> - - <li><a href="#authname">AuthName</a></li> - - <li><a href="#authtype">AuthType</a></li> - - <li><a href="#bindaddress">BindAddress</a></li> - - <li><a href="#bs2000account">BS2000Account</a></li> - - <li><a href="#clearmodulelist">ClearModuleList</a></li> - - <li><a href="#contentdigest">ContentDigest</a></li> - - <li><a href="#coredumpdirectory">CoreDumpDirectory</a></li> - - <li><a href="#defaulttype">DefaultType</a></li> - - <li><a href="#directory"><Directory></a></li> - - <li><a href="#directorymatch"><DirectoryMatch></a></li> - - <li><a href="#documentroot">DocumentRoot</a></li> - - <li><a href="#ebcdicconvert">EBCDICConvert</a></li> - - <li><a - href="#ebcdicconvertbytype">EBCDICConvertByType</a></li> - - <li><a href="#ebcdickludge">EBCDICKludge</a></li> - - <li><a href="#errordocument">ErrorDocument</a></li> - - <li><a href="#errorlog">ErrorLog</a></li> - - <li><a href="#files"><Files></a></li> - - <li><a href="#filesmatch"><FilesMatch></a></li> - - <li><a href="#group">Group</a></li> - - <li><a href="#hostnamelookups">HostNameLookups</a></li> - - <li><a href="#identitycheck">IdentityCheck</a></li> - - <li><a href="#ifdefine"><IfDefine></a></li> - - <li><a href="#ifmodule"><IfModule></a></li> - - <li><a href="#include">Include</a></li> - - <li><a href="#keepalive">KeepAlive</a></li> - - <li><a href="#keepalivetimeout">KeepAliveTimeout</a></li> - - <li><a href="#limit"><Limit></a></li> - - <li><a href="#limitexcept"><LimitExcept></a></li> - - <li><a href="#limitrequestbody">LimitRequestBody</a></li> - - <li><a href="#limitrequestfields">LimitRequestFields</a></li> - - <li><a - href="#limitrequestfieldsize">LimitRequestFieldsize</a></li> - - <li><a href="#limitrequestline">LimitRequestLine</a></li> - - <li><a href="#listen">Listen</a></li> - - <li><a href="#listenbacklog">ListenBacklog</a></li> - - <li><a href="#location"><Location></a></li> - - <li><a href="#locationmatch"><LocationMatch></a></li> - - <li><a href="#lockfile">LockFile</a></li> - - <li><a href="#loglevel">LogLevel</a></li> - - <li><a href="#maxclients">MaxClients</a></li> - - <li><a - href="#maxkeepaliverequests">MaxKeepAliveRequests</a></li> - - <li><a - href="#maxrequestsperchild">MaxRequestsPerChild</a></li> - - <li><a href="#maxspareservers">MaxSpareServers</a></li> - - <li><a href="#minspareservers">MinSpareServers</a></li> - - <li><a href="#namevirtualhost">NameVirtualHost</a></li> - - <li><a href="#options">Options</a></li> - - <li><a href="#pidfile">PidFile</a></li> - - <li><a href="#port">Port</a></li> - - <li><a href="#require">require</a></li> - - <li><a href="#resourceconfig">ResourceConfig</a></li> - - <li><a href="#rlimitcpu">RLimitCPU</a></li> - - <li><a href="#rlimitmem">RLimitMEM</a></li> - - <li><a href="#rlimitnproc">RLimitNPROC</a></li> - - <li><a href="#satisfy">Satisfy</a></li> - - <li><a href="#scoreboardfile">ScoreBoardFile</a></li> - - <li><a - href="#scriptinterpretersource">ScriptInterpreterSource</a></li> - - <li><a href="#sendbuffersize">SendBufferSize</a></li> - - <li><a href="#serveradmin">ServerAdmin</a></li> - - <li><a href="#serveralias">ServerAlias</a></li> - - <li><a href="#servername">ServerName</a></li> - - <li><a href="#serverpath">ServerPath</a></li> - - <li><a href="#serverroot">ServerRoot</a></li> - - <li><a href="#serversignature">ServerSignature</a></li> - - <li><a href="#servertokens">ServerTokens</a></li> - - <li><a href="#servertype">ServerType</a></li> - - <li><a href="#startservers">StartServers</a></li> - - <li><a href="#threadsperchild">ThreadsPerChild</a></li> - - <li><a href="#threadstacksize">ThreadStackSize</a></li> - - <li><a href="#timeout">TimeOut</a></li> - - <li><a href="#usecanonicalname">UseCanonicalName</a></li> - - <li><a href="#user">User</a></li> - - <li><a href="#virtualhost"><VirtualHost></a></li> - </ul> - - <h2><a id="acceptfilter" name="acceptfilter">Directive - AcceptFilter</a></h2> - <!--%plaintext <?INDEX {\tt AcceptFilter} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> AcceptFilter on|off<br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>AccceptFilter on</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> server configt<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> core - - <p><code>AcceptFilter</code> contrôle une optimisation - spécifique à BSD. Elle est compilée par - défaut et activée par défaut si votre - système l'implémente (option SO_ACCCEPTFILTER de - setsocketopt()). A l'heure actuelle, seul FreeBSD - l'implémente.</p> - - <p>Se référer à la section concernant les - filtres dans la <a href="../misc/perf-bsd44.html">documentation - sur la performance</a> pour de plus amples informations.</p> - - <p>L'option de compilation <code>AP_ACCEPTFILTER_OFF</code> - peut être utilisée pour changer le défaut - à 'off'. <code>httpd -V</code> et <code>httpd -L</code> - affichent dorénavant les valeurs par défauts au - moment de la compilation, et si oui ou non SO_ACCEPTFILTER a - été défini pour cette compilation.</p> - <hr /> - <!-- XXX translate a name="accessconfig" / Directive AccessConfig - --> - - <h2><a id="accessconfig" name="accessconfig">Directive - AccessConfig</a></h2> - <!--%plaintext <?INDEX {\tt AccessConfig} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> AccessConfig - <em>nomfichier|nomrépertoire</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>AccessConfig conf/access.conf</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Context:</strong></a> configuration serveur, - hôtes virtuels<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>Le serveur lit dans ce fichier des directives - supplémentaires après avoir ouvert le fichier <a - href="#resourceconfig">ResourceConfig</a>. <em>nomfichier</em> - est exprimé relativement à <a - href="#serverroot">ServerRoot</a>. Cette fonctionnalité - peut être désactivée en écrivant - :</p> - - <blockquote> - <code>AccessConfig /dev/null</code> - </blockquote> - ou sur les serverus Win32 - - <blockquote> - <code>AccessConfig nul</code> - </blockquote> - - <p>Historiquement, ce fichier ne contenait que des sections <a - href="#directory"><Directory></a>; en fait, il pourra - maintenant contenir toute directive "serveur" autorisée - dans le contexte de la <em>configuration serveur</em>.</p> - - <p>Une nouveauté de la version d'Apache 1.3.13 est la - possibilité qu'<code>AccessConfig</code> - représente un répertoire plutot qu'un fichier. - Apache lira tous les fichiers de ce répertoire ainsi que - tous les sous-répertoires et analysera tous ces fichiers - de configuration.</p> - - <p>Voir également <a - href="#resourceconfig">ResourceConfig</a>.</p> - <hr /> - - <h2><a id="accessfilename" name="accessfilename">Directive - AccessFileName</a></h2> - <!--%plaintext <?INDEX {\tt AccessFileName} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> AccessFileName <em>nomfichier</em> - [<em>nomfichier</em>] ...<br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>AccessFileName .htaccess</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Context:</strong></a> configuration serveur, - hôte virtuel<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - AccessFileName ne peut accepter plusieurs noms de fichiers - qu'à partir de la version 1.3 d'Apache - - <p>Lorsqu'il retourne un document au client, le serveur cherche - le premier fichier de contrôle d'accès existant - dans cette liste dans chacun des répertoires inscrit - dans le chemin d'accès menant au document, pour - déterminer si l'accès est autorisé dan - chacun de ces répertoires. Par exemple:</p> - - <blockquote> - <code>AccessFileName .acl</code> - </blockquote> - - <p>Avant de servir le document - <code>/usr/local/web/index.html</code>, le serveur lira les - fichiers <code>/.acl</code>, <code>/usr/.acl</code>, - <code>/usr/local/.acl</code> et - <code>/usr/local/web/.acl</code> à la recherche de - directives, sauf si celles-ci ont été - désactivées par l'écriture</p> - - <blockquote> - <code><Directory /> AllowOverride None - </Directory></code> - </blockquote> - - <p><strong>Voir également :</strong> <a - href="#allowoverride">AllowOverride</a></p> - <hr /> - - <h2><a id="adddefaultcharset" - name="adddefaultcharset">Directive AddDefaultCharset</a></h2> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> AddDefaultCharset On|Off|<em>charset</em><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> tous<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>AddDefaultCharset Off</code><br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - AddDefaultCharset n'est disponible qu'à partir de la - version 1.3.12 - - <p>Cette directive spécifie le nom de la table de - caractères qui sera ajouté à toutes les - réponses qui n'ont aucun paramètre sur le type de - contenu dans l'en-tête HTTP. Elle remplace la table de - caractère spécifié dans le corps du - document par l'utilisation du marqueur <code>META</code>. La - mise de <code>AddDefaultCharset Off</code> désactive - cette fonctionnalité. <code>AddDefaultCharset On</code> - active la table de caractère <code>iso-8859-1</code> par - défaut d'Apache. Vous pouvez également - définir une autre table de caractères à - employer. Par exemple <code>AddDefaultCharset utf-8</code>.</p> - <hr /> - - <h2><a id="addmodule" name="addmodule">Directive - AddModule</a></h2> - <!--%plaintext <?INDEX {\tt AddModule} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> AddModule <em>module</em> [<em>module</em>] - ...<br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur <br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - <tt>AddModule</tt> n'est disponible qu'à partir de la - version 1.2 d'Apache - - <p>Le serveur peut intégrer des modules compilés - qui ne sont pas mis en service. Cette directive peut être - utilisée pour activer ou désactiver ces modules. - Le serveur est installé avec une liste - pré-configurée de modules actifs cette liste peut - être effacée par la directive <a - href="#clearmodulelist">ClearModuleList</a>.</p> - <hr /> - - <h2><a id="allowoverride" name="allowoverride">Directive - AllowOverride</a></h2> - <!--%plaintext <?INDEX {\tt AllowOverride} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> AllowOverride All|None|<em>type de - directive</em> [<em>type de directive</em>] ... <br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>AllowOverride All All</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> - répertoire<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>Lorsque le serveur trouve un fichier .htaccess (comme - spécifié par <a - href="#accessfilename">AccessFileName</a>) il doit savoir - quelles directives declarées dans ce fichier peuvent - outrepasser les droits fixés par des directives - précédentes.</p> - - <p>Si la directive est définie à - <code>None</code>, les fichier .htaccess sont ignorés. - Dans ce cas, le serveur n'essaie même pas de lire les - fichiers .htaccess.</p> - - <p>Si la directive est définie à <code>All</code> - toutes les directives possibles dans le <a - href="directive-dict.html#Context">contexte</a> .htacces sont - autorisées dans les fichiers .htaccess.</p> - - <p>Les <em>types de directives</em> peuvent être parmi - ces groupes de directives :</p> - - <dl> - <dt>AuthConfig</dt> - - <dd> - <!--%plaintext <?INDEX {\tt AuthConfig} override> --> - Autorise l'usage de la directive Authorization (<a - href="mod_auth_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a>, - <a - href="mod_auth_dbm.html#authdbmuserfile">AuthDBMUserFile</a>, - <a href="mod_auth.html#authgroupfile">AuthGroupFile</a>, <a - href="#authname">AuthName</a>, <a - href="#authtype">AuthType</a>, <a - href="mod_auth.html#authuserfile">AuthUserFile</a>, <a - href="#require">Require</a>, etc.).</dd> - - <dt>FileInfo</dt> - - <dd><!--%plaintext <?INDEX {\tt FileInfo} override> --> - Autorise l'usage de directives contrôlant - l'accès aux types de documents (<a - href="mod_mime.html#addencoding">AddEncoding</a>, <a - href="mod_mime.html#addlanguage">AddLanguage</a>, <a - href="mod_mime.html#addtype">AddType</a>, <a - href="#defaulttype">DefaultType</a>, <a - href="#errordocument">ErrorDocument</a>, <a - href="mod_negotiation.html#languagepriority">LanguagePriority</a>, - etc.).</dd> - - <dt>Indexes</dt> - - <dd><!--%plaintext <?INDEX {\tt Indexes} override> --> - Autorise l'usage de directives contrôlant l'indexation - des répertoires (<a - href="mod_autoindex.html#adddescription">AddDescription</a>, - <a href="mod_autoindex.html#addicon">AddIcon</a>, <a - href="mod_autoindex.html#addiconbyencoding">AddIconByEncoding</a>, - <a href="mod_autoindex.html#addiconbytype">AddIconByType</a>, - <a href="mod_autoindex.html#defaulticon">DefaultIcon</a>, <a - href="mod_dir.html#directoryindex">DirectoryIndex</a>, <a - href="mod_autoindex.html#fancyindexing">FancyIndexing</a>, <a - href="mod_autoindex.html#headername">HeaderName</a>, <a - href="mod_autoindex.html#indexignore">IndexIgnore</a>, <a - href="mod_autoindex.html#indexoptions">IndexOptions</a>, <a - href="mod_autoindex.html#readmename">ReadmeName</a>, - etc.).</dd> - - <dt>Limit</dt> - - <dd><!--%plaintext <?INDEX {\tt Limit} override> --> - Autorise l'usage de directives contrôlant les - accès de certains hôtes (allow, deny et - order).</dd> - - <dt>Options</dt> - - <dd><!--%plaintext <?INDEX {\tt Options} override> --> - Autorise l'usage de directives contrôlant certaines - fonctionnalités spécifiques des - répertoires (<a href="#options">Options</a> et <a - href="mod_include.html#xbithack">XBitHack</a>).</dd> - </dl> - - <p><strong>Voir également :</strong> <a - href="#accessfilename">AccessFileName</a></p> - <hr /> - - <h2><a id="authname" name="authname">Directive - AuthName</a></h2> - <!--%plaintext <?INDEX {\tt AuthName} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> AuthName <em>domaine-autorisé</em><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> répertoire, - .htaccess<br /> - <a href="directive-dict.html#Override" - rel="Help"><strong>Surcharge :</strong></a> AuthConfig<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>Cette directive indique le nom du schéma - d'autorisation pour un répertoire. Ce schéma sera - donné au client de sorte que l'utilisateur sache quel - nom et quel mot de passe envoyer. <samp>AuthName</samp> prend - un seul argument. Si le schéma d'autorisation contient - des espaces, il doit être entouré de guillemets. - Pour fonctionner correctement, elle devra être - accompagnée des directives <a - href="#authtype">AuthType</a> et <a - href="#require">require</a>, et de directives telles que <a - href="mod_auth.html#authuserfile">AuthUserFile</a> et <a - href="mod_auth.html#authgroupfile">AuthGroupFile</a>.</p> - <hr /> - - <h2><a id="authtype" name="authtype">Directive - AuthType</a></h2> - <!--%plaintext <?INDEX {\tt AuthType} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> AuthType <em>type</em><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> répertoire, - .htaccess<br /> - <a href="directive-dict.html#Override" - rel="Help"><strong>Surcharge :</strong></a> AuthConfig<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>Cette directive selectionne le type d'authentification pour - un répertoire. Seul les types <code>Basic</code> et - <code>Digest</code> sont actuellement - implémentés. - <!--%plaintext <?INDEX {\tt Basic} authentication scheme> --> - Pour fonctionner correctement, elle devra être - accompagnée des directives <a - href="#authname">AuthName</a> et <a - href="#require">require</a>, et de directives telles que <a - href="mod_auth.html#authuserfile">AuthUserFile</a> et <a - href="mod_auth.html#authgroupfile">AuthGroupFile</a>.</p> - <hr /> - - <h2><a id="bindaddress" name="bindaddress">Directive - BindAddress</a></h2> - <!--%plaintext <?INDEX {\tt BindAddress} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> BindAddress *|<em>addresse IP</em>|<em>nom de - domaine</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>BindAddress *</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>Un serveur http sous Unix® peut soit écouter - toutes les adresses IP de la machine sur lequel il est - exécuté, ou uniquement une de ces adresses. Si - l'argument de cette directive est *, le serveur traitera les - connections sur toutes les adresses IP. Sinon, le serveur peut - écouter à partir d'une <em>adresse IP</em> - spécifique ou d'un <em>nom de domaine</em> Internet.</p> - - <p>Une et une seule directive <tt>BindAddress</tt> peut - être utilisée. Pour contrôler plus finement - quels ports et adresses Apache écoute, utilisez la - directive <a href="#listen">Listen</a> au lieu de - <tt>BindAddress</tt>.</p> - - <p><tt>BindAddress</tt> peut être utilisée comme - alternative à l'implantation d'<a - href="../vhosts/">hôtes virtuels</a> utilisant des - serveurs multiples indépendants, soit au lieu d'utiliser - les sections <a - href="#virtualhost"><VirtualHost></a>.</p> - - <p><strong>Voir aussi:</strong> <a - href="../dns-caveats.html">Apache et DNS</a><br /> - <strong>Voir aussi:</strong> <a href="../bind.html">Configurer - les ports et adresses utilisés par Apache</a></p> - <hr /> - - <h2><a id="bs2000account" name="bs2000account">BS2000Account - directive</a></h2> - <!--%plaintext <?INDEX {\tt BS2000Account} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> BS2000Account <em>account</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <em>none</em><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - BS2000Account n'est valable que pour les machines BS2000, - à partir de la version 1.3 d'Apache. - - <p>La directive <code>BS2000Account</code> n'est disponible que - pour les machines BS2000. Elle doit être employée - pour définir le numéro de compte pour - l'utilisateur non privilégié (qui est - défini par la directive <a href="#user">User</a> ). Ceci - est requis par le sous système POSIX du BS2000 afin de - changer l'environnement d'exécution sosu jacent du BS200 - en effectuant une sous connexion, et éviter ainsi que - des scripts CGI puissent accéder à des ressources - accessible à l'utilisateur privilégié - utilisé pour lancer le serveur, - généralement <samp>SYSROOT</samp>.<br /> - Seulement une directive <code>BS2000Account</code> peut - être utilisée.</p> - - <p><strong>Voir également:</strong> <a - href="../ebcdic.html">Portage EBCDIC d'Apache</a></p> - <hr /> - - <h2><a id="clearmodulelist" name="clearmodulelist">Directive - ClearModuleList</a></h2> - <!--%plaintext <?INDEX {\tt ClearModuleList} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> ClearModuleList<br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - <tt>ClearModuleList</tt> n'est disponible qu'à partir de - la version 1.2 d'Apache - - <p>Le serveur dispose à l'installation d'une liste - pré-configurée de modules actifs. Cette directive - efface cette liste. Il est supposé que cette liste sera - reconstruite à partir de directives <a - href="#addmodule">AddModule</a>.</p> - <hr /> - - <h2><a id="contentdigest" name="contentdigest">Directive - ContentDigest</a></h2> - <!--%plaintext <?INDEX {\tt ContentDigest} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> ContentDigest <em>on|off</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>ContentDigest off</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôtes virtuels, répertoire, - .htaccess<br /> - <a href="directive-dict.html#Override" - rel="Help"><strong>Surcharge :</strong></a> Options<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> expérimental - - <p><a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - ContentDigest n'est disponible qu'à partir de la version - 1.1 d'Apache</p> - - <p>Cette directive active la génération - d'en-têtes <code>Content-MD5</code> conformes aux RFC1864 - et RFC2068.</p> - - <p>MD5 est un algorithme permettant d'extraire un - "résumé" à partir d'un bloc de - données de longueur arbitraire, avec un degré de - confiance suffisant dans la mesure ou une moindre - altération dans les données sera - reflétée par un changement dans le - "résumé".</p> - - <p>L'en-tête <code>Content-MD5</code> procure un test de - l'intégrité de message de bout en bout (MIC) sur - le corps d'entité. Un proxy ou client pourra tester cet - en-tête pour détecter des modifications - accidentelles du corps d'entité en cours de transfert. - Exemple d'en-tête:</p> -<pre> - Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA== - -</pre> - - <p>Notez que ceci peut réduire les performances de votre - serveur dans la mesure où le "résumé" est - calculé à chaque requête (il ne peut - être mis en cache).</p> - - <p><code>Content-MD5</code> n'est émis que pour des - documents servis par le noyau, et à l'exception de tout - module. Par exemple, les documents SSI, la sortie de scripts - CGI, et des réponses en flux d'octet binaire ne pourront - utiliser cet en-tête.</p> - <hr /> - - <h2><a id="coredumpdirectory" - name="coredumpdirectory">Directive CoreDumpDirectory</a></h2> - <!--%plaintext <?INDEX {\tt CoreDumpDirectory} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> CoreDumpDirectory - <em>nomrépertoire</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> même - répertoire que ServerRoot<br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>Elle définit le répertoire auquel Apache tente - d'accéder avant d'enregistrer un "noyau dump". Par - défaut, il s'agit du répertoire <a - href="#serverroot">ServerRoot</a>, cependant, si ce - répertoire n'est pas accessible en écriture par - l'utilisateur sous lequel tourne le serveur, le "noyau dump" ne - pourra être généré. Si vous - souhaitez dans ce cas obtenir un "noyau dump" pour des - nécessités de débogage, vous pouvez - utiliser cette directive pour spécifier un autre - répertoire dans lequel vous avez toute autorisation pour - écrire.</p> - <hr /> - - <h2><a id="defaulttype" name="defaulttype">Directive - DefaultType</a></h2> - <!--%plaintext <?INDEX {\tt DefaultType} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> DefaultType <em>mime-type</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>DefaultType text/html</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôtes virtuels, répertoire, - .htaccess<br /> - <a href="directive-dict.html#Override" - rel="Help"><strong>Surcharge :</strong></a> FileInfo<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>Il peut arriver qu'une requête demande au serveur un - document dont le type ne peut être - déterminé par les tables de MIME.</p> - - <p>Le serveur doit informer le client du type de contenu - (Content-type) du document. Dans le cas d'un type inconnu, il - utilisera le <tt>DefaultType</tt>. Par exemple :</p> - - <blockquote> - <code>DefaultType image/gif</code> - </blockquote> - - <p>sera approprié dans un répertoire contenant - une majorité d'images gif dont certaines ne - présentent pas explicitement l'extension .gif.</p> - <hr /> - - <h2><a id="directory" name="directory">Directive - <Directory></a></h2> - <!--%plaintext <?INDEX {\tt Directory} section directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> <Directory <em>nomrépertoire</em>> - ... </Directory> <br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôtes virtuels<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p><tt><Directory></tt> et <tt></Directory></tt> - sont utilisés pour "encapsuler" un groupe de directives - applicables uniquement au réprtoire indiqué ainsi - qu'à ses sous-répertoires. Toute directive - autorisée dans un contexte de répertoire peut - apparaître entre ces deux balises. - <em>nomrépertoire</em> est soit le chemin - entièrement qualifié du répertoire, ou un - motif. Dans un motif, '?' remplace un caractère unique - quelconque, et '*' remplace toute séquence de - zéro ou plus caractères quelconques. Sur Apache - 1.3, vous pouvez aussi utiliser les plages de caractères - '[]' comme dans un shell UNIX. De plus aucun des - métacaractères ne peut remplacer un '/', ce qui - correspond plus intimement à la réaction des - shells UNIX. Exemple:</p> -<pre> - <Directory /usr/local/httpd/htdocs> - Options Indexes FollowSymLinks - </Directory> -</pre> - - <p><strong>A partir d'Apache 1.2 :</strong> peuvent être - utilisées les "expressions régulières", - lesquelles devront être précédées du - caractère <code>~</code>. Par exemple :</p> -<pre> - <Directory ~"^/www/.*/[0-9]{3}"> -</pre> - correspondrait à des répertoires dans /www/ dont - le nom serait constitué de trois digits. - - <p>Si plusieurs sections de répertoires pointent sur le - répertoire d'un document (ou l'un de ses pères) - sans qu'il s'agisse d'une expression régulière, - alors les directives sont appliquées selon la loi de "la - plus courte qualification d'abord", combinées aux - directives des fichiers <a - href="#accessfilename">.htaccess</a>. Par exemple, avec - l'écriture</p> - - <blockquote> - <code><Directory /> AllowOverride None - </Directory> <Directory /home/*> AllowOverride - FileInfo </Directory></code> - </blockquote> - - <p>pour le contrôle d'accès au document - <code>/home/web/dir/doc.html</code> les étapes - d'évaluation sont les suivantes :</p> - - <ul> - <li>Applique la directive <code>AllowOverride None</code> - (désactivant les fichiers - <code>.htaccess</code>).</li> - - <li>Appliquela directive <code>AllowOverride FileInfo</code> - (pour le répertoire <code>/home/web</code>).</li> - - <li>Applique toutes les directives <tt>FileInfo</tt> de - <code>/home/web/.htaccess</code></li> - </ul> - - <p>Les sections exprimant des répertoires sous forme - d'expressions régulières sont gérés - légèrement différemment par Apache 1.2 et - 1.3. Sous Apache 1.2, elles sont combinées aux sections - "normales" et s'appliquent dans l'ordre où elles - apparaissent dans le fichier de configuration. Elles ne - s'appliquent qu'une fois, seulement pour celles qui font partie - de la section "à plus courte correspondance". Sous - Apache 1.3 les sections basées sur des expressions - régulières ne sont pas évaluées - tant que toutes les sections "normales" n'ont pas - été considérées. A ce moment, les - sections "régulières" sont traitées dans - l'ordre où elles apparaissent dans le fichier de - configuration. Par exemple, avec l'écriture</p> - - <blockquote> - <code><Directory ~ abc$> ... directives ici ... - </Directory></code> - </blockquote> - - <p>Supposez que le nom de fichier demandé soit - <code>/home/abc/public_html/abc/index.html</code>. Le serveur - considère chacune des sections <code>/</code>, - <code>/home</code>, <code>/home/abc</code>, - <code>/home/abc/public_html</code>, et - <code>/home/abc/public_html/abc</code> dans cet ordre. Sous - Apache 1.2, lorsque <code>/home/abc</code> est pris en compte, - l'expression régulière correspondra et ses termes - seront appliqués. Sous Apache 1.3 l'expression - régulière n'est pas considérée du - tout à ce point de l'arbre. Elle ne le sera pas tant que - toutes les sections "normales" <tt><Directory>s</tt> et - celles des fichiers <code>.htaccess</code> n'ont pas - été appliquées. A ce moment seulement - l'expression régulière reconnaîtra - <code>/home/abc/public_html/abc</code> et les directives seront - appliquées.</p> - - <p><strong>Notez que l'accès par défaut d'Apache - pour les sections <tt><Directory></tt> est <code>Allow - from All</code>. Ceci veut dire que par défaut, Apache - desservira tout fichier indiqué par une URL. Nous - recommandons de modifier ceci à l'aide d'un bloc tel - que</strong></p> -<pre> - <Directory /> - Order Deny,Allow - Deny from All -</Directory> -</pre> - - <p><strong>puis désactiver sélectivement la - protection pour les répertoires devant rester - accessibles. Voir la page <a - href="../misc/security_tips.html">Trucs sur la - sécurité</a> pour plus de - détails.</strong></p> - - <p>Les sections de répertoires apparaissent - habituellement dans le fichier access.conf, mais peuvent - être présentes dans n'importe quel fichier de - configuration. Les directives <Directory> ne peuvent - être imbriquées, et ne peuvent petre incluses dans - des sections <a href="#limit"><Limit></a> ou <a - href="#limitexcept"><LimitExcept></a>.</p> - - <p><strong>Voir aussi</strong> : <a - href="../sections.html">Comment fonctionnent les sections - concernant les répertoires, chemins et fichiers</a> pour - une explication plus précise concernant la - manière dont ces sections sont combinées - lorsqu'une requête est traitée.</p> - <hr /> - - <h2><a id="directorymatch" name="directorymatch">Directive - <DirectoryMatch></a></h2> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> <DirectoryMatch <em>regex</em>> ... - </DirectoryMatch><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôtes virtuels<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> Core<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - Disponible à partir de la version 1.3 d'Apache - - <p><tt><DirectoryMatch></tt> et - <tt></DirectoryMatch></tt> sont utilisés pour - encapsuler un groupe de directives s'appliquant uniquement aux - répertoires nommés et ses - sous-répertoires, de manière identique à - la directive <a href="#directory"><Directory></a>. - Cependant, elle n'accepte comme argument qu'une expression - régulière. Par exemple :</p> - - <blockquote> - <code><DirectoryMatch "^/www/.*/[0-9]{3}"></code> - </blockquote> - - <p>correspondrait aux répertoires de /www/ dont le nom - consiste en trois chiffres.</p> - - <p><strong>Voir aussi :</strong> <a - href="#directory"><Directory></a> pour une description de - la manière dont les définitions par expression - régulière sont combinées aux sections - <tt><Directory></tt> "normales".<br /> - <strong>Voir aussi</strong> : <a - href="../sections.html">Comment fonctionnent les sections - concernant les répertoires, chemins et fichiers</a> pour - une explication plus précise concernant la - manière dont ces sections sont combinées - lorsqu'une requête est traitée</p> - <hr /> - - <h2><a id="documentroot" name="documentroot">Directive - DocumentRoot</a></h2> - <!--%plaintext <?INDEX {\tt DocumentRoot} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> DocumentRoot <em>directory-filename</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>DocumentRoot /usr/local/apache/htdocs</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôtes virtuels<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>Cette directive définit le répertoire racine - à partir duquel httpd va distribuer les fichiers. Sauf - si le répertoire est pointé par une directive - telle que Alias, le serveur ajoute le chemin relatif - mentionnée dans l'URL présentée à - cette racine pour établir le chemin complet jusqu'au - document. Exemple :</p> - - <blockquote> - <code>DocumentRoot /usr/web</code> - </blockquote> - - <p>Un accès à - <code>http://www.my.host.com/index.html</code> se - réferre au document - <code>/usr/web/index.html</code>.</p> - - <p>Un bogue existe pour cette directive mod_dir, laquelle - fonctionne mal lorsque DocumentRoot est donnée avec un - '/' final (c-à-d. "DocumentRoot /usr/web/"). Il vaut - mieux éviter cette écriture.</p> - <hr /> - - <h2><a id="ebcdicconvert" - name="ebcdicconvert">EBCDICConvert</a></h2> - <!--%plaintext <?INDEX {\tt EBCDICConvert} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> EBCDICConvert On|Off[=<em>direction</em>] - <em>extension</em> [<em>extension</em>] ...<br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôte virtuel, répertoire, .htaccess<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Override" - rel="Help"><strong>Surcharge :</strong></a> FileInfo<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> la - conversion EBCDIC est disponible à partir de la version - 1.3.19 d'Apache sur les plate-formes basées sur EBCDIC. - - <p>La directive EBCDICConvert associe une extension de fichier - à une possible conversion (<samp>On</samp> ou - <samp>Off</samp>). Les extensions de fichiers peuvent commencer - ou non par un point.</p> - - <p>Si le format optionnel <samp>On=<i>direction</i></samp> (or - <samp>Off=<i>direction</i></samp>) est employé, - où <i>direction</i> est choisi parmi <samp>In</samp>, - <samp>Out</samp> ou <samp>InOut</samp>, alors la directive ne - s'applique seulement que dans une direction de transfert - donnée (<samp>In</samp> : contenu reçu par une - requête PUT ou POST , <samp>Out</samp> : contenu - renvoyé à une requete GET ou POST, et - <samp>InOut</samp> : conversion dans les deux - directions).<br /> - Sinon, <samp>InOut</samp> (conversion dans les deux - directions) est défini.</p> - - <p>La configuration de conversion basé sur un type de - fichier est testé avant la configuration basé sur - les types MIME, afin de permettre aux règles - génériques MIME d'être surchargées - par une extension spécifique (pplusieurs extensions de - fichier peuvent exister pour le même type MIME).</p> - - <p><strong>Exemple</strong>:<br /> - Avec la configuration suivante, les fichiers - <samp>*.html</samp> contiennent du texte HTML au format EBCDIC, - tandis que les fichiers <samp>*.ahtml</samp> contiennent du - texte HTML au format ASCII :</p> -<pre> - # *.html et *.ahtml contiennet du texte HTML : - AddType text/html .html .ahtml - - # *.ahtml n'est pas converti (il contient déjà du texte ASCII) - EBCDICConvert Off .ahtml - - # Les autres fichiers text/html contiennent du texte EBCDIC: - EBCDICConvertByType On text/html -</pre> - <br /> - <br /> - - - <p><strong>Voir également</strong>: <a - href="#ebcdicconvertbytype">EBCDICConvertByType</a> et <a - href="../ebcdic.html#ebcdic">Aperçu des fonctions de - conversion EBCDIC</a></p> - <hr /> - - <h2><a id="ebcdicconvertbytype" - name="ebcdicconvertbytype">EBCDICConvertByType</a></h2> - <!--%plaintext <?INDEX {\tt EBCDICConvertByType} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> EBCDICConvertByType On|Off[=<em>direction</em>] - <em>mimetype</em> [<em>mimetype</em>] ...<br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôte virtuel, répertoire, .htaccess<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Override" - rel="Help"><strong>Surcharge :</strong></a> FileInfo<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> la - conversion EBCDIC est disponible à partir de la version - 1.3.19 d'Apache sur les plate-formes basées sur EBCDIC. - - <p>La directive EBCDICConvertByType associe un type MIME - (pouvant contenir une *) à une éventuelle - conversion (<samp>On</samp> ou <samp>Off</samp>).</p> - - <p>Si le format optionnel <samp>On=<i>direction</i></samp> (or - <samp>Off=<i>direction</i></samp>) est employé, - où <i>direction</i> est choisi parmi <samp>In</samp>, - <samp>Out</samp> ou <samp>InOut</samp>, alors la directive ne - s'applique seulement que dans une direction de transfert - donnée (<samp>In</samp> : contenu reçu par une - requête PUT ou POST , <samp>Out</samp> : contenu - renvoyé à une requete GET ou POST, et - <samp>InOut</samp> : conversion dans les deux - directions).<br /> - Sinon, <samp>InOut</samp> (conversion dans les deux - directions) est défini.</p> - - <p><strong>Par exemple</strong>:<br /> - Une configuration standard pratique devrait au moins contenir - ces directives :</p> -<pre> - # All text documents are stored as EBCDIC files: - # Tous les document textes sont stockés au format EBCDIC - EBCDICConvertByType On text/* message/* multipart/* - EBCDICConvertByType On application/x-www-form-urlencoded \ - model/vrml application/postscript - # Les autres fichiers sont traités comme binaires. - EBCDICConvertByType Off */* -</pre> - Si vous servez seulement que des documents ASCII, par exemple - provenant d'un montage NFS d'un serveur Unix, utilisez : -<pre> - # Tous les documents sont déjà en ASCII: - EBCDICConvertByType Off */* -</pre> - - <p><strong>Voir également</strong>: <a - href="#ebcdicconvert">EBCDICConvert</a> et <a - href="../ebcdic.html#ebcdic">Aperçu des fonctions de - conversion EBCDIC</a></p> - <hr /> - - <h2><a id="ebcdickludge" - name="ebcdickludge">EBCDICKludge</a></h2> - <!--%plaintext <?INDEX {\tt EBCDICKludge} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> EBCDICKludge On|Off<br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Default:</strong></a> <code>EBCDICKludge - Off</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôte virtuel, répertoire, .htaccess<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Override" - rel="Help"><strong>Surcharge :</strong></a> FileInfo<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - EBCDICKludge est disponible à partir de la version - 1.3.19 d'Apache sur les plate-formes basées sur EBCDIC. - Il est désuet et sera abandonné dans les versions - ultérieures.<br /> - - - <p>The EBCDICKludge est proposée par - compatibilité avec les versions d'Apache 1.3.0 à - 1.3.18. Dans ces versions, tous les fichiers dont le type MIME - commence par "text/", "message/" ou "multipart/" ou dont le - type est "application/x-www-form-urlencoded" sont convertis par - défaut, les autres documents sont retournés sans - conversion. Un document est présumé être au - format ASCII iuniquement si il est du type - "<samp>text/<b>x-ascii-</b><i>sous-type</i></samp>", et ne sera - donc pas converti. A la place, le préfixe - "<samp><b>x-ascii-</b></samp>" était supprimé du - type, obtenant ainsi le type MIME - "<samp>text/<i>sous-type</i></samp>" comme type du document - retourné.</p> - - <p>Si la directive EBCDICKludge est mise à - <samp>On</samp>, et si aucune des extensions de fichiers ne - correspondent aux directives <a - href="#ebcdicconvert">EBCDICConvert</a> définis dans le - contexte , alors le serveur teste avec le type MIME de format - <samp><i>type/</i><b>x-ascii-</b><i>sous-type</i></samp>. Si le - document a un tel type alors la chaîne - "<samp><b>x-ascii-</b></samp>" est supprimée et la - conversion est mise à <samp>Off</samp>. Cela permet de - surcharger l'assertion implicite que tous les fichiers sont - stockés au format EBCDIC, par exemple si Apache sert des - fichiers provenant d'un montage NFS d'un répertoire - contenant des documents ASCII.<br /> - En utilisant EBCDICKludge, Il n'y a aucun moyen de forcer un - des autres types MIME (par exemple model/vrml) d'être - traité au format EBCDIC. L'utilisation de la directive - <a href="#ebcdicconvertbytype">EBCDICConvertByType</a> est - préférable pour définir une telle - conversion. Avant Apache 1.3.19, il n'y avait aucun moyen de - forcer ces document binaires d'être traités comme - des fichiers textes EBCDIC</p> - - <p><strong>Voir également</strong> : <a - href="#ebcdicconvert">EBCDICConvert</a>, <a - href="#ebcdicconvertbytype">EBCDICConvertByType</a> and <a - href="../ebcdic.html#ebcdic">Aperçu des fonctions de - conversion EBCDIC</a></p> - <hr /> - - <h2><a id="errordocument" name="errordocument">Directive - ErrorDocument</a></h2> - <!--%plaintext <?INDEX {\tt ErrorDocument} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> ErrorDocument <em>code d'erreur - document</em><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôtes virtuels, répertoire, - .htaccess<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Override" - rel="Help"><strong>Surcharge :</strong></a> FileInfo<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> Les - contextes répertoire et .htaccess ne sont utilisables - qu'à partir de la version 1.1 d'Apache. - - <p>Dans l'éventualité d'un problème ou - d'une erreur, Apache peut exécuter l'une des quatre - actions suivantes :</p> - - <ol> - <li>sortie d'un message d'erreur simple standard</li> - - <li>sortie d'un message personnalisé</li> - - <li>redirection vers une URL locale pour traiter le - problème (ou l'erreur)</li> - - <li>redirection vers une URL externe pour traiter le - problème (ou l'erreur)</li> - </ol> - - <p>La première option est celle par défaut, les - options 2 à 4 seront obtenues en utilisant la directive - <tt>ErrorDocument</tt>, suivi du code HTTP d'erreur et du - message textuel d'erreur, ou une URL.</p> - - <p><em>Messages</em> dans ce contexte, commence par un - guillemet simple (<code>"</code>), qui ne fait pas partie du - message lui-même. Apache ajoutera souvent des - informations complémentaires explicitant le - problème (ou l'erreur).</p> - - <p>L'URL peut débuter par un slash (/) pour des URL - locales, ou être complètement qualifiées. - Exemples:</p> - - <blockquote> - <code>ErrorDocument 500 - http://foo.example.com/cgi-bin/tester<br /> - ErrorDocument 404 /cgi-bin/bad_urls.pl<br /> - ErrorDocument 401 /subscription_info.html<br /> - ErrorDocument 403 "Sorry can't allow you access today</code> - </blockquote> - - <p>Notez que lorsque vous spécifiez un - <tt>ErrorDocument</tt> qui pointe vers une URL externe (c'est - -à-dire toute adresse commençant par quelque - chose du style "http:") Apache émettra une requête - de redirection au client pour lui indiquer où trouver le - document. Ceci peut perturber les robots et d'autres clients - qui essaient de déterminer si une URL est valide en - testant le code retour de la requête. De plus, si vous - utilisez l'écriture <code>ErrorDocument 401</code> le - client ne saura pas qu'il doit demander un mot de passe - puisqu'il ne recevra pas le code retour 401. Par - conséquent, il est impératif d'utiliser une URL - locale pour une directive "ErrorDocument 401". Ceci est induit - par la nature des schémas d'authentification de base - d'HTTP.</p> - - <p><strong>Voir aussi:</strong> <a - href="../custom-error.html">documentation sur les - réponses personnalisées.</a></p> - <hr /> - - <h2><a id="errorlog" name="errorlog">Directive - ErrorLog</a></h2> - <!--%plaintext <?INDEX {\tt ErrorLog} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> ErrorLog <em>nomfichier</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> <code>ErrorLog - logs/error_log</code> (Unix)<br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> <code>ErrorLog - logs/error.log</code> (Windows et OS/2)<br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôtes virtuels<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>Cette directive définit le nom du fichier dans lequel - le serveur marque la trace des erreurs rencontrées. Si - le nom de fichier ne commence pas par un slash (/), alors la - partie "chemin d'accès" est considérée - relativement à <a href="#serverroot">ServerRoot</a>. - Exemple:</p> - - <blockquote> - <code>ErrorLog /dev/null</code> - </blockquote> - - <p>Cette expression a pour effet de désactiver la trace - d'erreurs.</p> - Si le fichier commence par une barre verticale (|), il est - censé être une commande à exécuter - pour ttraiter le message d'erreur.<br /> - <br /> - - - <p><strong>Apache 1.3 et ultérieur:</strong> en - utilisant <code>syslog</code> à la place d'un fichier - permet d'employer syslogd(8) si le système l'accepte. Le - défau est d'utiliser la fonction syslog - <code>local7</code>, mais vous pouvez remplacer ceci en - utilisant la syntaxe <code>syslog:</code><em>service</em> - où <em>service</em> peut être un des noms - documenté dans syslog(1).</p> - - <p><strong>Sécurité :</strong> Voir la page <a - href="../misc/security_tips.html">note sur la - securité</a> pour plus d'information concernant une - possibilité de brêche de sécurité si - le répertoire d'accueil des fichiers de trace peut - être écrit par tout autre utilisateur que le - propriétaire du processus serveur.</p> - <hr /> - - <h2><a id="files" name="files">Directive <Files></a></h2> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> <Files <em>nomfichier</em>> ... - </Files><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôtes virtuels, .htaccess<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - Disponible à partir de la version 1.2 d'Apache. - - <p>La directive <tt><Files></tt> permet une gestion de - contrôle d'accès fichier par fichier. Elle est - comparable aux directives <a - href="#directory"><Directory></a> et <a - href="#location"><Location></a>. Elle doit s'apparier - à une directive <tt></Files></tt>. Les directives - applicables au fichier indiqué sont encapsulées - entre ces deux balises. Les sections <tt><Files></tt> - sont traitées dans l'ordre où elles apparaissent - dans le fichier de configuration, une fois traitées les - sections <tt><Directory></tt> et les fichiers .htaccess, - mais avant les sections <tt><Location></tt>.</p> - - <p>L'argument <em>filename</em> peut inclure un nom de fichier, - où un motif, dans lequel '?' correspond à tout - caractère unique quelconque, et '*' correspond à - une séquence de zéro à un nombre - quelconque de caractères. Les "expressions - régulières" peuvent aussi être - utilisées, pourvu qu'elles soient - précédées du caractère - <code>~</code>. Par exemple :</p> -<pre> - <Files ~"\.(gif|jpe?g|png)$"> -</pre> - - <p>correspondrait à la majorité des fichiers - graphiques utilisés sur Internet. A partir de la version - 1.3 d'Apache, l'usage de la directive <a - href="#filesmatch"><FilesMatch></a> est cependant - préférable.</p> - - <p>Notez que, contrairement aux sections <a - href="#directory"><Directory></a> et <a - href="#location"><Location></a>, les sections - <tt><Files></tt> peuvent apparaître dans des - fichiers <code>.htaccess</code>. Ceci permet aux utilisateurs - de contrôler l'accès à leurs propres - fichiers, sur un mode individuel. Lorsqu'elles sont - utilisées dans un fichier <code>.htaccess</code>, si - <em>nomfichier</em> ne commence pas par un slash (/), le - répertoire courant contenant ledit fichier - <code>.htaccess</code> y sera préfixé - automatiquement.</p> - - <p><strong>Voir aussi :</strong> <a - href="../sections.html">Comment fonctionnent les sections - concernant les répertoires, chemins et fichiers</a> pour - une explication plus précise concernant la - manière dont ces sections sont combinées - lorsqu'une requête est traitée</p> - <hr /> - - <h2><a id="filesmatch" name="filesmatch">Directive - <FilesMatch></a></h2> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> <FilesMatch <em>regex</em>> ... - </Files><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôtes virtuels, .htaccess<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - Disponible à partir de la version 1.3 d'Apache. - - <p>La directive <tt><FilesMatch></tt> permet un - contrôle d'accès fichier par fichier, tout comme - la directive <a href="#files"><Files></a>. Cependant, - elle n'accepte qu'un argument sous forme d'expression - régulière. Par exemple :</p> - - <blockquote> - <code><FilesMatch "\.(gif|jpe?g|png)$"></code> - </blockquote> - - <p>qui correspondrait à la plupart des fichiers - graphiques utilisés sur Internet.</p> - - <p><strong>Voir aussi :</strong> <a - href="../sections.html">Comment fonctionnent les sections - concernant les répertoires, chemins et fichiers</a> pour - une explication plus précise concernant la - manière dont ces sections sont combinées - lorsqu'une requête est traitée</p> - <hr /> - - <h2><a id="group" name="group">Directive Group</a></h2> - <!--%plaintext <?INDEX {\tt Group} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> Group <em>groupeUnix</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> <code>Group - #-1</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôte virtuel<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>La directive <tt>Group</tt> définit le groupe dont - les requêtes seront traitées par le serveur. Pour - utiliser cette directive, le serveur stand-alone doit tout - d'abord être exécuté par l'utilisateur - "root". <em>groupeUnix</em> est à choisir parmi :</p> - - <dl> - <dt>un nom de groupe</dt> - - <dd>se réfère à un groupe unix par son - nom.</dd> - - <dt># suivi d'unnuméro de groupe.</dt> - - <dd>se réfère à un groupe par son - indice.</dd> - </dl> - - <p>Il est recommendé de créer un nouveau groupe - d'utilisateurs pour les utilisateurs exécutant le - serveur. Certains administrateurs assignent le serveur à - l'utilisateur <code>nobody</code>, mais ceci n'est pas toujours - possible ou souhaîtable.</p> - - <p><strong>Note :</strong> si vous démarrez le serveur - sous un compte utilisateur autre que "root", la commutation sur - un autre groupe échouera, et le groupe utilisé - restera le groupe initial de l'utilisateur.</p> - - <p><strong>Note spéciale :</strong> L'utilisation de - cette directive dans un contexte <tt><VirtualHost></tt> - nécessite un <a href="../suexec.html">suEXEC wrapper</a> - correctement configuré. De cette manière et dans - ce contexte, seul le groupe dans lequel sont - exécutés les CGI sont affectés. Toute - requête autre que CGI sont toujours lancées dans - le groupe défini par la directive Group principale.</p> - - <p><strong>Sécurité :</strong> Voir <a - href="#user">Utilisateur</a> pour une discussion plus - détaillée sur les aspects utilisateurs.</p> - <hr /> - - <h2><a id="hostnamelookups" name="hostnamelookups">Directive - HostNameLookups</a></h2> - <!--%plaintext <?INDEX {\tt HostNameLookups} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> HostNameLookups <em>on | off | double</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>HostNameLookups off</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôte virtuel, répertoire, .htaccess<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - <code>double</code> n'est disponible qu'à partir de la - version 1.3 d'Apache.<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> La - valeur par défaut était <code>on</code> pour - toute version antérieure à la version 1.3 - d'Apache. - - <p>Cette directive autorise la résolution DNS pour la - trace d'accès (et pour les passer aux CGI/SSI en - <code>REMOTE_HOST</code>). La valeur <code>double</code> - signifie une résolution DNS inverse double. - C'est-à-dire, après qu'une résolution - inverse soit effectuée, une résolution est - ensuite effectuée à partir du résultat - obtenu. Au moins une des adresses IP obtenues par la - deuxième résolution doit correspondre à - l'adresse originale. (Dans le langage des "fous de tcp" ceci - s'appelle <code>PARANOID</code>.)</p> - - <p>Indépendamment du mode choisi, lorsque <a - href="mod_access.html">mod_access</a> est utilisé pour - faire du contrôle d'accès par nom d'hôte, - une résolution inverse double sera effectuée. - Ceci est indispensable pour des raisons de - sécurité. Notez que le résultat de cette - résolution inverse double n'est en général - pas accessible sauf si l'option <samp>HostnameLookups - double</samp> est activée. Par exemple, si l'option est - simplement <samp>HostnameLookups on</samp> et une requête - est reçue vers un objet soumis à des restrictions - quant aux noms d'hôtes, et quelque soit le - résultat de la réslution inverse double, les CGI - recevront le résultat de la résolution inverse - dans la variable d'environnement <code>REMOTE_HOST</code>.</p> - - <p>Par défaut, l'état choisi était - <code>on</code> dans les versions d'apache antérieures - à la version 1.3. Elle est aujourd'hui à - <code>off</code> afin de diminuer le trafic pour les sites qui - n'ont pas un besoin absolu de la résolution inverse. - C'est aussi un avantage pour les utilisateurs finaux qui - n'auront pas à attendre la fin du processus de - résolution avant d'être servis. Des sites - chargés devraient plutôt laisser cette opyion - à <code>off</code>, dans la mesure où une - recherche DNS peut consommer un temps non négligeable. - L'utilitaire <code>logresolve</code>, fourni dans le - répertoire <i>/support</i>, peut être - utilisé pour résoudre des noms d'hôtes - à partir des adresses IP tracées en mode - "offline".</p> - <hr /> - - <h2><a id="identitycheck" name="identitycheck">Directive - IdentityCheck</a></h2> - <!--%plaintext <?INDEX {\tt IdentityCheck} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> IdentityCheck <em>booléen</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>IdentityCheck off</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôte virtuel, répertoire, .htaccess<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>Cette directive autorise une trace conforme à la - RFC1413 du nom d'utilisateur pour chaque connexion, lorsque la - machine cliente exécute identd ou un procesus similaire. - Cette information est tracée dans le fichier - <code>access log</code>. <em>booléen</em> vaut soit - <code>on</code> ou <code>off</code>.</p> - - <p>Cette information n'est absolument pas certifiée et - ne peut être considérée que pour une - analyse sommaire.</p> - - <p>Notez que ce fontionnement peut rallonger notablement les - délais d'accès à votre serveur dans la - mesure où chaque requête nécessite - l'exécution d'une résolution. Lorsque des - "firewalls" sont présents chaque résolution peut - éventuellement échouer et ajouter ainsi 30 - secondes d'attente pour chaque accès. En conclusion, - cette option n'est en général pas opportune pour - des serveurs Internet ouverts au public.</p> - <hr /> - - <h2><a id="ifdefine" name="ifdefine"><IfDefine> - directive</a></h2> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> <IfDefine - [!]<em>nom-paramètre</em>> <em>...</em> - </IfDefine><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> aucun<br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> tous<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - <IfDefine> est disponible à partir de la version - 1.3.1 - - <p>La section <IfDefine - <em>test</em>>...</IfDefine> est employée pour - délimiter des directives conditionnelles. Les directives - à l'intérieur d'un section IfDefine ne sont - prises en compte que si <em>test</em> est vraie. Si - <em>test</em> est faux, tout ce qui se trouve entre le marqueur - de début et celui de fin est ignoré.</p> - - <p>Le <em>test</em> de la section <IfDefine> peut exister - sous deux formes :</p> - - <ul> - <li><em>nom-paramètre</em></li> - - <li><code>!</code><em>nom-paramètre</em></li> - </ul> - - <p>Dans le premier cas, les directives entre les marqueurs de - début et de fin ne sont traité que si le - paramètre nommé <em>nom-paramètre</em> est - défini. Dans le deuxième cas, les directives - entre les marqueurs de début et de fin ne sont - traité que si le paramètre nommé - <em>nom-paramètre</em> n'est <strong>pas</strong> - défini.</p> - - <p>L'argument <em>nom-paramètre</em> est une - définition qui peut être donnée en ligne de - commande d'httpd en utilisant l'option - <code>-D</code><em>nom-paramètre</em>, au lancement du - serveur.</p> - - <p>Les sections <IfDefine> peuvent s'imbriquer, ce qui - permet de réaliser des test sur plusieurs - paramètres. Par exemple :</p> -<pre> - $ httpd -DReverseProxy ... - - # httpd.conf - <IfDefine ReverseProxy> - LoadModule rewrite_module libexec/mod_rewrite.so - LoadModule proxy_module libexec/libproxy.so - </IfDefine> -</pre> - <hr /> - - <h2><a id="ifmodule" name="ifmodule">Directive - <IfModule></a></h2> - <b>Syntaxe :</b> <IfModule [!]<i>nomModule</i>> - <i>...</i> </IfModule><br /> - <b>Défaut :</b> aucun<br /> - <b>Contexte :</b> tous<br /> - <b>Statut :</b> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> IfModule - n'est disponible qu'à partir de la version 1.2 d'Apache. - - - <p>La section <tt><IfModule - <i>test</i>></tt>...</IfModule> permet de rendre - conditionnelles un groupe de directives. Les directives - à l'intérieur d'une section IfModule ne sont - considérées que si le <i>test</i> est - vérifié. Si <i>test</i> vaut faux, toute - directive inclue entre la balise de début et celle de - fin sont ignorées.</p> - - <p>Le <em>test</em> d'une section <tt><IfModule></tt> - peut prendre l'une des formes suivantes :</p> - - <ul> - <li><i>nomModule</i></li> - - <li>!<i>nomModule</i></li> - </ul> - - <p>Dans le premier cas, les directives entre les deux balises - de début et de fin ne sont traitées que si le - module indiqué par <em>nomModule</em> est compilé - dans votre version d'Apache. La seconde forme inverse le sens - du test, et ne traite les directives que si le module - <em>nomModule</em> n'est <b>pas</b> compilé.</p> - - <p>L'argument <em>nomModule</em> spécifie un nom de - module par son nom de fichier source, tel qu'appelé par - la compilation. Par exemple, <code>mod_rewrite.c</code>.</p> - - <p>Les sections <tt><IfModule></tt> peuvent être - imbriquées, ce qui peut être utile pour - implémenter simplement des tests multi-modules.</p> - <hr /> - - <h2><a id="include" name="include">Directive Include</a></h2> - <strong>Syntaxe :</strong> Include <em>nomfichier</em><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> Include - n'est disponible qu'à partir de la version 1.3 d'Apache. - - - <p>Cette directive permet l'inclusion d'autres fichiers de - configuration à partir d'autres fichiers de - configuration serveur.</p> - - <p>A partir de la version Apache 1.3.13, si - <code>Include</code> pointe vers un répertoire plutot - qu'un fichier, Apche lira tous fichiers de ce - répertoire, ou des sous-répertoires, et traitera - chacun de ces fichiers de configuration.</p> - <hr /> - - <h2><a id="keepalive" name="keepalive">Directive - KeepAlive</a></h2> - <strong>Syntaxe : (Apache 1.1)</strong> KeepAlive - <em>requêtesMax</em><br /> - <strong>Défaut : (Apache 1.1)</strong> <code>KeepAlive - 5</code><br /> - <strong>Syntaxe : (Apache 1.2)</strong> KeepAlive - <em>on/off</em><br /> - <strong>Défaut : (Apache 1.2)</strong> <code>KeepAlive - On</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - KeepAlive est disponible à partir de la version 1.1 - d'Apache. - - <p>L'extension Keep-Alive d'HTTP/1.0 et les connexions - persistantes d'HTTP/1.1 fournissent des sessions durables HTTP - , qui autorisent plusieurs requêtes à être - envoyées sur la même connexion. Dans certains cas, - il a été constaté une réduction de - 50% du temps de latence ppour des documents HTML contenant de - nombreuses images. Pour activer les connexions persistantes - (keep-alive) à partir d'Apache 1.2 il faut - définir la directive <code>KeepAlive On</code>.</p> - - <p>Pour les clients HTTP/1.1, Les connexions persistantes ne - sont employées que si elles sont spécifiquement - demandées par un client. De plus, une connexion - persistantes ne peut être employées que si la - taille du contenu est connu à l'avance. Ceci implique - que les contenus dynamiques, tels que les scripts CGI, les - pages SSI, et les listes de répertoires - générés par le serveur n'utilisent pas de - connexions persistentes pour les clients HTTP/1.0. Pour les - clients HTTP/1.1, les connexions sont persistantes par - défaut à moins d'être - spécifiée. Si le client le demande, l'encodage - par tranches est utilisé afin d'envoyer des contenus de - tailles inconnus au travers de connxions persistantes.</p> - - <p><strong>Sous Apache 1.1</strong>: Mettre - <em>requêtesMax</em> au nombre maximum de requêtes - qu'Apache peut traiter par connexion persistante. Une - limitation est imposée pour éviter qu'un client - ne vienne asphyxier votre serveur en ressources. Mettre un - <code>0</code> pour désactiver ce support. A partir de - la version 1.2, ceci est contrôlé par la directive - MaxKeepAliveRequests</p> - Voir aussi la directive <a - href="#maxkeepaliverequests">MaxKeepAliveRequests</a>.<br /> - <br /> - - <hr /> - - <h2><a id="keepalivetimeout" name="keepalivetimeout">Directive - KeepAliveTimeout</a></h2> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> KeepAliveTimeout <em>secondes</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>KeepAliveTimeout 15</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - <tt>KeepAliveTimeout</tt> est disponible à partir de la - version 1.1 d'Apache. - - <p>Le nombre de secondes pendant lesquelles Apache attendra une - requête postérieure avant de rompre une connexion. - Dès qu'une requête est reçue, la valeur de - la temporisation spécifiée par la directive <a - href="#timeout">Timeout</a> s'applique.</p> - - <p>Mettre <code>KeepAliveTimeout</code> à une grande - valeur peut créer des problèmes de performance - pour des serveurs chargés. Le plus grand est ce - délai, le plus les processus du serveur seront - occupés en attente de connexions avec des clients - inactifs.</p> - <hr /> - - <h2><a id="limit" name="limit">Directive <Limit></a></h2> - <!--%plaintext <?INDEX {\tt Limit} section directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> <Limit <em>méthode méthode</em> - ... > ... </Limit><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> tous<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>Les contrôles d'accès sont normalement actives - pour <strong>toutes</strong> les méthodes - d'accès, et ceci est le comportement normal. <strong>En - général, les directives de contrôle - d'accès ne doivent être placées à - l'intérieur d'une section - <code><limit></code>.</strong></p> - - <p>Le but de la directive <Limit> est de restreindre la - portée des contrôles d'accès à - certaines méthodes HTTP. Pour toutes les autres - méthodes, les restrictions d'accès qui sont - situées à l'intérieur de <Limit> - <strong>sont sans effets</strong>. L'exemple suivant applique - le contrôle d'accès uniquement aux méthodes - POST, PUT, and DELETE, laissant les autres méthodes non - protégées :</p> - - <blockquote> - <code><Limit POST PUT DELETE><br /> - Require valid-user<br /> - </Limit></code> - </blockquote> - Les noms de méthodes peuvent être choisis parmi - GET, POST, PUT, DELETE, CONNECT, OPTIONS, TRACE, PATCH, - PROPFIND, PROPPATCH, MKCOL, COPY, MOVE, LOCK, et UNLOCK. - <strong>Le nom de la méthode est sensible à la - casse.</strong> Si GET est employé, il restreindra - également les requêtes HEAD. - <hr /> - - <h2><a id="limitexcept" name="limitexcept">Directive - <LimitExcept></a></h2> - <!--%plaintext <?INDEX {\tt LimitExcept} section directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> <LimitExcept <em>méthode</em> - [<em>méthode</em>] ... > ... - </LimitExcept><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> tous<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - disponible à partir de la version 1.3.5 d'Apache. - - <p><LimitExcept> et </LimitExcept> sont - employés pour entourer un groupe de directives de - contrôle d'accès qui s'appliqueront pour n'importe - quelle méthode d'accès ne se trouvant - <strong>pas</strong> en arguments Cette directive est - l'oppsée de <a href="#limit"><Limit></a> et peut - être employée pour contrôler les - méthodes non reconnues ou non standard. Voir la - documentation de <a href="#limit"><Limit></a> pour plus - de détails.</p> - <hr /> - - <h2><a id="limitrequestbody" name="limitrequestbody">Directive - LimitRequestBody</a></h2> - <!--%plaintext <?INDEX {\tt LimitRequestBody} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> LimitRequestBody <em>octets</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>LimitRequestBody 0</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôte virtuel, répertoire .htaccess<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - LimitRequestBody est disponible à partir de la version - 1.3.2. - - <p>Cette directive détermine la taille maximale en - octets que peut avoir le corps d'une requête. Elle peut - aller de 0 (illimité) à 2147483647 (2GB). La - valeur par défaut est déterminée à - la compilation par la constante - <code>DEFAULT_LIMIT_REQUEST_BODY</code> (0 dans les - distributions).</p> - - <p>La directive LimitRequestBody directive permet à - l'utilisateur de fixer une limite à la taille du corps - d'une requête à l'intérieur du contexte - où cette directive est située (serveur, par - répertoire, par fichier). Si le client effezctue une - requête excédant cette limite, le serveur - retournera un message d'erreur au lieu de traiter la - requête. La taille d'une requête normale peut - beaucoup varier en fonction de la nature de la ressource - demandée et des méthodes d'accès permise - sur cette ressource. Typiquement les scripts CGI utilise le - corps du message pour passer des informations au serveur. Des - implémentation de la méthode PUT nécessite - une valeur au moins aussi grande que le serveur souhaite - recevoir pour cette ressource.</p> - - <p>Cette directive donne à l'administrateur un plus - grand contrôle par rapport à des requêtes - anormales de clients, et peut être utile pour - éviter certaines formes d'attaques par déni de - service.</p> - <hr /> - - <h2><a id="limitrequestfields" - name="limitrequestfields">Directive LimitRequestFields</a></h2> - <!--%plaintext <?INDEX {\tt LimitRequestFields} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> LimitRequestFields <em>number</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>LimitRequestFields 100</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - LimitRequestFields est disponible à partir de la version - 1.3.2. - - <p><em>Number</em> est un entier allant de 0 (signifiant sans - limite) à 32767. La valeur par défaut est - définie à la compilation par la constante - <code>DEFAULT_LIMIT_REQUEST_FIELDS</code> (100 dans la - distribution).</p> - - <p>La directive LimitRequestFields permet à - l'administrateur du serveur de modifier le nombre maximum de - champs autorisé à l'intérieur de - l'en-tête d'une requête HTTP. Un serveur doit avoir - cette valeur supérieure au nombre de champs qu'un client - normal peut inclure. Le nombre de champs utilisé par un - client excède rarement 20, mais ceci peut varier en - fonction de l'implémentation des clients, le plus - souvent il dépend du niveau auquel le client a - configuré son butineur pour accepter une - négociation de contenu très fine. Les extensions - HTTP optionnelles sont exprimées en utilisant des champs - dans l'en-tête de requête.</p> - - <p>Cette directive permet à l'administrateur un meilleur - contrôle par rapport à des requêtes - anormales, ce qui peut être utile pour éviter - certaines attaques par déni de service. Cette valeur - doit être augmentée si certains clients obtiennent - un message d'erreur à leurs requêtes indiquant que - trop de champs sont envoyés dans la requête.</p> - <hr /> - - <h2><a id="limitrequestfieldsize" - name="limitrequestfieldsize">Directive - LimitRequestFieldsize</a></h2> - <!--%plaintext <?INDEX {\tt LimitRequestFieldsize} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> LimitRequestFieldsize <em>octets</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>LimitRequestFieldsize 8190</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - LimitRequestFieldsize est disponible à partir de la - version 1.3.2. - - <p>Cette directive indique la taille maximale de - l'en-tête d'une requête HTTP et peut aller de 0 - <em>octets</em> à la valeur définit à la - compilation par la constante - <code>DEFAULT_LIMIT_REQUEST_FIELDSIZE</code> (8190 dans la - distribution standard).</p> - - <p>La directive LimitRequestFieldsize permet à - l'administrateur de limiter la taille autorisée pour le - champ d'en-tête HTTP d'une requête à une - valeur inférieure à celle définie à - la compilation. Un serveur doit avoir cette valeur suffisamment - grande pour pouvoir traiter les requêtes de clients - normaux. La taille d'une requête noramle peut beaucoup - varier en fonction de l'implémentation du client, le - plus souvent il dépend du niveau auquel le client a - configuré son butineur pour accepter une - négociation de contenu très fine.</p> - - <p>Cette directive permet l'administrateur d'avoir un meilleur - contrôle sur des requêtes ayant un comportement - anormale, ce qui peut être utile afin d'éviter - certaines formes d'attaques par déni de service. Dans - des conditions normales, cette valeur doit rester celle par - défaut.</p> - <hr /> - - <h2><a id="limitrequestline" name="limitrequestline">Directive - LimitRequestLine</a></h2> - <!--%plaintext <?INDEX {\tt LimitRequestLine} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> LimitRequestLine <em>octets</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>LimitRequestLine 8190</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - LimitRequestLine est disponible à partir de la version - 1.3.2. - - <p>Cette directive indique la taille maximale d'une - requête HTTP et peut aller de 0 <em>octets</em> à - la valeur définit à la compilation par la - constante <code>DEFAULT_LIMIT_REQUEST_LINE</code> (8190 dans la - distribution standard).</p> - - <p>La directive LimitRequestLine permet à - l'administrateur de réduire la limite fixée pour - une requête HTTP en dessous de la valeur fixée - à la compilation. Comme une requête est - composée de la méthode HTTP, d'une URI et de la - version du protocole utilisé, la directive - LimitRequestLine place une restriction sur la taille maximale - que peut avoir une URI dansune requête. Un serveur doit - avoir cette valeur suffisamment grande pour pouvoir traiter - n'importe quelle de ses ressources, en prenant en compte les - informations qui pourrait être passées dans une - requête GET.</p> - - <p>Cette directive permet l'administrateur d'avoir un meilleur - contrôle sur des requêtes ayant un comportement - anormale, ce qui peut être utile afin d'éviter - certaines formes d'attaques par déni de service. Dans - des conditions normales, cette valeur doit rester celle par - défaut.</p> - <hr /> - - <h2><a id="listen" name="listen">Directive Listen</a></h2> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> Listen - [<em>adresseIp</em>:]<em>numéroPort</em><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> Listen - est disponible à partir de la version 1.1 d'Apache. - - <p>La directive <tt>Listen</tt> enjoint Apache à - écouter plus d'une adresse IP ou port; par défaut - Apache répond aux requêtes reçues sur - toutes les interfaces IP, mais seulement celles arrivant sur le - port donné par la directive <a - href="#port">Port</a>.</p> - <tt>Listen</tt> peut être utilisée à la - place de <tt><a href="#bindaddress">BindAddress</a></tt> et - <tt>Port</tt>. Elle indique au serveur d'accepter des - requêtes entrantes sur le port spécifié ou - sur une combinaison adresse-port. Si le premier format est - utilisé (avec seule mention d'un numéro de port), - le serveur "écoutera" tous les ports - spécifiés sur chacune des interfaces IP qu'il - connaît, plutôt que sur le port donné par la - directive <tt>Port</tt>. Si une adresse IP adresse IP est - précisée en complément, le serveur - restreindra son écoute à la combinaison - adresse-port précisée.<br /> - <br /> - - - <p>Notez que vous avez toujours besoin de la directive - <tt>Port</tt> qui permettent à Apache de - générer les URL de retour vers votre serveur.</p> - - <p>Plusieurs directives <tt>Listen</tt> peuvent être - utilisées pour spécifier un ensemble d'adresses - et de ports à écouter. Le serveur répondra - aux requêtes reçues sur n'importe laquelle des - combinaisons adresse-port ainsi spécifiée.</p> - - <p>Par exemple, pour autoriser le serveur à accepter des - connexions sur les ports 80 et 8000, écrire :</p> - - <blockquote> -<pre> -<code>Listen 80 -Listen 8000 -</code> -</pre> - </blockquote> - - <p>Pour autoriser un serveur à accepter des connexions - sur deux "sockets" qualifiés, écrire :</p> -<pre> -Listen 192.170.2.1:80 -Listen 192.170.2.5:8000 -</pre> - - <p><strong>Voir aussi:</strong> <a - href="../dns-caveats.html">Apache et DNS</a><br /> - <strong>Voir aussi:</strong> <a href="../bind.html">Configurer - les ports et adresses utilisée par Apache</a><br /> - <strong>Voir aussi :</strong> <a - href="http://httpd.apache.org/info/known_bugs.html#listenbug">Bogues - connus</a></p> - <hr /> - - <h2><a id="listenbacklog" name="listenbacklog">Directive - ListenBacklog</a></h2> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> ListenBacklog <em>backlog</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>ListenBacklog 511</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - <tt>ListenBacklog</tt> n'est disponible qu'à partir de - la version 1.2.0 d'Apache. - - <p>La longueur maximale de la file d'attente des connexions en - attente. En général, aucun ajustement n'est - nécessaire, cependant, il est souhaitable sur certains - systèmes d'augmenter cette longueur de file pour - répondre à des attaques TCP SYN. Voir les - paramètres backlog dans l'appel système - <code>listen(2)</code>.</p> - - <p>Cette directive est limitée à un petit nombre - par le système d'exploitation. Elle peut varier d'un - système à un autre. Il faut également - noter que pour la plupart des systèmes, la valeur - réellement utilisée n'est pas celle - spécifiée par la directive, mais un nombre - basé sur cette valeur (généralement plus - grande).</p> - <hr /> - - <h2><a id="location" name="location">Directive - <Location></a></h2> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> <Location <em>URL</em>> ... - </Location><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôtes virtuels<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - <tt>Location</tt> est disponible à partir des versions - 1.1 d'Apache. - - <p>La directive <tt><Location></tt> permet d'instaurer un - contrôle d'accès sur une base URL. Elle est - comparable à la directive <a - href="#directory"><Directory></a>, et doit s'apparier - à une directive <tt></Location></tt>. Les - directives s'appliquant à l'URL précisée - seront à inclure entre ces deux balises. Les sections - <tt><Location></tt> sont traitées dans l'ordre - où elles apparaissent dans le fichier de configuration, - une fois les sections <tt><Directory></tt> et les - fichiers <code>.htaccess</code> traités.</p> - - <p>Il faut noter que les URL n'ont pas du tout à suivre - la même organisation que le système de fichiers, - et il faut souligner que la directive <Location> - opère de manière totalement indépendante - du système de fichiers.</p> - - <p>Le <em>préfixe d'URL</em> devra, sauf pour des - requêtes à un proxy, être de la forme - <code>/chemin/</code>, et ne devra pas inclure de mention - <code>http://nomserveur</code>. Elle ne protège pas - nécessairement un répertoire (cela peut - être un fichier individuel, ou un ensemble de fichiers), - et peut inclure des métacaractères. Dans un motif - (avec des métacaractères), '?' remplace un - caractère quelconque, et '*' remplace toute chaîne - quelconque de 0 ou plus caractères. POur les - requêtes à un proxy, l'URL doitt être de la - forme <code>scheme://nomserveur/serveur</code>, et vous devez - inclure le préfixe.</p> - - <p><strong>Apache 1.2 et plus :</strong> Des expression - régulières peuvent être utilisées, - à condition de les faire précéder du - caractère <code>~</code>. Par exemple :</p> - - <blockquote> - <code><Location ~ "/(extra|special)/data"></code> - </blockquote> - - <p>correspondrait à des URL contenant la - sous-chaîne "/extra/data" ou "/special/data". Cependant, - sous Apache 1.3, l'utilisation de la directive <a - href="#locationmatch"><LocationMatch></a> est - conseillée.</p> - - <p>La fonctionnalité <tt>Location</tt> est - particulièrement pratique lorsque combinée - à la directive <a - href="mod_mime.html#sethandler">SetHandler</a>. Par exemple, - pour permettre des requêtes sur les rapports - d'état, mais ne les autoriser que pour des agents - requérant à partir du domaine foo.com, vous - pourriez écrire :</p> - - <blockquote> -<pre> -<code><Location /status> -SetHandler server-status -order deny,allow -deny from all -allow from .foo.com -</Location> -</code> -</pre> - </blockquote> - - <p><strong>Note sur / (barre oblique) pour les version - supérieures à 1.3</strong>: La caractère - barre oblique à une signification particulière en - fonction de l'endroit où il se situe. Des personnes sont - habitués au comportement dans certains systèmes - de fichiers où de multiples caractères obliques - sont remplacés par un caractère unique (par - exemple <code>/home///foo</code> est identique à - <code>/home/foo</code>). Dans le monde des URL ceci n'est pas - obligatoirement vrai. La directive - <code><LocationMatch></code> et la version avec - expression régulière de - <code><Location></code> demande de spécifier - plusieurs caractères obliques si ceci est votre - intention. Par exemple, <code><LocationMatch - ^/abc></code> fonctionnera avec l'URL <code>/abc</code> mais - pas avec l'URL <code>//abc</code>. La directive (sans - expression régulière) - <code><Location></code> se comporte de manière - similaire quand elle est employée pour des - requêtes proxy. Mais si la directive (sans expression - régulière) <code><Location></code> est - utilisée pour des requêtes sans proxy, il - associera implicitement plusieurs obliques à un seul. - Par exemple, si vous spécifiez <code><Location - /abc/def></code> et que la requête est - <code>/abc//def</code> celle ci correspondra.</p> - - <p><strong>Voir aussi</strong>: <a - href="../sections.html">Comment fonctionnent les sections - concernant les répertoires, chemins et fichiers</a> pour - une explication plus précise concernant la - manière dont ces sections sont combinées - lorsqu'une requête est traitée.</p> - <hr /> - - <h2><a id="locationmatch" name="locationmatch">Directive - <LocationMatch></a></h2> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> <LocationMatch <em>regex</em>> ... - </LocationMatch><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôte virtuel<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> Location - est disponible à partir de la version 1.3 d'Apache. - - <p>La directive <tt><LocationMatch></tt> permet - l'établissement d'un contrôle d'accès sur - une base URL, d'une façon identique à la - directive <a href="#location"><Location></a>. Cependant, - elle n'accepte qu'une expression régulière comme - argument. Par exemple :</p> - - <blockquote> - <code><LocationMatch "/(extra|special)/data"></code> - </blockquote> - représente des URL contenant l'une des - sous-chaînes "/extra/data" ou "/special/data". <br /> - <br /> - <strong>Voir aussi</strong> : <a - href="../sections.html">Comment fonctionnent les sections - concernant les répertoires, chemins et fichiers</a> pour - une explication plus précise concernant la - manière dont ces sections sont combinées - lorsqu'une requête est traitée. - <hr /> - - <h2><a id="lockfile" name="lockfile">Directive - LockFile</a></h2> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> LockFile <em>nomfichier</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> <code>LockFile - logs/accept.lock</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>La directive <tt>LockFile</tt> indique le chemin - d'accès du fichier de verrouillage utilisé - lorsqu'Apache est compilé en mode - <code>USE_FCNTL_SERIALIZED_ACCEPT</code> ou - <code>USE_FLOCK_SERIALIZED_ACCEPT</code>. Ce paramètre - sera laissé généralement dans son - état par défaut. La raison principale qui - conduirait à modifier ce paramètre serait le fait - que le répertoire des traces (<code>logs</code>) soit - monté sous NFS, le fichier de verrouillage devant de - préférence être situé sur un disque - local à la machine serveur pour autant que possible. Le - PID du processus serveur principal est automatiquement - rajouté au nom de fichier.</p> - - <p><strong>SECURITE :</strong> il vaut mieux éviter de - metttre ce fichier dans un répertoire inscriptible par - tout le monde tel que <code>/var/tmp</code> cas quelqu'un - pourrait créer une attaque par déni de service et - empécher le serveur de redémarrer en - créant un fichier de verrouillage de même nom que - celui que veut créer le serveur.</p> - <hr /> - - <h2><a id="loglevel" name="loglevel">Directive - LogLevel</a></h2> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> LogLevel <em>niveau</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> <code>LogLevel - error</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôtes virtuels<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> LogLevel - est disponible à partir de la version 1.3. - - <p>LogLevel ajuste le niveau de verbosité des messages - inscrits dans les traces d'erreur (voir la directive <a - href="#errorlog">ErrorLog</a>). Les niveaux possibles sont par - ordre de gravité décroissante :</p> - - <table> - <tr> - <th align="LEFT"><strong>Niveau</strong> </th> - - <th align="LEFT"><strong>Description</strong> </th> - </tr> - - <tr> - <th> - </th> - - <th align="LEFT"><strong>Exemple</strong> </th> - </tr> - - <tr> - <td><code>emerg</code> </td> - - <td>Urgences - le système est inutilisable.</td> - </tr> - - <tr> - <td> - </td> - - <td>"Child cannot open lock file. Exiting"</td> - </tr> - - <tr> - <td><code>alert</code> </td> - - <td>Une action doit être prise - immédiatement.</td> - </tr> - - <tr> - <td> - </td> - - <td>"getpwuid: couldn't determine user name from uid"</td> - </tr> - - <tr> - <td><code>crit</code> </td> - - <td>Conditions critiques.</td> - </tr> - - <tr> - <td> - </td> - - <td>"socket: Failed to get a socket, exiting child"</td> - </tr> - - <tr> - <td><code>error</code> </td> - - <td>Cas d'erreur.</td> - </tr> - - <tr> - <td> - </td> - - <td>"Premature end of script headers"</td> - </tr> - - <tr> - <td><code>warn</code> </td> - - <td>Avertissements.</td> - </tr> - - <tr> - <td> - </td> - - <td>"child process 1234 did not exit, sending another - SIGHUP"</td> - </tr> - - <tr> - <td><code>notice</code> </td> - - <td>Normal mais condition significative.</td> - </tr> - - <tr> - <td> - </td> - - <td>"httpd: caught SIGBUS, attempting to dump core in - ..."</td> - </tr> - - <tr> - <td><code>info</code> </td> - - <td>Pour information.</td> - </tr> - - <tr> - <td> - </td> - - <td>"Server seems busy, (you may need to increase - StartServers, or Min/MaxSpareServers)..."</td> - </tr> - - <tr> - <td><code>debug</code> </td> - - <td>Messages de déboguage</td> - </tr> - - <tr> - <td> - </td> - - <td>"Opening config file ..."</td> - </tr> - </table> - - <p>Quand un niveau est spécifié, les messages des - niveaux de plus haute gravité seront également - rapportés. Par exemple, quand la directive - <code>LogLevel info</code> est définie, les messages de - niveau <code>notice</code> et <code>warn</code> seront aussi - notifiés.</p> - - <p>L'utilisation d'un niveau de gravité d'au moins - <code>crit</code> est recommandé.</p> - <hr /> - - <h2><a id="maxclients" name="maxclients">Directive - MaxClients</a></h2> - <!--%plaintext <?INDEX {\tt MaxClients} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> MaxClients <em>nombre</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>MaxClients 256</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>La directive <tt>MaxClients</tt> indique le nombre limite de - requêtes simultanées pouvant être - acceptées par le serveur ; il représente le - nombre maximum de processus serveur fils qui peuvent tourner - à un instant donné. Pour configurer plus de 256 - clients, vous devez modifier la constante HARD_SERVER_LIMIT du - fichier source d'Apache httpd.h et recompiler Apache.</p> - - <p>Les tentatives de connexions au delà de MaxClients - sont normalement mises en attente, jusqu'à une limite - fixée par la directive <a - href="#listenbacklog">ListenBacklog</a>. Une fois qu'un - processus fils est libre à la fin d'une requête - différente, la connexion en attente est - traitée.</p> - <hr /> - - <h2><a id="maxkeepaliverequests" - name="maxkeepaliverequests">Directive - MaxKeepAliveRequests</a></h2> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> MaxKeepAliveRequests <em>nombre</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>MaxKeepAliveRequests 100</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - Uniquement à partir de la version 1.2 d'Apache. - - <p>La directive <tt>MaxKeepAliveRequests</tt> limite le nombre - de requêtes permises pour une connexion unique lorsque la - directive <a href="#keepalive">KeepAlive</a> est - activée. Si <em>nombre</em> vaut "<code>0</code>", - chaque connexion peut admettre un nombre illimité de - requêtes. Nous recommendons que ce paramètre soit - réglé sur une valeur relativement haute pour - obtenir des performances optimales du serveur. Dans la version - 1.1 d'Apache, ceci est contrôlé par la directive - Keepalive</p> - <hr /> - - <h2><a id="maxrequestsperchild" - name="maxrequestsperchild">Directive - MaxRequestsPerChild</a></h2> - <!--%plaintext <?INDEX {\tt MaxRequestsPerChild} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> MaxRequestsPerChild <em>nombre</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>MaxRequestsPerChild 0</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>La directive <tt>MaxRequestsPerChild</tt> indique le nombre - limite de requêtes qu'un processus serveur fils peut - traîter. Après <tt>MaxRequestsPerChild</tt> - requêtes, ce processus fils meurt. Si ce paramètre - est fixé à 0, alors les processus fils ne meurent - jamais.</p> - - <p>Le fait de mettre <tt>MaxRequestsPerChild</tt> à une - valeur non nulle a deux conséquences - bénéfiques :</p> - - <ul> - <li>cela limite le volume de mémoire qu'un processus - peut consommer (accidentellement) et évite une - saturation mémoire ;</li> - - <li>en donnant à un processus un temps de vie fini, le - nombre total de processus impliqués dans le serveur - décroit lorsque la charge du serveur retombe.</li> - </ul> - - <p>Cependant sur les systèmes Win32, il est - recommandé de mettre cette valeur à 0. Si celle - ci est à une valeur non nulle, quand le nombre de - requêtes est atteint, le processus fils quitte, et est - relancé en relisant les fichiers de configuration. Ceci - peut conduire à un comportement imprévisible si - vous avez modifié un fichier de configuration, mais ne - souhaitez pas que ces changements soient pris en compte. Voir - également <a - href="#threadsperchild">ThreadsPerChild</a>.</p> - - <p><strong>NOTE:</strong> pour les requêtes - <em>KeepAlive</em> requests, seule la première - requête est comptée. En réalité, il - change le comportement afin de limiter le nombre de - <em>connexions</em> par fils.</p> - <hr /> - - <h2><a id="maxspareservers" name="maxspareservers">Directive - MaxSpareServers</a></h2> - <!--%plaintext <?INDEX {\tt MaxSpareServers} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> MaxSpareServers <em>nombre</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>MaxSpareServers 10</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>La directive <tt>MaxSpareServers</tt> indique le nombre - maximal de processus fils en <em>attente</em>. Un processus en - attente est un processus qui existe, mais qui ne traite pas de - requête. S'il existe plus de <tt>MaxSpareServers</tt> de - ces processus, alors le père viendra tuer les processus - en supplémentaires.</p> - - <p>L'activation de cette fonctionnalité ne devrait - être nécessaire que sur les site vraiment - très chargés. Régler ce paramètre - sur une grande valeur est de toutes façon toujours une - mauvaise idée.</p> - - <p>Cette directive n'a aucun effet quand elle est - employée sur les plates-formes WIndows.</p> - - <p>Voir aussi <a href="#minspareservers">MinSpareServers</a> et - <a href="#startservers">StartServers</a>.</p> - <hr /> - - <h2><a id="minspareservers" name="minspareservers">Directive - MinSpareServers</a></h2> - <!--%plaintext <?INDEX {\tt MinSpareServers} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> MinSpareServers <em>nombre</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>MinSpareServers 5</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>La directive <tt>MinSpareServers</tt> indique le nombre - minimum de processus fils en <em>attente</em> qu'un serveur - pourra conserver. S'il existe moins de <tt>MinSpareServers</tt> - processus serveurs fils en attente, le processus père - recréera des processus fils au rythme de 1 par - seconde.</p> - - <p>L'activation de cette fonctionnalité ne devrait - être nécessaire que sur des sites très - chargés. Régler ce paramètre sur une - grande valeur est de toutes façons toujours une mauvaise - idée.</p> - - <p>Cette directive n'a aucun effet quand elle est - employée sur les plates-formes WIndows.</p> - - <p>Voir aussi <a href="#maxspareservers">MaxSpareServers</a> et - <a href="#startservers">StartServers</a>.</p> - <hr /> - - <h2><a id="namevirtualhost" name="namevirtualhost">Directive - NameVirtualHost</a></h2> - <!--%plaintext <?INDEX {\tt NameVirtualHost} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> NameVirtualHost - <em>addr</em>[:<em>port</em>]<br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - <tt>NameVirtualHost</tt> n'est disponible qu'à partir de - la version 1.3 d'Apache. - - <p>La directive <tt>NameVirtualHost</tt> est nécessaire - si vous souhaitez configurer <a href="../vhosts/index.html">des - hôtes virtuels nommés</a>.</p> - - <p>Bien que <em>addr</em> puisse être exprimée - comme un nom d'hôte, il est recommandé d'utiliser - une adresse IP, exemple :</p> - - <blockquote> - <code>NameVirtualHost 111.22.33.44</code> - </blockquote> - - <p>Avec cette directive <tt>NameVirtualHost</tt>, l'adresse - nommée par le nom de votre hôte virtuel se - résout. Si vous exploitez plusieurs hôtes - nommés sur des adresses multiples, répétez - cette directive autant de fois que nécessaire (pour - chaque adresse).</p> - - <p>Note: le "serveur principal" et tous les serveurs "par - défaut" ne seront <strong>jamais</strong> servis pour - une requête vers une adresse IP NameVirtualHost (à - moins que pour une raison donnée vous définissiez - NameVirtualHost mais qu'aucun VirtualHosts ne soit - défini pour cette adresse).</p> - - <p>En option, vous pouvez préciser un numéro de - port sur lequel l'hôte virtuel nommé sera atteint, - par exemple :</p> - - <blockquote> - <code>NameVirtualHost 111.22.33.44:8080</code> - </blockquote> - A partir de la version 1.3.13, vous pouvez donner comme adresse - <code>*</code> Ceci crée un NameVirtualHost qui - correspond à toutes les connexions venant de toutes les - adresses IP qui ne sont pas configurés avec une autre - directive NameVirtualHost ou un section <a - href="#virtualhost"><VirtualHost></a>. Cette option est - pratique si vous n'utilisez que des hôtes virtuels - nommés et que vous ne souhaitez pas coder en dur - l'adresse IP de votre machine dans le fichier de - configuration.<br /> - <br /> - <strong>Voir aussi :</strong> <a href="../vhosts/">Hôtes - virtuels sur Apache</a> - <hr /> - - <h2><a id="options" name="options">Directive Options</a></h2> - <!--%plaintext <?INDEX {\tt Options} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> Options <em>[+|-]option [+|-]option - ...</em><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôte virtuel, répertoire, .htaccess<br /> - <strong>Surcharge:</strong> Options<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>La directive <tt>Options</tt> contrôle quelles - fonctions du serveur sont disponibles dans un répertoire - particulier.</p> - - <p><em>option</em> peut valoir <code>None</code>, auquel cas - aucune fonction supplémentaire n'est disponible, ou une - ou plus des possibilités suivantes :</p> - - <dl> - <dt>All</dt> - - <dd>toutes options sauf MultiViews.</dd> - - <dt>ExecCGI</dt> - - <dd><!--%plaintext <?INDEX {\tt ExecCGI} option> --> - L'exécution des scripts CGI est autorisée.</dd> - - <dt>FollowSymLinks</dt> - - <dd> - <!--%plaintext <?INDEX {\tt FollowSymLinks} option> --> - Le serveur est autorisé à suivre les liens - symboliques dans ce répertoire. - - <p><strong>Note</strong>: même si le serveur suit le - lien symbolique, il <b>ne</b> doit <b>pas</b> changer le - chemin d'accès afin de ne pas entrer en - contradiction avec les sections - <tt><Directory></tt>.</p> - </dd> - - <dt>Includes</dt> - - <dd><!--%plaintext <?INDEX {\tt Includes} option> --> - Les inclusions par Server-Side-Include sont permises.</dd> - - <dt>IncludesNOEXEC</dt> - - <dd> - <!--%plaintext <?INDEX {\tt IncludesNOEXEC} option> --> - Les SSI sont autorisés, mais pas la commande #exec ni - <code>#include</code> des scripts CGI.</dd> - - <dt>Indexes</dt> - - <dd><!--%plaintext <?INDEX {\tt Indexes} option> --> - Si une URL requise pointe sur un répertoire, et aucun - fichier défini par <tt>DirectoryIndex</tt> (ex. - index.html) n'existe dans ce répertoire, alors le - serveur retourne une liste formatée du contenu du - répertoire.</dd> - - <dt>MultiViews</dt> - - <dd><!--%plaintext <?INDEX {\tt MultiViews} option> --> - <a href="../content-negotiation.html">Un contenu - négocié</a> en <code>MultiViews</code> est - permis.</dd> - - <dt>SymLinksIfOwnerMatch</dt> - - <dd> - <!--%plaintext <?INDEX {\tt SymLinksIfOwnerMatch} option> --> - Le serveur ne suivra les liens symboliques uniquement si le - fichier visé ou le répertoire visé - appartiennent au même utilisateur que le lien - lui-même.</dd> - </dl> - - <p>Normalement, si plusieurs options <code>Options</code> - peuvent être appliquées à un - répertoire, alors la plus restrictive est - appliquée ; les options ne sont pas combinées. - Cependant, si <i>all</i> les options dans la directive - <code>Options</code> sontprécédées d'un - symbole + ou -, alors les options sont alors combinées - entre elles. Toute option précédée d'un + - est ajoutée aux options en cours, toute option - précédée d'un - est - désactivée.</p> - - <p>Par exemple, sans symboles + ni - :</p> - - <blockquote> -<pre> -<code><Directory /web/docs> -Options Indexes FollowSymLinks -</Directory> -<Directory /web/docs/spec> -Options Includes -</Directory> -</code> -</pre> - </blockquote> - - <p>seul <code>Includes</code> sera activé pour le - répertoire <code>/web/docs/spec</code>. Cependant, si la - seconde directive d'<code>Options</code> utilise les symboles + - et - :</p> - - <blockquote> -<pre> -<code><Directory /web/docs> -Options Indexes FollowSymLinks -</Directory> -<Directory /web/docs/spec> -Options +Includes -Indexes -</Directory> -</code> -</pre> - </blockquote> - - <p>alors les options <code>FollowSymLinks</code> et - <code>Includes</code> sont validées pour le - répertoire <code>/web/docs/spec</code>.</p> - <hr /> - - <h2><a id="pidfile" name="pidfile">Directive PidFile</a></h2> - <!--%plaintext <?INDEX {\tt PidFile} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> PidFile <em>filename</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> <code>PidFile - logs/httpd.pid</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>La directive <tt>PidFile</tt> définit le fichier dans - lequel le serveur enregistre l'identificateur de processus du - démon. Si le nom de fichier ne commence pas par un slash - (/) alors le fichier est défini relativement au <a - href="#serverroot">ServerRoot</a>. Le fichier <tt>PidFile</tt> - n'est utilisé que dans le mode <a - href="#servertype">standalone</a>.</p> - - <p>Il est souvent utile de pouvoir envoyer un signal au - serveur, pour qu'il referme et réouvre ses fichiers <a - href="#errorlog">ErrorLog</a> et <tt>TransferLog</tt>, et - relise ses fichiers de configuration. Ceci peut être fait - en envoyant un signal SIGHUP (kill -1) au processus - identifié par l'identificateur de processus - marqué dans <tt>PidFile</tt>.</p> - - <p>Le fichier <tt>PidFile</tt> est concerné par les - mêmes problèmes d'emplacement et de <a - href="../misc/security_tips.html">securité</a> que les - fichiers de trace.</p> - <hr /> - - <h2><a id="port" name="port">Directive Port</a></h2> - <!--%plaintext <?INDEX {\tt Port} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> Port <em>numéro</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> <code>Port - 80</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p><em>numéro</em> est un nombre compris entre 0 et - 65535; certains numéros de ports (surtout en dessous de - 1024) sont réservés pour des protocoles - spécifiques. Une liste des ports - prédéfinis est consultable dans la RFC 1340 - "Assigned Numbers" <code>/etc/services</code>; le port standard - assigné au protocole http est le port 80.</p> - - <p>La directive <tt>Port</tt> a deux comportements, le premier - est nécessaire pour assurer la compatibilité NCSA - (et qui peut préter à confusion dans le contexte - d'Apache).</p> - - <ul> - <li>En absence de toute directive <a - href="#listen">Listen</a> ou <a - href="#bindaddress">BindAddress</a> spécifiant un - numéro de port, la directive <tt>Port</tt> - définit le port réseau que le serveur - écoute. S'il existe une directive <tt>Listen</tt> ou - <tt>BindAddress</tt> spécifiant un - <code>:numéro</code> alors la directive Port n'a aucun - effet quant au socket que le serveur écoute.</li> - - <li>La directive Port définit la variable - d'environnement <code>SERVER_PORT</code> (pour les <a - href="mod_cgi.html">CGI</a> et les <a - href="mod_include.html">SSI</a>), laquelle est - utilisée lorsque le serveur génère une - URL qui point sur lui-même (par exemple lorsqu'il - indique une indirection externe vers lui-même).</li> - </ul> - - <p>Dans aucun cas une définition du <tt>Port</tt> ne - définit à quel port un <a - href="#virtualhost">VirtualHost</a> répond, la directive - <tt>VirtualHost</tt> elle-même se chargeant de cette - définition.</p> - - <p>Le comportement premier de la directive <tt>Port</tt> doit - être considéré comme similaire à - celui de la directive <a href="#servername">ServerName</a>. - <tt>ServerName</tt> et <tt>Port</tt> spécifient - conjointement ce que vous considérez être - l'adresse <em>canonique</em> du serveur.</p> - - <p>Le Port 80 est l'un des ports prédéfinis - d'Unix. Tous les ports numérotés en dessous de - 1024 sont réservés à un usage - système, c-à-d. que des utilisateurs non - privilégiés (non-root) ne peuvent les utiliser ; - ces derniers peuvent par contre utiliser des ports de plus haut - rang. Pour utiliser le port 80, le serveur doit être - exécuté sous <code>root</code>. Après - avoir lié le port (bind) et avant d'accepter des - requêtes, Apache changera son utilisateur associé - tel que défini par la directive <a - href="#user">User</a>.</p> - - <p>Si vous ne pouvez utiliser le port 80, choisissez tout autre - port libre. Les utilisateurs non-root devront choisir un - numéro de port supérieur à 1023, 8000 par - exemple.</p> - - <p><strong>Sécurité :</strong> si vous - démarrez le serveur sous <code>root</code>, assurez vous - que la directive <a href="#user">User</a> ne mentionne pas - <code>root</code>. Si vous traitez des requêtes en - disposant toujours de super privilèges, vous ouvrez - votre système à des attaques majeures.</p> - <hr /> - - <h2><a id="require" name="require">Directive require</a></h2> - <!--%plaintext <?INDEX {\tt require} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> require <em>nomEntite Entite - Entite...</em><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> répertoire, - .htaccess<br /> - <strong>Surcharge:</strong> AuthConfig<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>Cette directive choisi quels utilisateurs autorisés - peuvent accéder à un répertoire. Les - syntaxes valides sont :</p> - - <ul> - <li> - require user <em>utilisateur utilisateur ...</em> - - <p>Seuls les utilisateurs nommés peuvent - accéder au répertoire.</p> - </li> - - <li> - require group <em>nomGroupe nomGroupe ...</em> - - <p>Seuls les utilisateurs des groupes cités peuvent - accéder au répertoire.</p> - </li> - - <li> - require valid-user - - <p>Tout utilisateur reconnu peut accéder au - répertoire (par opposition aux non - utilisateurs).</p> - </li> - </ul> - - <p>Si <code>require</code> apparaît dans une section <a - href="#limit"><Limit></a>, alors les restrictions ne sont - appliquées qu'aux méthodes http - mentionnées. Autrement, toutes les méthodes http - sont restreintes. Exemple :</p> - - <blockquote> -<pre> -<code>AuthType Basic -AuthName unDomaine -AuthUserFile /web/users -AuthGroupFile /web/groups -<Limit GET POST> -require group admin -</Limit> -</code> -</pre> - </blockquote> - - <p>Pour fonctionner correctement, la directive Require doit - être accompagné de directives <a - href="#authname">AuthName</a> et <a - href="#authtype">AuthType</a>, et de directives de type <a - href="mod_auth.html#authuserfile">AuthUserFile</a> et <a - href="mod_auth.html#authgroupfile">AuthGroupFile</a> (servant - à définir les utilisateurs et les groupes).</p> - <hr /> - - <h2><a id="resourceconfig" name="resourceconfig">Directive - ResourceConfig</a></h2> - <!--%plaintext <?INDEX {\tt ResourceConfig} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> ResourceConfig <em>nomfichier</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>ResourceConfig conf/srm.conf</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôte virtuel<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>Le serveur lit dans ce fichier des directives - supplémentaires, après avoir lu le fichier - <code>httpd.conf</code>. <em>nomfichier</em> est - considéré relativement à <a - href="#serverroot">ServerRoot</a>. Cette fonctionnalité - peut être désactivée par l'écriture - :</p> - - <blockquote> - <code>ResourceConfig /dev/null</code> - </blockquote> - ou sur les serveurs Win32 - - <blockquote> - <code>ResourceConfig nul</code> - </blockquote> - - <p>Historiquement, ce fichier contenait essentiellement les - directives autres que celles servant à la configuration - du serveur ou les sections <a - href="#directory"><Directory></a> ; en fait, il peut - contenir maintenant toute directive admise dans le contexte - <em>configuration serveur</em>.</p> - - <p>A partir de la version 1.3.13, si la directive - <code>ResourceConfig</code> pointe sur un répertoire - plutot qu'un fichier, Apache lira tous les fichiers de ce - répertoire ou de ses sous-répertoires et les - traitera comme fichiers de configuration.</p> - - <p>Voir aussi <a href="#accessconfig">AccessConfig</a>.</p> - <hr /> - - <h2><a id="rlimit" name="rlimit">Directive RLimitCPU</a> <a - id="rlimitcpu" name="rlimitcpu"></a></h2> - <!--%plaintext <?INDEX {\tt RLimitCPU} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> RLimitCPU <em># ou 'max'</em> <em>[# ou - 'max']</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> <em>Non - précisé; utilise le défaut du - système d'exploitation</em><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôte virtuel<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - RLimitCPU n'est disponible qu'à partir de la version 1.2 - d'Apache - - <p>Accepte 1 ou 2 parametères. Le premier - paramètre indique la limite logicielle pour tous les - processus et le second paramètre la limite - supérieure en termes de ressources. Chacun des - paramètres peut être exprimé par un nombre, - ou <em>max</em> pour indiquer au serveur que la limite est - celle imposée par le système d'exploitation. La - limite supérieure en ressource ne peut être - atteinte que si le serveur tourne sous root, ou - éventuellement pendant la phase de démarrage.</p> - - <p>Ceci est valide pour les processus lancés par les - processus fils d'Apache pour le traitement des requêtes - et non pour les processus fils d'Apache eux-mêmes. Cela - inclut les scripts CGI, les commandes exec SSI, mais pas les - processus lancés par le processu Apache père tels - que les traces.</p> - - <p>La limite de ressources CPU est exprimée en secondes - par processus.</p> - - <p>Voir aussi <a href="#rlimitmem">RLimitMEM</a> ou <a - href="#rlimitnproc">RLimitNPROC</a>.</p> - <hr /> - - <h2><a id="rlimitmem" name="rlimitmem">Directive - RLimitMEM</a></h2> - <!--%plaintext <?INDEX {\tt RLimitMEM} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> RLimitMEM <em># ou 'max'</em> <em>[# ou - 'max']</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> <em>Non - précisé ; utilise le défaut du - système d'exploitation</em><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôte virtuel<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - RLimitMEM is only available in Apache 1.2 and later - - <p>Accepte 1 ou 2 paramètres. Le premier - paramètre fixe la limite logicielle en ressources - mémoire pour tous les processus tandis que le second - paramètre fixe la limite absolue de ressources - mémoire. Chaque paramètre peut être un - nombre, ou <em>max</em> pour indiquer au serveur que la limite - est fixée par le système d'exploitation. La - limite supérieure en ressource ne peut être - atteinte que si le serveur tourne sous root, ou - éventuellement pendant la phase de démarrage.</p> - - <p>Ceci est valide pour les processus lancés par les - processus fils d'Apache pour le traitement des requêtes - et non pour les processus fils d'Apache eux-mêmes. Cela - inclut les scripts CGI, les commandes exec SSI, mais pas les - processus lancés par le processu Apache père tels - que les traces.</p> - - <p>Les ressources mémoire sont exprimées en - octets par processus.</p> - - <p>Voir aussi <a href="#rlimitcpu">RLimitCPU</a> ou <a - href="#rlimitnproc">RLimitNPROC</a>.</p> - <hr /> - - <h2><a id="rlimitnproc" name="rlimitnproc">Directive - RLimitNPROC</a></h2> - <!--%plaintext <?INDEX {\tt RLimitNPROC} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> RLimitNPROC <em># ou 'max'</em> <em>[# ou - 'max']</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> <em>Unset; uses - operating system defaults</em><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôte virtuel<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - RLimitNPROC n'est disponible qu'à partir de la version - 1.2 d'Apache - - <p>Accepte 1 ou 2 paramètres. Le premier - paramètre fixe la limite logicielle en ressources pour - tous les processus tandis que le second paramètre fixe - la limite absolue de ressources mémoire. Chaque - paramètre peut être un nombre, ou <em>max</em> - pour indiquer au serveur que la limite est fixée par le - système d'exploitation. La limite supérieure en - ressource ne peut être atteinte que si le serveur tourne - sous root, ou éventuellement pendant la phase de - démarrage.</p> - - <p>Ceci est valide pour les processus lancés par les - processus fils d'Apache pour le traitement des requêtes - et non pour les processus fils d'Apache eux-mêmes. Cela - inclut les scripts CGI, les commandes exec SSI, mais pas les - processus lancés par le processu Apache père tels - que les traces.</p> - - <p>Cette limite contrôle le nombre de processus maximum - par utilisateur.</p> - - <p><strong>Note :</strong> Si les processus CGI <b>ne</b> - tournent <b>pas</b> sous un autre utilisateur que l'utilisateur - du serveur, cette directive limitera aussi le nombre de - processus que le serveur lui-même peut créer. - Cette situation sera indiquée de façon - évidente par des messages d'erreur <b><em>cannot - fork</em></b> dans le fichier error_log.</p> - - <p>Voir aussi <a href="#rlimitmem">RLimitMEM</a> ou <a - href="#rlimitcpu">RLimitCPU</a>.</p> - <hr /> - - <h2><a id="satisfy" name="satisfy">Directive Satisfy</a></h2> - <!--%plaintext <?INDEX {\tt Satisfy} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> Satisfy <em>'any' ou 'all'</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> Satisfy - all<br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> répertoire, - .htaccess<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - <tt>Satisfy</tt> n'est disponible qu'à partir de la - version 1.2 d'Apache - - <p>Politique d'accès si à la fois 'allow' et - 'require' sont utilisés. Le paramètre peut valoir - soit <em>'all'</em> soit <em>'any'</em>. Cette directive n'est - utile que si l'accès à une zone - particulière est à la fois restreinte par un - username/password <em>et</em> et par l'adresse d'hôte - client. Dans ce cas le comportement par défaut ("all") - impose au client de passer la restriction d'adresse <em>et</em> - d'entrer un identificateur d'utilisateur et un mot de passe - valides. Avec l'option "any", le client sera servi si son - adresse d'hôte est conforme <em>ou</em> s'il rentre des - paramètres d'identification corrects. Ceci peut - être utilisé pour restreindre un zone par un mot - de passe, tout en laissant quelques client bien - identifiés entrer dans le domaine sans avoir à se - soumettre à la procédure d'identification.</p> - - <p>Voir aussi <a href="#require">Require</a> et <a - href="mod_access.html#allow">Allow</a>.</p> - <hr /> - - <h2><a id="scoreboardfile" name="scoreboardfile">Directive - ScoreBoardFile</a></h2> - <!--%plaintext <?INDEX {\tt ScoreBoardFile} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> ScoreBoardFile <em>nomfichier</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>ScoreBoardFile logs/apache_status</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>La directive <tt>ScoreBoardFile</tt> est nécessaire - sur certaines architectures pour créer un fichier - servant à la communication entre des processus - pères et des processus fils. La meilleure façon - de savoir si votre système nécessite un tel - fichier est d'exécuter Apache et de voir s'il - crée le fichier mentionné dans la directive. Si - votre système nécessite l'emploi de ce fichier, - alors vous devez vous assurer que celui-ci ne peut être - utilisé que par une et une seule invocation - d'Apache.</p> - - <p>Si vous devez utiliser un <tt>ScoreBoardFile</tt>, vous - pourrez optimiser votre temps d'exécution en le - plaçant sur un disque virtuel en RAM. Cependant, - rappelez-vous que les mêmes recommandations sont à - prendre en compte pour la position de ce fichier que pour la - position des fichiers de trace quant à la <a - href="../misc/security_tips.html">securité</a>.</p> - - <p><i>A partir d'Apache 1.2 :</i></p> - - <p>Les utilisateurs de Linux 1.x doivent pouvoir ajouter - <code>-DHAVE_SHMGET</code> aux <code>EXTRA_CFLAGS</code> dans - leur fichier de <code>Configuration</code>. Ceci devrait - fonctionner sur certaines installations en 1.x, mais pas - forcément sur toutes.</p> - - <p>Les utilisateurs de SVR4 devront considérer - l'opportunité d'ajouter <code>-DHAVE_SHMGET</code> aux - <code>EXTRA_CFLAGS</code> dans leur fichier de - <code>Configuration</code>. Il semble que cela fonctionne, mais - nous n'avons pu le tester pour la version 1.2. (avant la - version 1.3b4, <code>HAVE_SHMGET</code> devait suffire.)</p> - <br /> - <br /> - - - <p><strong>Voir aussi</strong> : <a - href="../stopping.html">Arrêter et redémarrer - Apache</a></p> - <hr /> - - <h2><a id="scriptinterpretersource" - name="scriptinterpretersource">ScriptInterpreterSource - directive</a></h2> - <!--%plaintext <?INDEX {\tt ScriptInterpreterSource} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> ScriptInterpreterSource registry|script<br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>ScriptInterpreterSource script</code> <br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> répertoire, - .htaccess<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau (seulement sur Windows) - - <p>Cette directive sert, à partir de la version 1.3.5 - d'Apache, à déterminer où trouver - l'interpréteur employé pour exécuter les - scripts CGI. La technique par défaut est de prendre - l'interpréteur pointé par les caractères - #! dans le script. En fixant ScriptInterpreterSource à - registry, La table de registration de Windows sera - employée pour chercher l'interpréteur, en prenant - l'extension du fichier comme clé (par exemple .pl).</p> - <hr /> - - <h2><a id="sendbuffersize" name="sendbuffersize">Directive - SendBufferSize</a></h2> - <!--%plaintext <?INDEX {\tt SendBufferSize} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> SendBufferSize <em>octets</em><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>Le serveur règle la taille du tampon interne de TCP - au nombre d'octets spécifié. Très utile - pour augmenter les tailles par défaut dans le cas - d'utilisation de liaisons haute vitesse (ex. des liaisons - transcontinantales rapides).</p> - <hr /> - - <h2><a id="serveradmin" name="serveradmin">Directive - ServerAdmin</a></h2> - <!--%plaintext <?INDEX {\tt ServerAdmin} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> ServerAdmin <em>adresseEMail</em><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôte virtuel<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>La directive <tt>ServerAdmin</tt> définit l'adresse - e-mail que le serveur inclut dans tout message d'erreur - retourné au client.</p> - - <p>Il peut être utile de dédier une adresse - réservée à cet usage, par exemple :</p> - - <blockquote> - <code>ServerAdmin www-admin@foo.bar.com</code> - </blockquote> - - <p>car les utilisateur ne rappellent pas toujours dans leur - message ce à propos de quoi ils interviennent!</p> - <hr /> - - <h2><a id="serveralias" name="serveralias">Directive - ServerAlias</a></h2> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> ServerAlias <em>hôte1 hôte2 - ...</em><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> hôte - virtuel<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - <tt>ServerAlias</tt> est disponible à partir de la - version 1.1 d'Apache - - <p>La directive <tt>ServerAlias</tt> défini un nom - secondaire pour un hôte, utilisable dans le contexte d'<a - href="../vhosts/name-based.html">hôte virtuels - nommés</a>.</p> - - <p><strong>Voir aussi :</strong> <a - href="../vhosts/index.html">Hôtes virtuels sur - Apache</a></p> - <hr /> - - <h2><a id="servername" name="servername">Directive - ServerName</a></h2> - <!--%plaintext <?INDEX {\tt ServerName} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> ServerName <em>nom de domaine entièrement - qualifié</em><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôte virtuel<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>La directive <tt>ServerName</tt> définit le nom - d'hôte du serveur ; celui-ci n'est utilisé que - pour créer des URL de redirection. S'il n'est pas - défini, alors le serveur tentera de le résoudre - à partir de sa propre adresse IP ; cependant, cette - résolution n'est pas d'une fiabilité absolue, ou - peut résulter en un nom autre que le nom - "souhaité". Par exemple :</p> - - <blockquote> - <code>ServerName www.wibble.com</code> - </blockquote> - - <p>peut être défini lorsque le nom canonique - (principal) de la machine actuelle est - <code>monster.wibble.com</code>.</p> - - <p>Si vous utilisez des <a - href="../vhosts/name-based.html">hôtes virtuels - nommés</a>, la directive <code>ServerName</code> - à l'intérieur d'une section <a - href="#virtualhost"><code><VirtualHost></code></a> impose - que quel nom d'hôte doit apparaître dans - l'en-tête <code>Host:</code> d'une requête pour - être associé à cet hôte virtuel.</p> - - <p><strong>Voir aussi</strong> : <a - href="../dns-caveats.html">Apache et DNS</a> <a - href="../vhosts/">documentation sur les hôtes virtuels - Apache</a><br /> - <a href="#usecanonicalname">UseCanonicalName</a><br /> - <a href="#namevirtualhost">NameVirtualHost</a><br /> - <a href="#serveralias">ServerAlias</a><br /> - </p> - <hr /> - - <h2><a id="serverpath" name="serverpath">Directive - ServerPath</a></h2> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> ServerPath <em>chemin</em><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> hôte - virtuel<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - <tt>ServerPath</tt> est disponible à partir de la - version 1.1 d'Apache. - - <p>La directive <tt>ServerPath</tt> définit le chemin - d'accès servant de base pour les URL ciblant un <a - href="../vhosts/index.html">hôte virtuel - nommé</a>.</p> - - <p><strong>Voir aussi :</strong> <a - href="../vhosts/index.html">Hôtes virtuels sur - Apache</a></p> - <hr /> - - <h2><a id="serverroot" name="serverroot">Directive - ServerRoot</a></h2> - <!--%plaintext <?INDEX {\tt ServerRoot} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> ServerRoot <em>nomrépertoire</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>ServerRoot /usr/local/apache</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>La directive <tt>ServerRoot</tt> définit le - répertoire dans lequel se situe le serveur. Typiquement, - ce répertoire contiendra les sous-répertoires - <code>conf/</code> et <code>logs/</code>. Les chemins - d'accès relatifs pour d'autres fichiers de configuration - seront considérés relativement à ce - répertoire.<br /> - Voir aussi <a href="../invoking.html">les <code>-d</code> - options de httpd</a>.</p> - - <p>Voir aussi <a - href="../misc/security_tips.html#serverroot">les trucs de - sécurité</a> pour plus d'informations sur comment - correctment définir les droits d'accès à - ServerRoot.</p> - <hr /> - - <h2><a id="serversignature" name="serversignature">Directive - ServerSignature</a></h2> - <!--%plaintext <?INDEX {\tt ServerSignature} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> ServerSignature On|Off|EMail<br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>ServerSignature Off</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôte virtuel, répertoire, .htaccess<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - ServerSignature est disponible à partir de la version - 1.3. - - <p>La directive ServerSignature permet la configuration d'une - ligne de bas de page pour les documents - générés par le serveur (messages d'erreur, - liste des répertoire ftp, affichage de mod_info, ...) - L'utilité de l'emploi d'une telle ligne apparaît - dans la cas d'enchaînement de proxy, où - l'utilisateuir souvent n'a aucune possibilité de - déterminer quel élément de la chaîne - de proxies a produit un message d'erreur.<br /> - La valeur par défaut <samp>Off</samp> supprime la ligne - d'erreur (et est compatible avec le comportement d'Apache 1.2 - et précédents). La valeur <samp>On</samp> ajoute - une ligne contenant la version du serveur, la valeur de <a - href="#servername">ServerName</a> de l'hôte virtuel et la - valeur <samp>EMail</samp> ajoute une référence - "mailto:" vers l'adresse <a href="#serveradmin">ServerAdmin</a> - du document demandé.</p> - <hr /> - - <h2><a id="servertokens" name="servertokens">Directive - ServerTokens</a></h2> - <!--%plaintext <?INDEX {\tt ServerTokens} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> ServerTokens Minimal|ProductOnly|OS|Full<br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>ServerTokens Full</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur <br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - ServerTokens est disponible à partir de la version 1.3 - d'Apache. Le mot clé <code>ProductOnly</code> est - disponible à pertir de la version 1.3.12 - - <p>Cette directive contrôle si le champ - <samp>Server</samp> de l'en-tête de réponse qui - est renvoyé aux clients inclut une description du type - de système de du serveur ainsi que des informations sur - les odules compilés.</p> - - <dl> - <dt><code>ServerTokens Prod[uctOnly]</code></dt> - - <dd>Le serveur renvoie par exemple : <samp>Server: - Apache</samp></dd> - - <dt><code>ServerTokens Min[imal]</code></dt> - - <dd>Le serveur renvoie par exemple : <samp>Server: - Apache/1.3.0</samp></dd> - - <dt><code>ServerTokens OS</code></dt> - - <dd>Le serveur renvoie par exemple : <samp>Server: - Apache/1.3.0 (Unix)</samp></dd> - - <dt><code>ServerTokens Full</code> (ou non - spécifié)</dt> - - <dd>Le serveur renvoie par exemple : <samp>Server: - Apache/1.3.0 (Unix) PHP/3.0 MyMod/1.2</samp></dd> - </dl> - - <p>Cette directive s'applique à la globalité du - serveur et ne paut pas être activé ou - désactivé sur la base d'hôtes virtuels.</p> - <hr /> - - <h2><a id="servertype" name="servertype">Directive - ServerType</a></h2> - <!--%plaintext <?INDEX {\tt ServerType} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> ServerType <em>type</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>ServerType standalone</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>La directive <tt>ServerType</tt> définit comment le - serveur est exécuté par le système - d'exploitation. <em>Type</em> peut prendre l'une des valeurs - suivantes :</p> - - <dl> - <dt>inetd</dt> - - <dd>Le serveur sera exécuté à partir du - processus system inetd ; la commande nécessaire au - démarrage du serveur devra être ajoutée - au fichier <code>/etc/inetd.conf</code></dd> - - <dt>standalone</dt> - - <dd>Le serveur est lancé en tant que démon ; la - commande de démarrage du serveur sera ajoutée - aux scripts de démarrage du système - d'exploitation. (<code>/etc/rc.local</code> ou - <code>/etc/rc3.d/...</code>.)</dd> - </dl> - - <p>Inetd est l'option la moins utilisée des deux. Pour - chaque connexion http demandée, une nouvelle instance du - serveur est créée ; une fois la connexion - établie, ce programme tourne. Ceci implique un - coût important en ressources pour chaque connexion, mais - certains administrateurs préfèrent parfois ce - mode pour des raisons de sécurité.</p> - - <p>Standalone est l'option la plus fréquente pour la - directive <tt>ServerType</tt> dans la mesure où ce - dernier est de loin plus performant. Le serveur n'est - démarré qu'une fois, et dessert toutes les - connexions ultérieures. Si vous utilisez Apache sur un - site très chargé, le mode standalone sera - certainement le seul choix possible.</p> - <hr /> - - <h2><a id="startservers" name="startservers">Directive - StartServers</a></h2> - <!--%plaintext <?INDEX {\tt StartServers} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> StartServers <em>nombre</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>StartServers 5</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>La directive <tt>StartServers</tt> définit le nombre - de processus fils créés dès le - démarrage du serveur. Le nombre de ces processus - étant contrôlé dynamiquement en fonction de - la charge, il y a en général peu - d'intérêt à modifier la valeur par - défaut de ce paramètre.</p> - - <p>Lorsque le serveur est exécuté sous Microsoft - Windows, cette directive n'a aucun effet. Comme la version - Windows d'Apache est écrite en multithread, un seul - processus gère l'intégralité des - requêtes. La directive <a - href="#threadsperchild">ThreadsPerChild</a> contrôle le - nombre maximal de threads traitant les requêtes, ce qui a - un effet similaire à la directive Unix - <samp>StartServers</samp></p> - - <p>Voir aussi <a href="#minspareservers">MinSpareServers</a> et - <a href="#maxspareservers">MaxSpareServers</a>.</p> - <hr /> - - <h2><a id="threadsperchild" name="threadsperchild">Directive - ThreadsPerChild</a></h2> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> ThreadsPerChild <em>nombre</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>ThreadsPerChild 50</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau (Windows)<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - Disponible seulement à partir de la version 1.3 pour - Windows d'Apache - - <p>Cette directive indique au serveur combien de threads il - doit lancer. Cela est équivalent au nombre maximum de - connexions que le serveur peut traiter simultanément ; - soyez sûr de vous et réglez le nombre suffisament - haut si votre site est très fréquenté.</p> - - <p>Cette directive n'a aucun effet sur les systèmes - Unix. Les utilisateurs Unix regarderont les directives <a - href="#startservers">StartServers</a> et <a - href="#maxrequestsperchild">MaxRequestsPerChild</a>.</p> - <hr /> - - <h2><a id="threadstacksize" name="threadstacksize">Directive - ThreadStackSize</a></h2> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> ThreadStackSize <em>nombre</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>ThreadStackSize 65536</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau (NetWare)<br /> - <strong>Compatibilité :</strong> disponible à - partir de la version d'Apache 1.3 sur Netware. - - <p>Cette directive indique la taille de la pile à - utiliser pour les threads. Si vous rencontrer un - problème de débordement de pile, vous devez - augmenter cette valeur.</p> - - <p>Cette directive n'a aucun effet sur les autres - systèmes.</p> - <hr /> - - <h2><a id="timeout" name="timeout">Directive TimeOut</a></h2> - <!--%plaintext <?INDEX {\tt TimeOut} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> TimeOut <em>nombre</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> <code>TimeOut - 300</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>La directive <tt>TimeOut</tt> définit la - temporisation courante pendant laquelle Apache attendra l'une - de ces trois choses :</p> - - <ol> - <li>Le temps total de réception d'une requête - GET.</li> - - <li>Le temps entre la réception de paquets TCP lors - d'une requête POST ou PUT.</li> - - <li>Le temps entre deux acquittements lors de la transmission - de paquets TCP de réponse.</li> - </ol> - - <p>Nous prévoyons dans le futur de permettre une - configuration individuelle de chacune de ces temporisations. La - valeur par défaut était de 1200 avant la version - 1.2, mais a été abaissée à 300 - depuis, ce qui est déjà largement plus que - nécessaire dans la plupart des situations. Il n'est - cependant pas réglé plus bas car il peut exister - (encore) des portions de code un peu "floues" par lesquelles le - temporisateur n'est pas remis à zéro lors de la - transmission d'un paquet.</p> - <hr /> - - <h2><a id="usecanonicalname" - name="usecanonicalname">UseCanonicalName directive</a></h2> - <!--%plaintext <?INDEX {\tt UseCanonicalName} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> UseCanonicalName on|off|dns<br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> - <code>UseCanonicalName on</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôte virtuel, répertoire<br /> - <a href="directive-dict.html#Override" - rel="Help"><strong>Surcharge :</strong></a> Options<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> - UseCanonicalName est disponible à partir de la verion - 1.3 - - <p>Dans beaucoup de situations, Apache doit construire des URL - <em>s'autoréférençant</em>, autremnet dit, - des URL référençant le même serveur. - Avec la directive <code>UseCanonicalName on</code> (dans les - versions d'Apache inférieures à 1.3) Apache - utilise les valeurs des directives <a - href="#servername">ServerName</a> et <a href="#port">Port</a> - pour construire un nom canonique du serveur. Ce nom est - utilisé pour toutes les URL autoréférentes - et pour les valeurs de <code>SERVER_NAME</code> et - <code>SERVER_PORT</code> pour les scripts CGI.</p> - - <p>Avec <code>UseCanonicalName off</code>, Apache formera les - URLS autoréférentes en utilisant le nom - d'hôte le numéro de port fourni par le client si - ceux ci sont fournis (sinon il utilisera le nom canonique). Ces - valeurs sont les mêmes qui sont employées pour - implémenter les <a - href="../vhosts/name-based.html">hôtes virtuels - basés sur des noms</a>, et sont disponibles pour les - mêmes clients. Les variable CGI <code>SERVER_NAME</code> - et <code>SERVER_PORT</code> seront aussi construites à - partir des valeurs fournies par les clients.</p> - - <p>Un exemple où cette directive est utile est le cas - d'un serveur intranet où des utilisateurs se connectent - à la machine en utilisant des noms courts tels que - <code>www</code>. Vous noterez que si l'utilisateur tape un nom - court et que l'URL est un répertoire tel que - <code>http://www/splat</code>, <em>sans le caractère - oblique / final</em> , Apache redirigera la requête vers - <code>http://www.domain.com/splat/</code>. Si vous avez une - authentification active, lu'tilisateur devra s'authentifier - deux fois, (une première fois pour <code>www</code> et - une deuxième fois pour An example where this may be - useful is on an intranet server where you have users connecting - to the machine using short names such as . You'll notice that - if the users type a <code>www.domain.com</code>). Mais si la - directive <code>UseCanonicalName</code> est à off, - Apache redirigera vers <code>http://www/splat/</code>.</p> - - <p>Il existe une troisième option, - <code>UseCanonicalName DNS</code>, qui est prévu pour - être employé avec de nombreux hôtes virtuels - basés sur les adresses IP afin de supporter les clients - qui ne fournissent pas d'en-tête <code>Host:</code>. Avec - cette option Apache effectue une résolution DNS inverse - sur l'adresse IP du serveur sur lequel le client se connecte - afin de travailler avec pour les URL - autoréférentes.</p> - - <p><strong>Attention :</strong> si les scripts CGI font des - suppositions sur les valeurs de <code>SERVER_NAME</code> il - peuvent ne plus fonctionner avec cette option. Mais le script - CGI utilise uniquement <code>SERVER_NAME</code> pour construire - des URL autoréférentes, il ne evrait y avoir - aucun problèmes.</p> - - <p><strong>Voir également :</strong> <a - href="#servername">ServerName</a>, <a href="#port">Port</a></p> - <hr /> - - <h2><a id="user" name="user">Directive User</a></h2> - <!--%plaintext <?INDEX {\tt User} directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> User <em>utilisateurUnix</em><br /> - <a href="directive-dict.html#Default" - rel="Help"><strong>Défaut :</strong></a> <code>User - #-1</code><br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur, hôte virtuel<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> noyau - - <p>La directive <tt>User</tt> définit l'utilisateur - associé au serveur. Pour utiliser cette directive, un - serveur standalone devra être lancé sous - <code>root</code>. <em>utilisateurUnix</em> est l'un parmi - :</p> - - <dl> - <dt>un nom d'utilisateur</dt> - - <dd>se réfère à un utilisateur - déclaré du système.</dd> - - <dt># suivi d'un numéro d'utilisateur.</dt> - - <dd>se réfère à l'utilisateur - déclaré du système portant ce - numéro.</dd> - </dl> - - <p>L'utilisateur peut n'avoir aucun privilège ce qui lui - permet néanmoins de pouvoir avoir accès à - des fichiers qui ne sont pas sensés être visibles - du "reste du monde", mais pas d'exécuter du code qui ne - serait pas explicitement exécutable par l'utilisateur - associé à httpd. Il est d'ailleurs - recommandé de créer un utilisateur et un groupe - specialement pour exécuter le serveur. Certains - administrateurs utilisent souvent l'utilisateur - <code>nobody</code>, mais ceci n'est pas toujours possible ou - souhaitable. Par exemple, le cache de mod_proxy quancd celui - est activé , doit être accessible à cette - utilisateur (voir la directive <a - href="mod_proxy.html#cacheroot"><code>CacheRoot</code></a> - ).</p> - - <p><strong>Note :</strong> si vous démarrez le serveur - sous un utilisateur non-root, la tentative pour passer sous un - utilisateur de moindre privilège échouera, et le - serveur continuera à sexécuter sous l'utilisateur - d'origine. Si vous démarrez le serveur sous - <code>root</code>, alors il sera normal que le processus - père continue à s'exécuter sous - <code>root</code>.</p> - - <p><strong>Note spécifique :</strong> L'utilisation de - cette directive dans une section <tt><VirtualHost></tt> - nécessite un <a href="../suexec.html">wrapper suEXEC</a> - correctement configuré. Lorsqu'elle est utilisée - de cette façon dans une section - <tt><VirtualHost></tt>, seul l'utilisateur associé - à l'exécution des scripts CGI est affecté. - Les requêtes non-CGI seront toujours traitées sous - l'utilisateur défini dans la directive User de la - section principale.</p> - - <p><strong>Sécurité :</strong> Ne - définissez pas l'utilisateur (ni le <a - href="#group">groupe</a>) comme <code>root</code> sauf si vous - savez exactement ce que vous faites, et si vous êtes - totalement conscients des risques qui sont encourus.</p> - <hr /> - - <h2><a id="virtualhost" name="virtualhost">Directive - <VirtualHost></a></h2> - <!--%plaintext <?INDEX {\tt VirtualHost} section directive> --> - <a href="directive-dict.html#Syntax" rel="Help"><strong>Syntaxe - :</strong></a> <VirtualHost <em>adresse</em>[:<em>port</em>] - ...> ... </VirtualHost> <br /> - <a href="directive-dict.html#Context" - rel="Help"><strong>Contexte :</strong></a> configuration - serveur<br /> - <a href="directive-dict.html#Status" rel="Help"><strong>Statut - :</strong></a> Core<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> la - "virtualisation" d'hôtes non basés sur l'adressage - IP n'est disponible qu'à partir de la version 1.1 - d'Apache<br /> - <a href="directive-dict.html#Compatibility" - rel="Help"><strong>Compatibilité :</strong></a> le - support d'adresses multiples n'est disponible qu'à - partir de la version 1.2 d'Apache - - <p>Les directives <VirtualHost> et </VirtualHost> - sont utilisées pour "encapsuler" un groupe de directives - qui s'appliquent à un hôte virtuel particulier. - Toute directive autorisée dans un contexte "hôte - virtuel" peut être présente. Lorsque le serveur - reçoit une requête demandant un document - spécifique sur un hôte virtuel spécifique, - il utilise les directives de configuration explicitées - dans la section <VirtualHost> correspondante. - <em>Adresse</em> peut être :</p> - - <ul> - <li>l'adresse IP de l'hôte virtuel</li> - - <li>un nom de domaine entièrement qualifié pour - l'adresse IP de cet hôte virtuel.</li> - </ul> - - <p>Exemple :</p> - - <blockquote> -<pre> -<code><VirtualHost 10.1.2.3> -ServerAdmin webmaster@host.foo.com -DocumentRoot /www/docs/host.foo.com -ServerName host.foo.com -ErrorLog logs/host.foo.com-error_log -TransferLog logs/host.foo.com-access_log -</VirtualHost> -</code> -</pre> - </blockquote> - - <p>Chaque hôte virtuel doit être associé - à une adresse IP, à un numéro de port ou - à un nom d'hôte différents que celui - attribué au serveur, dans le dernier cas la machine du - serveur doit être configurée pour accepter des - paquets IP sur plusieurs adresses. (Si la machine ne dispose - pas de plusieurs interfaces réseau physiques, ceci peut - être obtenu par la commande <code>ifconfig alias</code> - (si votre OS l'accepte), ou par des patchs du kernel du type <a - href="../misc/vif-info.html">VIF</a> (pour SunOS(TM) - 4.1.x)).</p> - - <p>Vous pouvez spécifier plus d'une adresse IP. Ceci - peut être utile si une machine répond au - même nom venant de deux différentes interfaces. - Par exemple, si vous avez un hôte virtuel qui est - accessible des hôtes à partir d'un réseau - interne (intranet) et externe (internet). Exemple :</p> - - <blockquote> - <code><VirtualHost 192.168.1.2 204.255.176.199><br /> - DocumentRoot /www/docs/host.foo.com<br /> - ServerName host.foo.com<br /> - ServerAlias host<br /> - </VirtualHost></code> - </blockquote> - - <p>Le nom prédéfini <code>_default_</code> peut - être attribué auquel cas cet hôte virtuel - lira toutes les adresses IP qui ne sont pas explicitement - listées dans les autres hôtes virtuels - définis. En l'absence d'un hôte virtuel _default_, - la configuration serveur "principale", à savoir toutes - les définitions en dehors des sections VirtualHost, - seront utilisées si aucun hôte virtuel ne - reconnaît l'adresse.</p> - - <p>Vous pouvez spécifier une commande <code>:port</code> - pour changer le port reconnu par l'hôte virtuel. Si aucun - port n'est mentionné, alors le port reconnu est par - défaut celui mentionné dans la dernière - directive de <code><a href="#port">Port</a></code> de la - section principale qui précède. Vous pouvez - également spécifier <code>:*</code> pour - reconnaître tous les ports à cette adresse. (Ceci - est conseillé lorsque l'hôte virtuel est le - <code>_default_</code>.)</p> - - <p><strong>Sécurité</strong>: Voir les <a - href="../misc/security_tips.html">conseils de - sécurité</a> pour plus de détails sur les - risques encourus si le répertoire contenant les fichiers - de trace peut être écrit par un autre utilisateur - que celui sous lequel est exécuté le serveur.</p> - - <p><strong>Note</strong>: L'utilisation de la directive - <VirtualHost> <strong>n'</strong> affecte - <strong>pas</strong> les adresses qu'écoute Apache. Vous - devez vous assurer que les adresses définies pour les - hôtes virtuels font aussi partie de l'ensemble des - adresses écoutées par Apache et définies - par des directives <a href="#bindaddress">BindAddress</a> ou <a - href="#listen">Listen</a>.</p> - - <p><strong>Voir aussi :</strong> <a - href="../vhosts/index.html">Hôtes virtuels sur - Apache</a><br /> - <a href="../dns-caveats.html">Avertissement concernant DNS et - Apache</a><br /> - <a href="../bind.html">Configurer les ports et adresses - utilisés par Apache</a></p> - - <p><strong>Voir aussi</strong> : <a - href="../sections.html">Comment fonctionnent les sections - concernant les répertoires, chemins et fichiers</a> pour - une explication plus précise concernant la - manière dont ces sections sont combinées - lorsqu'une requête est traitée. - <hr /> - - <h3 align="CENTER">Apache HTTP Server Version 1.3</h3> - <a href="./"><img src="../images/index.gif" alt="Index" /></a> - <a href="../"><img src="../images/home.gif" alt="Home" /></a> - - </p> - </body> -</html> - |