| Quellcodebibliothek Statistik Leitseite products/Sources/formale Sprachen/C/Apache/docs/manual/mod/ (Apache Software Stiftung Version 2.4.65©) Datei vom 12.6.2025 mit Größe 327 kB |
|
Quelle core.html.fr.utf8 Sprache: unbekannt |
|
|
Spracherkennung für: .utf8 vermutete Sprache: Unknown {[0] [0] [0]} [Methode: Schwerpunktbildung, einfache Gewichte, sechs Dimensionen] <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DT <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> <meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX --> <title>core - Serveur HTTP Apache Version 2.4</title> <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" titl <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="al <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/ <script src="../style/scripts/prettify.min.js" type="text/javascript"> </script> <link href="../images/favicon.ico" rel="shortcut icon" /></head> <body> <div id="page-header"> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> <p class="apache">Serveur HTTP Apache Version 2.4</p> <img alt="" src="../images/feather.png" /></div> <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> <div id="path"> <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTT <div id="page-content"> <div id="preamble"><h1>Fonctionalités de Base Apache</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../de/mod/core.html" hreflang="de" rel="altern <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English"> en </a> | <a href="../es/mod/core.html" hreflang="es" rel="alternate" title="Español"> es </a> | <a href="../fr/mod/core.html" title="Français"> fr </a> | <a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fo disponibles</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr></table> </div> <div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" clas <ul id="toc"> <li><img alt="" src="../images/down.gif" /> <a href="#acceptfilter">AcceptFilter</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#acceptpathinfo">AcceptPathInfo</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#accessfilename">AccessFileName</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#adddefaultcharset">AddDefaultCharset</ <li><img alt="" src="../images/down.gif" /> <a href="#allowencodedslashes">AllowEncodedSlas <li><img alt="" src="../images/down.gif" /> <a href="#allowoverride">AllowOverride</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#allowoverridelist">AllowOverrideList</ <li><img alt="" src="../images/down.gif" /> <a href="#cgimapextension">CGIMapExtension</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#cgipassauth">CGIPassAuth</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#cgivar">CGIVar</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#contentdigest">ContentDigest</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#defaultruntimedir">DefaultRuntimeDir</ <li><img alt="" src="../images/down.gif" /> <a href="#defaulttype">DefaultType</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#define">Define</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#directory"><Directory></a></li> <li><img alt="" src="../images/down.gif" /> <a href="#directorymatch"><DirectoryMatch></a></li> <li><img alt="" src="../images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#else"><Else></a></li> <li><img alt="" src="../images/down.gif" /> <a href="#elseif"><ElseIf></a></li> <li><img alt="" src="../images/down.gif" /> <a href="#enablemmap">EnableMMAP</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#enablesendfile">EnableSendfile</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#error">Error</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#errordocument">ErrorDocument</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#errorlog">ErrorLog</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#errorlogformat">ErrorLogFormat</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#extendedstatus">ExtendedStatus</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#fileetag">FileETag</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#files"><Files></a></li> <li><img alt="" src="../images/down.gif" /> <a href="#filesmatch"><FilesMatch></a></li> <li><img alt="" src="../images/down.gif" /> <a href="#flushmaxpipelined">FlushMaxPipelined</ <li><img alt="" src="../images/down.gif" /> <a href="#flushmaxthreshold">FlushMaxThreshold</ <li><img alt="" src="../images/down.gif" /> <a href="#forcetype">ForceType</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#gprofdir">GprofDir</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#hostnamelookups">HostnameLookups</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#httpprotocoloptions">HttpProtocolOpti <li><img alt="" src="../images/down.gif" /> <a href="#if"><If></a></li> <li><img alt="" src="../images/down.gif" /> <a href="#ifdefine"><IfDefine></a></li> <li><img alt="" src="../images/down.gif" /> <a href="#ifdirective"><IfDirective></a></li> <li><img alt="" src="../images/down.gif" /> <a href="#iffile"><IfFile></a></li> <li><img alt="" src="../images/down.gif" /> <a href="#ifmodule"><IfModule></a></li> <li><img alt="" src="../images/down.gif" /> <a href="#ifsection"><IfSection></a></li> <li><img alt="" src="../images/down.gif" /> <a href="#include">Include</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#includeoptional">IncludeOptional</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#keepalive">KeepAlive</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#keepalivetimeout">KeepAliveTimeout</a></ <li><img alt="" src="../images/down.gif" /> <a href="#limit"><Limit></a></li> <li><img alt="" src="../images/down.gif" /> <a href="#limitexcept"><LimitExcept></a></li> <li><img alt="" src="../images/down.gif" /> <a href="#limitinternalrecursion">LimitInternal <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestbody">LimitRequestBody</a></ <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestfields">LimitRequestField <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestfieldsize">LimitRequestFi <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestline">LimitRequestLine</a></ <li><img alt="" src="../images/down.gif" /> <a href="#limitxmlrequestbody">LimitXMLRequestB <li><img alt="" src="../images/down.gif" /> <a href="#location"><Location></a></li> <li><img alt="" src="../images/down.gif" /> <a href="#locationmatch"><LocationMatch></a></li> <li><img alt="" src="../images/down.gif" /> <a href="#loglevel">LogLevel</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#maxkeepaliverequests">MaxKeepAliveReq <li><img alt="" src="../images/down.gif" /> <a href="#maxrangeoverlaps">MaxRangeOverlaps</a></ <li><img alt="" src="../images/down.gif" /> <a href="#maxrangereversals">MaxRangeReversals</ <li><img alt="" src="../images/down.gif" /> <a href="#maxranges">MaxRanges</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#mergeslashes">MergeSlashes</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#mergetrailers">MergeTrailers</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#mutex">Mutex</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#namevirtualhost">NameVirtualHost</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#protocol">Protocol</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#protocols">Protocols</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#protocolshonororder">ProtocolsHonorOr <li><img alt="" src="../images/down.gif" /> <a href="#qualifyredirecturl">QualifyRedirectUR <li><img alt="" src="../images/down.gif" /> <a href="#readbuffersize">ReadBufferSize</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#regexdefaultoptions">RegexDefaultOpti <li><img alt="" src="../images/down.gif" /> <a href="#registerhttpmethod">RegisterHttpMetho <li><img alt="" src="../images/down.gif" /> <a href="#rlimitcpu">RLimitCPU</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#rlimitmem">RLimitMEM</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#rlimitnproc">RLimitNPROC</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#scriptinterpretersource">ScriptInterp <li><img alt="" src="../images/down.gif" /> <a href="#seerequesttail">SeeRequestTail</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#serveradmin">ServerAdmin</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#serveralias">ServerAlias</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#servername">ServerName</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#serverpath">ServerPath</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#serverroot">ServerRoot</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#serversignature">ServerSignature</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#servertokens">ServerTokens</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#sethandler">SetHandler</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#setinputfilter">SetInputFilter</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#setoutputfilter">SetOutputFilter</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#stricthostcheck">StrictHostCheck</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#timeout">TimeOut</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#traceenable">TraceEnable</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#unclist">UNCList</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#undefine">UnDefine</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#usecanonicalname">UseCanonicalName</a></ <li><img alt="" src="../images/down.gif" /> <a href="#usecanonicalphysicalport">UseCanonica <li><img alt="" src="../images/down.gif" /> <a href="#virtualhost"><VirtualHost></a></li> </ul> <h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/http <ul class="seealso"> <li><a href="#comments_section">Commentaires</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="acceptfilter" id="acceptfilter">Directive</a> <a n <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet d'optimiser l l'écoute d'un protocole</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AcceptFilter <var>protocol d'acceptation</var></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></t <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> <p>Cette directive permet d'effectuer une optimisation de la socket d'écoute d'un type de protocole en fonction du système d'exploitation. Le but premier est de faire en sorte que le noyau n'envoie pas de socket au processus du serveur jusqu'à ce que des données soient reçues, ou qu'une requête HTTP complète soit mise en tampon. Seuls les <a href="http://www.freebsd.org/cgi/man.cgi?query=accept_filter& se primitif <code>TCP_DEFER_ACCEPT</code> sous Linux, et la version optimisée d'AcceptEx() de Windows sont actuellement supportés.</p> <p>L'utilisation de l'argument <code>none</code> va désactiver tout filtre d'acceptation pour ce protocole. Ceci s'avère utile pour les protocoles qui nécessitent l'envoi de données par le serveur en premier, comme <code>ftp:</code> ou <code>nntp</code>:</p> <pre class="prettyprint lang-config">AcceptFilter nntp none</pre> <p>Les noms de protocoles par défaut sont <code>https</code> pour le port 443 et <code>http</code> pour tous les autres ports. Pour spécifier un autre protocole à utiliser avec un port en écoute, ajoutez l'argument <var>protocol</var> à la directive <code class="directive"><a href="../mod/mp <p>Sous FreeBSD, les valeurs par défaut sont :</p> <pre class="prettyprint lang-config">AcceptFilter http httpready AcceptFilter https dataready</pre> <p>Le filtre d'acceptation <code>httpready</code> met en tampon des requêtes HTTP entières au niveau du noyau. Quand une requête entière a été reçue, le noyau l'envoie au serveur. Voir la page de manuel de <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_http& sektion=9">accf_ HTTPS sont chiffrées, celles-ci n'autorisent que le filtre <a href="http://www.freebsd.org/ <p>Sous Linux, les valeurs par défaut sont :</p> <pre class="prettyprint lang-config">AcceptFilter http data AcceptFilter https data</pre> <p>Le filtre <code>TCP_DEFER_ACCEPT</code> de Linux ne supporte pas la mise en tampon des requêtes http. Toute valeur autre que <code>none</code> active le filtre <code>TCP_DEFER_ACCEPT</code> pour ce protocole. Pour plus de détails, voir la page de manuel Linux de <a href="http://man7.org/linux/man-pages/man7/tcp.7.html">tcp(7)</a>.</p> <p>Sous Windows, les valeurs par défaut sont :</p> <pre class="prettyprint lang-config">AcceptFilter http connect AcceptFilter https connect</pre> <p>Le module MPM pour Windows mpm_winnt utilise la directive AcceptFilter comme commutateur de l'API AcceptEx(), et ne supporte pas la mise en tampon du protocole http. <code>connect</code> utilise l'API AcceptEx(), extrait aussi les adresses réseau finales, mais à l'instar de <code>none</code>, la valeur <code>connect</code> n'attend pas la transmission des données initiales.</p> <p>Sous Windows, <code>none</code> utilise accept() au lieu d'AcceptEx(), et ne recycle pas les sockets entre les connexions. Ceci s'avère utile pour les interfaces réseau dont le pilote est défectueux, ainsi que pour certains fournisseurs de réseau comme les pilotes vpn, ou les filtres anti-spam, anti-virus ou anti-spyware.</p> <div class="warning"> <h3>L'AcceptFilter <code>data</code> (Windows)</h3> <p>Jusqu'à la version 2.4.23, le filtre d'acceptation <code>data</code> attendait que des données aient été transmises et que le tampon de données initial et l'adresse réseau finale aient été déterminés par l'invocation AcceptEx(). Cette implémentation étant vulnérable à une attaque de type denial of service, elle a été désactivée.</p> <p>La version actuelle de httpd prend par défaut le filtre <code>connect</code> sous Windows, et reprendra la valeur <code>data</code> si <code>data</code> est spécifié. Il est fortement conseillé aux utilisateurs des versions plus anciennes de définir explicitement le filtre <code>connect</code> pour leurs AcceptFilter comme indiqué plus haut.</p> </div> <h3>Voir aussi</h3> <ul> <li><code class="directive"><a href="#protocol">Protocol</a></code></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="acceptpathinfo" id="acceptpathinfo">Directive< <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les ressources accep nom de chemin en fin de requête.</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AcceptPathInfo On|Off|De <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AcceptPathInfo Default</co <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></t <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> <p>Cette directive permet de définir si les requêtes contenant des informations sous forme d'un nom de chemin suivant le nom d'un fichier réel (ou un fichier qui n'existe pas dans un répertoire qui existe) doivent être acceptées ou rejetées. Les scripts peuvent accéder à cette information via la variable d'environnement <code>PATH_INFO</code>.</p> <p>Supposons par exemple que <code>/test/</code> pointe vers un répertoire qui ne contient que le fichier <code>here.html</code>. Les requêtes pour <code>/test/here.html/more</code> et <code>/test/nothere.html/more</code> vont affecter la valeur <code>/more</code> à la variable d'environnement <code>PATH_INFO</code>.</p> <p>L'argument de la directive <code class="directive">AcceptPathInfo</code> possède trois valeurs possibles :</p> <dl> <dt><code>Off</code></dt><dd>Une requête ne sera acceptée que si elle correspond à un chemin qui existe. Par conséquent, une requête contenant une information de chemin après le nom de fichier réel comme <code>/test/here.html/more</code> dans l'exemple ci-dessus renverra une erreur "404 NOT FOUND".</dd> <dt><code>On</code></dt><dd>Une requête sera acceptée si la partie principale du chemin correspond à un fichier existant. Dans l'exemple ci-dessus <code>/test/here.html/more</code>, la requête sera acceptée si <code>/test/here.html</code> correspond à un nom de fichier valide.</dd> <dt><code>Default</code></dt><dd>Le traitement des requêtes est déterminé par le <a href="../handler.html">gestionnaire</a> responsable de la requête. Le gestionnaire de base pour les fichiers normaux rejette par défaut les requêtes avec <code>PATH_INFO</code>. Les gestionnaires qui servent des scripts, comme<a href="mod_cgi.html">cgi-script</a> et <a href="mod_isapi.html">i défaut les requêtes avec <code>PATH_INFO</code>.</dd> </dl> <p>Le but premier de la directive <code>AcceptPathInfo</code> est de vous permettre de remplacer le choix du gestionnaire d'accepter ou de rejeter <code>PATH_INFO</code>. Ce remplacement est nécessaire par exemple, lorsque vous utilisez un <a href="../filter.html">filtre</a>, comme <a href="mod_i sur <code>PATH_INFO</code>. Le gestionnaire de base va en général rejeter la requête, et vous pouvez utiliser la configuration suivante pour utiliser un tel script :</p> <pre class="prettyprint lang-config"><Files "mypaths.shtml"> Options +Includes SetOutputFilter INCLUDES AcceptPathInfo On </Files></pre> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="accessfilename" id="accessfilename">Directive< <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom du fichier de conf <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AccessFileName <var>nom-du [<var>nom-du-fichier</var>] ...</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AccessFileName .htaccess</ <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> <p>Au cours du traitement d'une requête, le serveur recherche le premier fichier de configuration existant à partir de la liste de noms dans chaque répertoire composant le chemin du document, à partir du moment où les fichiers de configuration distribués sont <a href="#allowoverride">acti :</p> <pre class="prettyprint lang-config">AccessFileName .acl</pre> <p>avant de renvoyer le document <code>/usr/local/web/index.html</code>, le serveur va rechercher les fichiers <code>/.acl</code>, <code>/usr/.acl</code>, <code>/usr/local/.acl</code> et <code>/usr/local/web/.acl</code> pour y lire d'éventuelles directives, à moins quelles n'aient été désactivées avec</p> <pre class="prettyprint lang-config"><Directory "/"> AllowOverride None </Directory></pre> <h3>Voir aussi</h3> <ul> <li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li> <li><a href="../configuring.html">Fichiers de configuration</a></li> <li><a href="../howto/htaccess.html">Fichiers .htaccess</a></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="adddefaultcharset" id="adddefaultcharset">Dir <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Paramètre jeu de carac type de contenu d'une réponse est <code>text/plain</code> ou <code>text/html</code></td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddDefaultCharset On|Off <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AddDefaultCharset Off</cod <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></t <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> <p>Cette directive spécifie une valeur par défaut pour le paramètre jeu de caractères du type de média (le nom d'un codage de caractères) à ajouter à une réponse, si et seulement si le type de contenu de la réponse est soit <code>text/plain</code>, soit <code>text/html</code>. Ceci va remplacer tout jeu de caractères spécifié dans le corps de la réponse via un élément <code>META</code>, bien que cet effet dépende en fait souvent de la configuration du client de l'utilisateur. La définition de <code>AddDefaultCharset Off</code> désactive cette fonctionnalité. <code>AddDefaultCharset On</code> ajoute un jeu de caractères par défaut de <code>iso-8859-1</code>. Toute autre valeur peut être définie via le paramètre <var>jeu de caractères</var>, qui doit appartenir à la liste des <a href="http://www.iana.org/assignments/character-sets">va jeux de caractères enregistrés par l'IANA</a> à utiliser dans les types de média Internet (types MIME). Par exemple :</p> <pre class="prettyprint lang-config">AddDefaultCharset utf-8</pre> <p>La directive <code class="directive">AddDefaultCharset</code> ne doit être utilisée que lorsque toutes les ressources textes auxquelles elle s'applique possèdent le jeu de caractère spécifié, et qu'il est trop contraignant de définir leur jeu de caractères individuellement. Un exemple de ce type est l'ajout du paramètre jeu de caractères aux ressources comportant un contenu généré, comme les scripts CGI hérités qui peuvent être vulnérables à des attaques de type cross-site scripting à cause des données utilisateurs incluses dans leur sortie. Notez cependant qu'une meilleur solution consiste à corriger (ou supprimer) ces scripts, car la définition d'un jeu de caractères par défaut ne protège pas les utilisateurs qui ont activé la fonctionnalité "Détection automatique de l'encodage des caractères" dans leur navigateur.</p> <h3>Voir aussi</h3> <ul> <li><code class="directive"><a href="../mod/mod_mime.html#addcharset">AddCharset</a></code></ </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="allowencodedslashes" id="allowencodedslashes <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si les sépara autorisés à transiter dans les URLs tels quels</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowEncodedSlashes On|O <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AllowEncodedSlashes Off</c <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>L'option NoDecod 2.3.12.</td></tr> </table> <p>La directive <code class="directive">AllowEncodedSlashes</code> permet l'utilisation des URLs contenant des séparateurs de chemin encodés dans la partie chemin (<code>%2F</code> pour <code>/</code> et même <code>%5C</code> pour <code>\</code> sur les systèmes concernés).</p> <p>Avec la valeur par défaut, <code>Off</code>, de telles URLs sont refusées et provoquent le renvoi d'une erreur 404 (Not found).</p> <p>Avec la valeur <code>On</code>, ces URLs sont acceptées, et les slashes encodés sont décodés comme tout autre caractère codé.</p> <p>Avec la valeur <code>NoDecode</code>, ces URLs sont acceptées, mais les slashes codés ne sont pas décodés et laissés dans leur état codé.</p> <p>Définir <code class="directive">AllowEncodedSlashes</code> à <code>On</code> est surtout utile en association avec <code>PATH_INFO</code>.</p> <div class="note"><h3>Note</h3> <p>Si le codage des slashes dans la partie chemin est nécessaire, l'utilisation de l'option <code>NoDecode</code> est fortement recommandée par mesure de sécurité. Permettre le décodage des slashes pourrait éventuellement induire l'autorisation de chemins non sûrs.</p> </div> <h3>Voir aussi</h3> <ul> <li><code class="directive"><a href="#acceptpathinfo">AcceptPathInfo</a></code></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="allowoverride" id="allowoverride">Directive</a> < <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Types de directives a <code>.htaccess</code></td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowOverride All|None|<v [<var>type directive</var>] ...</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AllowOverride None à partir d All pour les versions antérieures</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> <p>Lorsque le serveur trouve un fichier <code>.htaccess</code> (dont le nom est défini par la directive <code class="directive"><a href="#accessfilename">AccessFil des directives placées dans ce fichier sont autorisées à modifier la configuration préexistante.</p> <div class="note"><h3>Valable seulement dans les sections <Directory></h3> La directive <code class="directive">AllowOverride</code> ne peut être utilisée que dans les sections <code class="directive"><a href="#directory"><Directory></a></code> rationnelles, et non dans les sections <code class="directive"><a href="#location"><Location></ <code class="directive"><a href="#files"><Files></a></code>. </div> <p>Lorsque cette directive et la directive <code class="directive"><a href="#allowoverridelis fichiers <a href="#accessfilename">.htaccess</a> sont totalement ignorés. Dans ce cas, le serveur n'essaiera même pas de lire les fichiers <code>.htaccess</code> du système de fichiers.</p> <p>Lorsque cette directive est définie à <code>All</code>, toute directive valable dans le <a href="directive-dict.html#Context">Contexte</a> .htaccess sera autorisée dans les fichiers <code>.htaccess</code>.</p> <p>L'argument <var>type directive</var> peut contenir les groupements de directives suivants (voir <a href="overrides.html">ce document</a> pour obtenir la liste à jour des directives activées pour chaque type de directive) :</p> <dl> <dt><a href="overrides.html#override-authconfig">AuthConfig</a></dt> <dd> Permet l'utilisation des directives d'autorisation (<code class="directive"><a href="../mo <code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUse <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGr <code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code>, <code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code>, < <dt><a href="overrides.html#override-fileinfo">FileInfo</a></dt> <dd> Permet l'utilisation des directives qui contrôlent les types de documents (directives <code class="directive"><a href="#errordocument">ErrorDocument</a></c <code class="directive"><a href="#sethandler">SetHandler</a></code>, <code class="directive"><a module <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> Add* et Remove* des documents (<code class="directive"><a href="../mod/mod_headers.html#header">Header</a>< module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> directi module <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> directives (< <code class="directive"><a href="../mod/mod_actions.html#action">Action</a></code> du module <code class="module"><a href="../mod/mod_actions.html">mod_actions</a></code>. </dd> <dt><a href="overrides.html#override-indexes">Indexes</a></dt> <dd> Permet l'utilisation des directives qui contrôlent l'indexation des répertoires (<code class="directive"><a href="../mod/mod_autoindex.html#adddescripti <code class="directive"><a href="../mod/mod_autoindex.html#addicon">AddIcon</a></code>, <cod <code class="directive"><a href="../mod/mod_autoindex.html#addiconbytype">AddIconByTyp <code class="directive"><a href="../mod/mod_autoindex.html#defaulticon">DefaultIcon</a></ <code class="directive"><a href="../mod/mod_autoindex.html#headername">HeaderName</a></co <em>etc...</em>).</dd> <dt><a href="overrides.html#override-limit">Limit</a></dt> <dd> Permet l'utilisation des directives contrôlant l'accès au serveur (<code class="directive"><a href="../mod/mod_access_compat.html#allow">Allow</a></code>, <co <dt>Nonfatal=[Override|Unknown|All]</dt> <dd> Permet d'utiliser l'option AllowOverride pour rendre les erreurs de syntaxe non fatales dans les fichiers .htaccess : au lieu de causer une Internal Server Error, les directives non autorisées ou non reconnues seront ignorées et un avertissement enregistré dans le journal : <ul> <li><strong>Nonfatal=Override</strong> rend les directives interdite par AllowOverride non fatales.</li> <li><strong>Nonfatal=Unknown</strong> rend les directives inconnues non fatales. Sont concernées les erreurs de frappe et les directives implémentées par un module non chargé.</li> <li><strong>Nonfatal=All</strong> rend toutes les directives précédentes non fatales.</li> </ul> <p>Notez qu'une erreur de syntaxe dans une directive valide causera toujours une internal server error.</p> <div class="warning"><h3>Sécurité</h3> Les erreurs non fatales peuvent être à l'origine de problèmes de sécurité pour les utilisateurs de fichiers .htaccess. Par exemple, si AllowOverride interdit AuthConfig, toute configuration utilisateur destinée à restreindre l'accès à un site ne sera pas prise en compte. </div> </dd> <dt><a href="overrides.html#override-options">Options</a>[=<var>Option</var>,...]</dt> <dd> Permet l'utilisation des directives contrôlant les fonctionnalités spécifiques d'un répertoire (<code class="directive"><a href="#options">Options</a></code> et <cod suivi d'un signe "égal", puis d'une liste d'options séparées par des virgules (pas d'espaces) ; ces options doivent être définies à l'aide de la commande <code class="directive"><a href="#options">Options</a></code>. <div class="note"><h3>Désactivation implicite des options</h3> <p>Bien que la liste des options disponibles dans les fichiers .htaccess puisse être limitée par cette directive, tant qu'un directive <code class="directive"><a href="#options">Options</a></code> est autorisée, toute autre option héritée peut être désactivée en utilisant la syntaxe non-relative. En d'autres termes, ce mécanisme ne peut pas forcer une option spécifique à rester <em>activée</em> tout en permettant à toute autre option d'être activée. </p></div> <pre class="prettyprint lang-config">AllowOverride Options=Indexes,MultiViews</pre> </dd> </dl> <p>Exemple :</p> <pre class="prettyprint lang-config">AllowOverride AuthConfig Indexes</pre> <p>Dans l'exemple ci-dessus, toutes les directives qui ne font partie ni du groupe <code>AuthConfig</code>, ni du groupe <code>Indexes</code>, provoquent une erreur "internal server error".</p> <div class="note"><p>Pour des raisons de sécurité et de performance, ne définissez pas <code>AllowOverride</code> à autre chose que <code>None</code> dans votre bloc <code><Directory "/"></code>. Recherchez plutôt (ou créez) le bloc <code><Directory></code> qui se réfère au répertoire où vous allez précisément placer un fichier <code>.htaccess</code>.</p> </div> <h3>Voir aussi</h3> <ul> <li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li> <li><code class="directive"><a href="#allowoverridelist">AllowOverrideList</a></code></li> <li><a href="../configuring.html">Fichiers de configuration</a></li> <li><a href="../howto/htaccess.html">Fichiers .htaccess</a></li> <li><a href="overrides.html">Override Class Index for .htaccess</a></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="allowoverridelist" id="allowoverridelist">Dir <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directives autorisée <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowOverrideList None|<v [<var>directive-type</var>] ...</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AllowOverrideList None</co <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> <p>Lorsque le serveur trouve un fichier <code>.htaccess</code> (comme spécifié par la directive <code class="directive"><a href="#accessfilename">AccessFile des directives déclarées dans ce fichier peuvent remplacer des directives des fichiers de configuration du serveur.</p> <div class="note"><h3>Seulement disponible dans les sections <Directory></h3> La directive <code class="directive">AllowOverrideList</code> n'est disponible que dans les sections <code class="directive"><a href="#directory"><Directory></a></c rationnelles. </div> <p>Lorsque cette directive et la directive <code class="directive"><a href="#allowoverride">Al <code>None</code>, les fichiers <a href="#accessfilename">.htaccess</a> sont totalement ignorés. ce cas, le serveur ne cherchera même pas à lire des fichiers <code>.htaccess</code> dans le système de fichiers.</p> <p>Example:</p> <pre class="prettyprint lang-config">AllowOverride None AllowOverrideList Redirect RedirectMatch</pre> <p>Dans l'exemple ci-dessus, seules les directives <code>Redirect</code> et <code>RedirectMatch</code> sont autorisées. Toutes les autres provoqueront une erreur interne du serveur.</p> <p>Example:</p> <pre class="prettyprint lang-config">AllowOverride AuthConfig AllowOverrideList CookieTracking CookieName</pre> <p>Dans l'exemple ci-dessus, la directive <code class="directive"><a href="#allowoverride">Al groupement <code>AuthConfig</code>, et <code class="directive">AllowOverrideList</code> n'autorise que deux directives du groupement <code>FileInfo</code>. Toutes les autres provoqueront une erreur interne du serveur.</p> <h3>Voir aussi</h3> <ul> <li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li> <li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li> <li><a href="../configuring.html">Fichiers de configuration</a></li> <li><a href="../howto/htaccess.html">Fichiers .htaccess</a></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="cgimapextension" id="cgimapextension">Directi <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Technique permettan scripts CGI</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CGIMapExtension <var>chemi <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></t <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>NetWare uniqueme </table> <p>Cette directive permet de contrôler la manière dont Apache httpd trouve l'interpréteur servant à exécuter les scripts CGI. Par exemple, avec la définition <code>CGIMapExtension sys:\foo.nlm .foo</code>, tous les fichiers scripts CGI possédant une extension <code>.foo</code> seront passés à l'interpréteur FOO.</p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="cgipassauth" id="cgipassauth">Directive</a> <a nam <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la transmissi tant que variables CGI</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CGIPassAuth On|Off</code></ <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CGIPassAuth Off</code></td></t <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>AuthConfig</td>< <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à parti Apache</td></tr> </table> <p>La directive <code class="directive">CGIPassAuth</code> permet aux scripts d'accéder aux en-têtes d'autorisation HTTP tels que <code>Authorization</code>, en-tête nécessaire aux scripts qui implémente une authentification HTTP de base. Normalement, ces en-têtes HTTP sont invisibles pour les scripts car ils leurs permettraient de voir les identifiants et mots de passe utilisés pour accéder au serveur lorsque l'authentification HTTP de base est activée au niveau du serveur web. Cette directive doit être définie à "On" lorsque des scripts sont autorisés à implémenter une authentification HTTP de base.</p> <p>Cette directive constitue une alternative à l'option de compilation <code>SECURITY_HOLE_PASS_AUTHORIZATION</code> qui était déjà disponible dans les versions précédentes du serveur HTTP Apache.</p> <p>Cette option est prise en compte par tout module qui utilise <code>ap_add_common_vars()</code>, comme <code class="module"><a href="../mod/mod_cgi.html"> <code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code>, <code class="module">< <code class="module"><a href="../mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code>, etc... les modules qui ne traitent pas à proprement parler les requêtes, mais utilisent quand-même cette API, comme <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> ou <code class=" modules tiers qui n'utilisent pas <code>ap_add_common_vars()</code> peuvent aussi choisir de prendre en compte cette option.</p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="cgivar" id="cgivar">Directive</a> <a name="CGIVar" <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contrôle la manière don <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CGIVar <var>variable</var> <va <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></t <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à parti </table> <p>Cette directive permet de contrôler la manière dont certaines variables CGI sont définies.</p> <p>règles <strong>REQUEST_URI</strong> :</p> <dl> <dt><code>original-uri</code> (valeur par défaut)</dt> <dd>La valeur est extraite de la requête originale, et ne tient pas compte des redirections internes ou des sous-requêtes qui pourraient modifier la ressource demandée.</dd> <dt><code>current-uri</code></dt> <dd>La valeur reflète la ressource en cours de traitement ; elle peut être différente de la ressource demandée dans la requête initiale du client suite à d'éventuelles redirections internes ou sous-requêtes.</dd> </dl> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="contentdigest" id="contentdigest">Directive</a> < <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la génération d' dans la réponse HTTP</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ContentDigest On|Off</cod <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ContentDigest Off</code></td>< <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>Options</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> <p>Cette directive active la génération d'un en-tête <code>Content-MD5</code> selon les définitions des RFC 1864 et 2616.</p> <p>MD5 est un algorithme permettant de générer un condensé (parfois appelé "empreinte") à partir de données d'une taille aléatoire ; le degré de précision est tel que la moindre altération des données d'origine entraîne une altération de l'empreinte.</p> <p>L'en-tête <code>Content-MD5</code> permet de vérifier l'intégrité de la réponse HTTP dans son ensemble. Un serveur mandataire ou un client peut utiliser cet en-tête pour rechercher une éventuelle modification accidentelle de la réponse au cours de sa transmission. Exemple d'en-tête :</p> <div class="example"><p><code> Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA== </code></p></div> <p>Notez que des problèmes de performances peuvent affecter votre serveur, car l'empreinte est générée pour chaque requête (il n'y a pas de mise en cache).</p> <p>L'en-tête <code>Content-MD5</code> n'est envoyé qu'avec les documents servis par le module <code class="module"><a href="../mod/core.html">core</a></code>, à de tout autre module. Ainsi, les documents SSI, les sorties de scripts CGI, et les réponses à des requêtes partielles (byte range) ne comportent pas cet en-tête.</p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="defaultruntimedir" id="defaultruntimedir">Dir <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Répertoire de base des <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultRuntimeDir <var>che <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DefaultRuntimeDir DEFAULT <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></t <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depui </table> <p>La directive <code class="directive">DefaultRuntimeDir</code> permet de définir le répertoire dans lequel le serveur va créer les différents fichiers relatifs à son exécution (mémoire partagée, verrous, etc...). Si le chemin spécifié est relatif, le chemin absolu sera généré relativement à la valeur de la directive <code class="directive">ServerRoot</code></p> <p><strong>Example</strong></p> <pre class="prettyprint lang-config">DefaultRuntimeDir scratch/</pre> <p>La valeur par défaut de la directive <code class="directive">DefaultRuntimeDir</code> peut être modifiée en changeant la valeur de la macro <code>DEFAULT_REL_RUNTIMEDIR</code> définie à la compilation.</p> <p>Note: si la valeur de <code class="directive">ServerRoot</code> n'a pas été spécifiée avant d'utiliser cette directive, c'est la valeur par défaut de <code class="directive">ServerRoot</code> qui sera utilisée pour définir la base du répertoire.</p> <h3>Voir aussi</h3> <ul> <li>Voir les <a href="../misc/security_tips.html#serverroot">conseils à propos de sésurité</a> pour plus d'informations en vue de définir correctement les permissions sur la racine du serveur <code class="directive">ServerRoot</code></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="defaulttype" id="defaulttype">Directive</a> <a nam <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les seuls effets de ce d'avertissements si sa valeur est différente de <code>none</code>. Dans les versions précédentes, DefaultType permettait de spécifier un type de média à assigner par défaut au contenu d'une réponse pour lequel aucun autre type de média n'avait été trouvé. </td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultType <var>type média| <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DefaultType none</code></td></ <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></t <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>L'argument <code>n versions d'Apache httpd 2.2.7 et supérieures. Tous les autres choix sont DESACTIVÉS à partir des version 2.3.x.</td></tr> </table> <p>Cette directive a été désactivée. Pour la compatibilité ascendante avec les anciens fichiers de configuration, elle peut être spécifiée avec la valeur <code>none</code>, c'est à dire sans type de médium par défaut. Par exemple :</p> <pre class="prettyprint lang-config">DefaultType None</pre> <p><code>DefaultType None</code> n'est disponible que dans les versions d'Apache 2.2.7 et supérieures.</p> <p>Utilisez le fichier de configuration mime.types et la directive <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code> pour confi l'assignement d'un type de médium via les extensions de fichiers, ou la directive <code class="directive"><a href="#forcetype">ForceType</a></code> pour attribuer un type de médium à des ressources spécifiques. Dans le cas contraire, le serveur enverra sa réponse sans champ d'en-tête Content-Type, et le destinataire devra déterminer lui-même le type de médium.</p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="define" id="define">Directive</a> <a name="Define" <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet de définir une v <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Define <var>nom-paramètre</v <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> <p>Avec un seul paramètre, l'effet de la directive <code class="directive">Define</code> est identique à celui de l'argument <code>-D</code> du programme <code class="program"><a href="../programs/httpd.html">httpd</a></c modifier le comportement des sections <code class="directive"><a href="#ifdefine"><IfDefine></ <code>-D</code> au sein des scripts de démarrage.</p> <p>De plus, le second paramètre permet d'affecter une valeur à la variable définie par le premier. Cette variable peut être référencée dans le fichier de configuration via la syntaxe <code>${VAR}</code>. La portée de la variable est toujours globale, et n'est jamais limitée à la section de configuration courante.</p> <pre class="prettyprint lang-config"><IfDefine TEST> Define servername test.example.com </IfDefine> <IfDefine !TEST> Define servername www.example.com Define SSL </IfDefine> DocumentRoot "/var/www/${servername}/htdocs"</pre> <p>Le caractère ":" est interdit dans les noms de variables afin d'éviter les conflits avec la syntaxe de la directive <code class="directive"><a href="../mod/m <div class="note"><h3>Portée de la directive et pièges à éviter</h3> <p>Si cette directive est définie au sein d'un bloc VirtualHost, les changements qu'elle induit sont visibles de toute directive ultérieure, au delà de tout bloc VirtualHost.</p> </div> <h3>Voir aussi</h3> <ul> <li><code class="directive"><a href="#undefine">UnDefine</a></code></li> <li><code class="directive"><a href="#ifdefine">IfDefine</a></code></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="directory" id="directory">Directive</a> <a name="D <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe un ensemble qu'au répertoire concerné du système de fichiers, à ses sous-répertoires, et à leur contenu.</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Directory <var>chemin répert ... </Directory></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> <p>Les balises <code class="directive"><Directory></code> et <code></Directory></code> permettent de regrouper un ensemble de directives qui ne s'appliquent qu'au répertoire précisé, à ses sous-répertoires, et aux fichiers situés dans ces sous-répertoires. Toute directive autorisée dans un contexte de répertoire peut être utilisée. <var>chemin répertoire</var> est soit le chemin absolu d'un répertoire, soit une chaîne de caractères avec caractères génériques utilisant la comparaison Unix de style shell. Dans une chaîne de caractères avec caractères génériques, <code>?</code> correspond à un caractère quelconque, et <code>*</code> à toute chaîne de caractères. Les intervalles de caractères <code>[]</code> sont aussi autorisés. Aucun caractère générique ne peut remplacer le caractère `/', si bien que l'expression <code><Directory "/*/public_html"></code> ne conviendra pas pour le chemin * <code>/home/user/public_html</code>, alors que <code><Directory "/home/*/public_html"></code> conviendra. Exemple :</p> <pre class="prettyprint lang-config"><Directory "/usr/local/httpd/htdocs"> Options Indexes FollowSymLinks </Directory></pre> <p>Les chemins de répertoires contenant des espaces <em>doivent</em> être entourés de guillemets afin d'empêcher l'interprétation de ces espaces comme fins d'arguments.</p> <div class="note"> <p>Soyez prudent avec l'argument <var>chemin répertoire</var> : il doit correspondre exactement au chemin du système de fichier qu'Apache httpd utilise pour accéder aux fichiers. Les directives comprises dans une section <code><Directory></code> ne s'appliqueront pas aux fichiers du même répertoire auxquels on aura accédé via un chemin différent, per exemple via un lien symbolique.</p> </div> <p> Les <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">Expre peuvent aussi être utilisées en ajoutant le caractère <code>~</code>. Par exemple :</p> <pre class="prettyprint lang-config"><Directory ~ "^/www/[0-9]{3}"> </Directory></pre> <p>pourra correspondre à tout répertoire situé dans /www/ et dont le nom se compose de trois chiffres.</p> <p>Si plusieurs sections <code class="directive"><Directory></code> (sans expression rationnell correspondent au répertoire (ou à un de ses parents) qui contient le document, les directives de la section <code class="directive"><Directory></code> dont le chemin court sont appliquées en premier, en s'intercalant avec les directives des fichiers <a href="#accessfilename">.htaccess</a>. Par exemple, avec</p> <pre class="prettyprint lang-config"><Directory "/"> AllowOverride None </Directory> <Directory "/home"> AllowOverride FileInfo </Directory></pre> <p>l'accès au document <code>/home/web/dir/doc.html</code> emprunte le chemin suivant :</p> <ul> <li>Aplication de la directive <code>AllowOverride None</code> (qui désactive les fichiers <code>.htaccess</code>).</li> <li>Application de la directive <code>AllowOverride FileInfo</code> (pour le répertoire <code>/home</code>).</li> <li>Application de toute directive <code>FileInfo</code> qui se trouverait dans d'éventuels fichiers <code>/home/.htaccess</code>, <code>/home/web/.htaccess</code> ou <code>/home/web/dir/.htaccess</code>, dans cet ordre.</li> </ul> <p>Les directives associées aux répertoires sous forme d'expressions rationnelles ne sont prises en compte qu'une fois toutes les directives des sections sans expressions rationnelles appliquées. Alors, tous les répertoires avec expressions rationnelles sont testés selon l'ordre dans lequel ils apparaissent dans le fichier de configuration. Par exemple, avec</p> <pre class="prettyprint lang-config"><Directory ~ "abc$"> # ... directives ici ... </Directory></pre> <p>la section avec expression rationnelle ne sera prise en compte qu'après les sections <code class="directive"><Directory></code> sans expression rationnelle et les fichiers <code>.htaccess</code>. Alors, l'expression rationnelle conviendra pour <code>/home/abc/public_html/abc</code> et la section <code class="directive"><Directory></code> correspondante s'appliquera.</p> <p><strong>Notez que la politique d'accès par défaut dans les sections <code><Directory "/"></code> consiste à autoriser tout accès sans restriction. Ceci signifie qu'Apache httpd va servir tout fichier correspondant à une URL. Il est recommandé de modifier cette situation à l'aide d'un bloc du style</strong></p> <pre class="prettyprint lang-config"><Directory "/"> Require all denied </Directory></pre> <p><strong>puis d'affiner la configuration pour les répertoires que vous voulez rendre accessibles. Voir la page <a href="../misc/security_tips.html">Conseils à prop pour plus de détails.</strong></p> <p>Les sections <code class="directive"><Directory></code> se situent dans le fichier <code>httpd.conf</code>. Les directives <code class="directive"><Directory></cod et ne sont pas autorisées dans les sections <code class="directive"><a href="#limit"><Limit></a></co <h3>Voir aussi</h3> <ul> <li><a href="../sections.html">Comment fonctionnent les sections <Directory>, <Location> et <Files></a> pour des explications à propos de la manière dont ces différentes sections se combinent entre elles à la réception d'une requête</li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="directorymatch" id="directorymatch">Directive< <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directi du système de fichiers correspondant à une expression rationnelle</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><DirectoryMatch <var>regex</ ... </DirectoryMatch></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> <p>Les balises <code class="directive"><DirectoryMatch></code> et <code></DirectoryMatch></code> permettent de regrouper un ensemble de directives qui ne s'appliqueront qu'au répertoire précisé (et aux fichiers qu'il contient), comme pour la section <code class="directive"><a href=" répertoire est précisé sous la forme d'une <a class="glossarylink" href="../glossary.html#reg <pre class="prettyprint lang-config"><DirectoryMatch "^/www/(.+/)?[0-9]{3}/"> # ... </DirectoryMatch></pre> <p>convient pour les sous-répertoires de <code>/www/</code> dont le nom se compose de trois chiffres.</p> <div class="note"><h3>Compatibilité</h3> Avant la version 2.3.9, cette directive s'appliquait aussi aux sous-répertoires (comme la directive <code class="directive"><a href="#directory"><Directory>< symbole de fin de ligne ($). Depuis la version 2.3.9, seuls les répertoires qui correspondent à l'expression sont affectés par les directives contenues dans la section. </div> <div class="note"><h3>slash de fin</h3> Cette directive s'applique aux requêtes pour des répertoires avec ou sans slash de fin ; les expressions contenant un symbole de fin de ligne ($) doivent donc faire l'objet d'une attention particulière. </div> <p>A partir de la version 2.4.8, les groupes nommés et les références arrières sont extraits et enregistrés dans l'environnement avec leur nom en majuscules et préfixé par "MATCH_". Ceci permet de référencer des URLs dans des <a href="../expr.html">expressions</a> ou au sein de modules comme <code class="module"><a href="../mod/mod_rewrite.html">mod_rewri éviter toute confusion, les références arrières numérotées (non nommées) sont ignorées. Vous devez utiliser à la place des groupes nommés.</p> <pre class="prettyprint lang-config"><DirectoryMatch "^/var/www/combined/(?<sitename>[^/ Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example </DirectoryMatch></pre> <h3>Voir aussi</h3> <ul> <li><code class="directive"><a href="#directory"><Directory></a></code> pour une description de la manière dont les expressions rationnelles sont traitées en présence d'autres sections <code class="directive"><Directory></code> sans expre <li><a href="../sections.html">Comment fonctionnent les sections <Directory>, <Location> et <Files></a> pour une explication à propos de la manière dont ces différentes sections se combinent entre elles à la réception d'une requête</li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="documentroot" id="documentroot">Directive</a> <a n <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Racine principale de depuis Internet</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DocumentRoot <var>chemin rép <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DocumentRoot "/usr/local/ <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> <p>Cette directive permet de définir le répertoire à partir duquel <code class="program"><a href="../programs/httpd.html">httpd</a></code> va servir les fichiers pas à un <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, le chem de l'URL sera ajouté par le serveur à la racine des documents afin de construire le chemin du document recherché. Exemple :</p> <pre class="prettyprint lang-config">DocumentRoot "/usr/web"</pre> <p>un accès à <code>http://my.example.com/index.html</code> se réfère alors à <code>/usr/web/index.html</code>. Si <var>chemin répertoire</var> n'est pas un chemin absolu, il est considéré comme relatif au chemin défini par la directive <code class="directive"><a href="#serverroot">Server <p>Le répertoire défini par la directive <code class="directive">DocumentRoot</code> ne doit pas comporter de slash final.</p> <h3>Voir aussi</h3> <ul> <li><a href="../urlmapping.html#documentroot">Mise en correspondance des URLs avec le système de fichiers</a></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="else" id="else">Directive</a> <a name="Else" id="El <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directi condition correspondant à la section <code class="directive"><a href="#if"><If></a></code> ou <code cl requête à l'exécution</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Else> ... </Else></code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Les conditions im 2.4.26 du serveur HTTP Apache</td></tr> </table> <p>La section <code class="directive"><Else></code> applique les directives qu'elle contient si et seulement si les conditions correspondant à la section <code class="directive"><If></code> ou <code class="directive"><ElseIf></code> immédiatement supérieure et dans la même portée n'ont pas été satisfaites. Par exemple, dans :</p> <pre class="prettyprint lang-config"><If "-z req('Host')"> # ... </If> <Else> # ... </Else></pre> <p>La condition de la section <code class="directive"><If></code> serait satisfaite pour les requête HTTP/1.0 sans en-tête <var>Host:</var>, alors que celle de la section <code class="directive"><Else></code> le serait pour les requêtes comportant un en-tête <var>Host:</var>.</p> <h3>Voir aussi</h3> <ul> <li><code class="directive"><a href="#if"><If></a></code></li> <li><code class="directive"><a href="#elseif"><ElseIf></a></code></li> <li><a href="../sections.html">Fonctionnement des sections <Directory>, <Location>, <Files></a> pour une explication de la manière dont ces différentes section se combinent entre elles lorsqu'une requête est reçue. Les directives <code class="directive"><If></code>, <code class="directive"><ElseIf></code>, et <code class="directive"><Else></code> s'appliquent en d </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="elseif" id="elseif">Directive</a> <a name="ElseIf" <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directi condition correspondante est satisfaite par une requête à l'exécution, alors que la condition correspondant à la section <code class="directive"><a href="#if"><If></a></co <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><ElseIf <var>expression</var>> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Les conditions im 2.4.26 du serveur HTTP Apache</td></tr> </table> <p>La section <code class="directive"><ElseIf></code> applique les directives qu'elle contient si et seulement si d'une part la condition correspondante est satisfaite, et d'autre part la condition correspondant à la section <code class="directive"><If></code> ou <code class="directive"><ElseIf></code> de la même portée ne l'est pas. Par exemple, dans :</p> <pre class="prettyprint lang-config"><If "-R '10.1.0.0/16'"> #... </If> <ElseIf "-R '10.0.0.0/8'"> #... </ElseIf> <Else> #... </Else></pre> <p>La condition correspondant à la section <code class="directive"><ElseIf></code> est satisfaite s distante de la requête appartient au sous-réseau 10.0.0.0/8, mais pas si elle appartient au sous-réseau 10.1.0.0/16.</p> <h3>Voir aussi</h3> <ul> <li><a href="../expr.html">Les expressions dans le serveur HTTP Apache</a>, pour une référence complète et d'autres exemples.</li> <li><code class="directive"><a href="#if"><If></a></code></li> <li><code class="directive"><a href="#else"><Else></a></code></li> <li><a href="../sections.html">Fonctionnement des sections <Directory>, <Location>, <Files></a> pour une explication de la manière dont ces différentes section se combinent entre elles lorsqu'une requête est reçue. Les directives <code class="directive"><If></code>, <code class="directive"><ElseIf></code>, et <code class="directive"><Else></code> s'appliquent en d </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="enablemmap" id="enablemmap">Directive</a> <a name= <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise la projectio lire les fichiers pendant qu'ils sont servis</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>EnableMMAP On|Off</code></t <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>EnableMMAP On</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></t <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> <p>Cette directive définit si <code class="program"><a href="../programs/httpd.html">httpd</a></ la projection en mémoire (Memory-Mapping) quand il doit lire le contenu d'un fichier pendant qu'il est servi. Par défaut, lorsque le traitement d'une requête requiert l'accès aux données contenues dans un fichier -- par exemple, pour servir un fichier interprété par le serveur à l'aide de <code class="module"><a href="../mod/mod_include.html">mod_include</a></co le fichier en mémoire si le système d'exploitation le permet.</p> <p>Cette projection en mémoire induit parfois une amélioration des performances. Sur certains systèmes cependant, il est préférable de désactiver la projection en mémoire afin d'éviter certains problèmes opérationnels :</p> <ul> <li>Sur certains systèmes multi-processeurs, la projection en mémoire peut dégrader les performances du programme <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</li> <li>S'il fait l'objet d'une projection en mémoire par <code class="program"><a href="../programs/httpd.html">httpd</a></code>, la suppression ou la t fichier peut provoquer un crash de <code class="program"><a href="../programs/httpd.html">ht erreur de segmentation.</li> </ul> <p>Pour les configurations de serveur sujettes à ce genre de problème, il est préférable de désactiver la projection en mémoire des fichiers servis en spécifiant :</p> <pre class="prettyprint lang-config">EnableMMAP Off</pre> <p>Pour les montages NFS, cette fonctionnalité peut être explicitement désactivée pour les fichiers concernés en spécifiant :</p> <pre class="prettyprint lang-config"><Directory "/path-to-nfs-files"> EnableMMAP Off </Directory></pre> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="enablesendfile" id="enablesendfile">Directive< <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise le support se fichiers aux clients</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>EnableSendfile On|Off</co <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>EnableSendfile Off</code></t <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></t |