mod_dir.xml.fr revision 2c354850d076b9f9e567ffa47d48de8ce2f9d164
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<?xml version="1.0"?>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<?xml-stylesheet type="text/xsl" href="/style/manual.fr.xsl"?>
b414f08fbb7628e8ce1b7faef246a9a7153569dbgryzor<!-- English Revision: 1553502 -->
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<!-- French translation : Lucien GENTIS -->
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<!-- Reviewed by : Vincent Deffontaines -->
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<!--
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor Licensed to the Apache Software Foundation (ASF) under one or more
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor contributor license agreements. See the NOTICE file distributed with
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor this work for additional information regarding copyright ownership.
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor The ASF licenses this file to You under the Apache License, Version 2.0
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor (the "License"); you may not use this file except in compliance with
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor the License. You may obtain a copy of the License at
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor http://www.apache.org/licenses/LICENSE-2.0
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor Unless required by applicable law or agreed to in writing, software
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor distributed under the License is distributed on an "AS IS" BASIS,
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor See the License for the specific language governing permissions and
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor limitations under the License.
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor-->
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<modulesynopsis metafile="mod_dir.xml.meta">
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<name>mod_dir</name>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<description>Permet la redirection des adresses se terminant par un
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzorr&eacute;pertoire sans slash de fin et la mise &agrave; disposition des fichiers index
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzorde r&eacute;pertoire</description>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<status>Base</status>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<sourcefile>mod_dir.c</sourcefile>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<identifier>dir_module</identifier>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<summary>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <p>L'index d'un r&eacute;pertoire peut provenir de deux sources :</p>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <ul>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <li>Un fichier &eacute;crit par l'utilisateur, dont le nom, en g&eacute;n&eacute;ral
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor appel&eacute; <code>index.html</code>, peut &ecirc;tre d&eacute;fini &agrave; l'aide de la
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor directive <directive module="mod_dir">DirectoryIndex</directive>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor fournie par le module <module>mod_dir</module>.</li>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <li>Un listing g&eacute;n&eacute;r&eacute; par le serveur, par l'interm&eacute;diaire du
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor module <module>mod_autoindex</module>.</li>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor </ul>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <p>Les deux fonctions sont bien distinctes, si bien que vous pouvez
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor supprimer (ou remplacer) la g&eacute;n&eacute;ration automatique d'index, si vous
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor le souhaitez.</p>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <p>Une redirection "slash de fin" est effectu&eacute;e lorsque le serveur
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor re&ccedil;oit une requ&ecirc;te pour une URL du style
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <code>http://nom-serveur/foo/nom-rep</code> o&ugrave; <code>nom-rep</code>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor est le nom d'un r&eacute;pertoire. Comme les r&eacute;pertoires n&eacute;cessitent un slash de
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor fin, <module>mod_dir</module> effectue une redirection vers
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <code>http://nom-serveur/foo/nom-rep/</code>.</p>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor</summary>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<directivesynopsis>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<name>DirectoryIndex</name>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<description>Liste des fichiers ressources &agrave; rechercher lorsque le
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzorclient envoie une requ&ecirc;te pour un r&eacute;pertoire</description>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<syntax>DirectoryIndex
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor disabled | <var>url locale</var> [<var>url locale</var>] ...</syntax>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<default>DirectoryIndex index.html</default>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<contextlist><context>server config</context><context>virtual host</context>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<context>directory</context><context>.htaccess</context></contextlist>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<override>Indexes</override>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<usage>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <p>La directive <directive>DirectoryIndex</directive> permet de
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor d&eacute;finir une liste de fichiers ressources &agrave; rechercher lorsqu'un
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor client envoie une requ&ecirc;te pour l'index d'un r&eacute;pertoire, en ajoutant
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor un '/' &agrave; la fin du nom de ce dernier. <var>url locale</var> est
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor l'URL (cod&eacute;e avec caract&egrave;res '%') d'un document du serveur, relative
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor au r&eacute;pertoire faisant l'objet de la requ&ecirc;te ; il s'agit en g&eacute;n&eacute;ral
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor du nom d'un fichier situ&eacute; dans le r&eacute;pertoire. Si plusieurs URLs sont
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor fournies, le serveur renverra la premi&egrave;re d'entre elles qui
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor correspond &agrave; une ressource existante. Si aucune ressource ne
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor correspond &agrave; la liste des URLs sp&eacute;cifi&eacute;es, et si l'option
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <code>Indexes</code> est d&eacute;finie, le serveur g&eacute;n&eacute;rera son propre
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor listing du r&eacute;pertoire.</p>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <example><title>Exemple</title>
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis <highlight language="config">
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor DirectoryIndex index.html
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis </highlight>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor </example>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <p>Avec cette configuration, une requ&ecirc;te pour l'URL
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis <code>http://example.com/docs/</code> renverrait au client la
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis ressource <code>http://example.com/docs/index.html</code> si elle
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor existe, ou provoquerait la g&eacute;n&eacute;ration du listing du r&eacute;pertoire si la
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor ressource n'existe pas.</p>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <p>Notez qu'il n'est pas n&eacute;cessaire que les documents soient
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor relatifs au r&eacute;pertoire ;</p>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis <highlight language="config">
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor DirectoryIndex index.html index.txt /cgi-bin/index.pl
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis </highlight>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <p>provoquerait l'ex&eacute;cution du script CGI
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <code>/cgi-bin/index.pl</code> si aucun des fichiers
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <code>index.html</code> ou <code>index.txt</code> n'existe dans le
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor r&eacute;pertoire consid&eacute;r&eacute;.</p>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <p>La sp&eacute;cification du seul argument "disabled" emp&ecirc;che
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <module>mod_dir</module> de rechercher un index. Un argument
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor "disabled" sera interpr&eacute;t&eacute; de mani&egrave;re litt&eacute;rale si d'autres
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor arguments sont pr&eacute;sents avant ou apr&egrave;s lui, m&ecirc;me s'ils sont
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor eux-m&ecirc;mes des arguments "disabled".</p>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
ea7faa14f220892d3de347b2897b5197b9edcb7algentis <p><strong>Note :</strong>La d&eacute;finition de plusieurs directives
ab629fab2135fb9e0d530bee73907c293d602c59lgentis <directive>DirectoryIndex</directive> au sein d'un <a href="/sections.html"><em>m&ecirc;me
ab629fab2135fb9e0d530bee73907c293d602c59lgentis contexte</em></a> permet d'ajouter des ressources &agrave; rechercher plut&ocirc;t
ea7faa14f220892d3de347b2897b5197b9edcb7algentis que de remplacer celle d&eacute;j&agrave; d&eacute;finies :
ea7faa14f220892d3de347b2897b5197b9edcb7algentis </p>
ea7faa14f220892d3de347b2897b5197b9edcb7algentis <highlight language="config">
ab629fab2135fb9e0d530bee73907c293d602c59lgentis# Exemple A: d&eacute;finit index.html comme page d'index, ainsi qu'index.php.
ab629fab2135fb9e0d530bee73907c293d602c59lgentis&lt;Directory /foo&gt;
ab629fab2135fb9e0d530bee73907c293d602c59lgentis DirectoryIndex index.html
ab629fab2135fb9e0d530bee73907c293d602c59lgentis DirectoryIndex index.php
ab629fab2135fb9e0d530bee73907c293d602c59lgentis&lt;/Directory&gt;
ab629fab2135fb9e0d530bee73907c293d602c59lgentis
ab629fab2135fb9e0d530bee73907c293d602c59lgentis# Exemple B: identique &agrave; l'exemple A, mais avec une seule directive.
ab629fab2135fb9e0d530bee73907c293d602c59lgentis&lt;Directory /foo&gt;
ab629fab2135fb9e0d530bee73907c293d602c59lgentis DirectoryIndex index.html index.php
ab629fab2135fb9e0d530bee73907c293d602c59lgentis&lt;/Directory&gt;
ab629fab2135fb9e0d530bee73907c293d602c59lgentis
ab629fab2135fb9e0d530bee73907c293d602c59lgentis# Exemple C: pour remplacer la liste des pages d'index par une autre,
ab629fab2135fb9e0d530bee73907c293d602c59lgentis# vous devez tout d'abord supprimer la premi&egrave;re liste : dans l'exemple
ab629fab2135fb9e0d530bee73907c293d602c59lgentis# suivant, il ne restera qu'index.php comme page d'index.
ab629fab2135fb9e0d530bee73907c293d602c59lgentis&lt;Directory /foo&gt;
ab629fab2135fb9e0d530bee73907c293d602c59lgentis DirectoryIndex index.html
ab629fab2135fb9e0d530bee73907c293d602c59lgentis DirectoryIndex disabled
ab629fab2135fb9e0d530bee73907c293d602c59lgentis DirectoryIndex index.php
ab629fab2135fb9e0d530bee73907c293d602c59lgentis&lt;/Directory&gt;
ea7faa14f220892d3de347b2897b5197b9edcb7algentis </highlight>
ea7faa14f220892d3de347b2897b5197b9edcb7algentis
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor</usage>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor</directivesynopsis>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis<directivesynopsis>
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis<name>DirectoryIndexRedirect</name>
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis<description>D&eacute;finit une redirection externe pour les index de
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentisr&eacute;pertoires.
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis</description>
09796a508c72a6aba33aa486753bb8cdea806d43lgentis<syntax>DirectoryIndexRedirect on | off | permanent | temp | seeother |
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis<var>3xx-code</var>
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis</syntax>
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis<default>DirectoryIndexRedirect off</default>
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis<contextlist><context>server config</context><context>virtual host</context>
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis<context>directory</context><context>.htaccess</context></contextlist>
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis<override>Indexes</override>
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis<compatibility>Disponible depuis la version 2.3.14</compatibility>
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis<usage>
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis <p>Par d&eacute;faut, c'est la page d&eacute;finie par la directive
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis <directive>DirectoryIndex</directive> qui est s&eacute;lectionn&eacute;e et
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis renvoy&eacute;e de mani&egrave;re transparente au client. La directive
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis <directive>DirectoryIndexRedirect</directive> permet de rediriger le
b414f08fbb7628e8ce1b7faef246a9a7153569dbgryzor client via une redirection de type 3xx.</p>
b414f08fbb7628e8ce1b7faef246a9a7153569dbgryzor
2c354850d076b9f9e567ffa47d48de8ce2f9d164sf <p>Les arguments accept&eacute;s sont :</p>
b414f08fbb7628e8ce1b7faef246a9a7153569dbgryzor <ul>
b414f08fbb7628e8ce1b7faef246a9a7153569dbgryzor <li><code>on</code> : envoie une redirection 302 vers l'index choisi.</li>
b414f08fbb7628e8ce1b7faef246a9a7153569dbgryzor <li><code>off</code> : n'envoie aucune redirection. Il s'agit du comportement historique de mod_dir.</li>
b414f08fbb7628e8ce1b7faef246a9a7153569dbgryzor <li><code>permanent</code> : envoie une redirection 301 (permanent) vers l'index choisi.</li>
b414f08fbb7628e8ce1b7faef246a9a7153569dbgryzor <li><code>temp</code> : ceci est &eacute;quivalent &agrave; <code>on</code></li>
b414f08fbb7628e8ce1b7faef246a9a7153569dbgryzor <li><code>seeother</code> : envoie une redirection 303 (&eacute;galement appel&eacute;e "See Other") vers l'index choisi.</li>
b414f08fbb7628e8ce1b7faef246a9a7153569dbgryzor <li><var>3xx-code</var> : envoie une redirection accompagn&eacute;e du code 3xx choisi.</li>
b414f08fbb7628e8ce1b7faef246a9a7153569dbgryzor </ul>
b414f08fbb7628e8ce1b7faef246a9a7153569dbgryzor
b414f08fbb7628e8ce1b7faef246a9a7153569dbgryzor
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis <example><title>Exemple</title>
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis <highlight language="config">
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis DirectoryIndexRedirect on
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis </highlight>
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis </example>
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis <p>Une requ&ecirc;te pour <code>http://example.com/docs/</code> se
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis solderait par une redirection temporaire vers
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis <code>http://example.com/docs/index.html</code> si cette ressource
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis existe.</p>
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis</usage>
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis</directivesynopsis>
ee93e5f676dff5e42f52a2de815f52745f6868b3lgentis
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<directivesynopsis>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<name>DirectorySlash</name>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<description>Activation/D&eacute;sactivation de la redirection "slash de
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzorfin"</description>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<syntax>DirectorySlash On|Off</syntax>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<default>DirectorySlash On</default>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<contextlist><context>server config</context><context>virtual
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzorhost</context>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<context>directory</context><context>.htaccess</context></contextlist>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<override>Indexes</override>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<usage>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <p>La directive <directive>DirectorySlash</directive> permet de
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor d&eacute;terminer si <module>mod_dir</module> doit corriger ou non les URLs
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor pointant vers un r&eacute;pertoire.</p>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <p>En g&eacute;n&eacute;ral, si un utilisateur envoie une requ&ecirc;te pour une
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor ressource sans slash de fin, cette ressource repr&eacute;sentant un
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor r&eacute;pertoire, <module>mod_dir</module> le redirige vers la m&ecirc;me
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor ressource, mais <em>en ajoutant</em> un slash de fin, et ceci pour
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor plusieurs bonnes raisons :</p>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <ul>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <li>La requ&ecirc;te de l'utilisateur contiendra finalement l'URL
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor canonique de la ressource</li>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <li><module>mod_autoindex</module> fonctionnera correctement. Comme
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor il n'indique pas le chemin dans le lien, le chemin de l'URL serait
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor incorrect.</li>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <li>La directive <directive
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor module="mod_dir">DirectoryIndex</directive> n'est &eacute;valu&eacute;e
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <em>que</em> pour les r&eacute;pertoires se terminant par un slash.</li>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <li>Les r&eacute;f&eacute;rences &agrave; des URLs relatives dans les pages html
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor fonctionneront alors correctement.</li>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor </ul>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
d63adaad22c2f1639677506e340a5a683f63244flgentis <p>Si vous ne souhaitez pas voir ces effets, <em>et</em> si
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor les raisons &eacute;voqu&eacute;es ci-dessus ne s'appliquent pas &agrave; vous, vous
d63adaad22c2f1639677506e340a5a683f63244flgentis pouvez d&eacute;sactiver la redirection comme indiqu&eacute; ci-dessous.
d63adaad22c2f1639677506e340a5a683f63244flgentis Gardez cependant &agrave; l'esprit que ceci peut avoir des r&eacute;percutions en
d63adaad22c2f1639677506e340a5a683f63244flgentis mati&egrave;re de s&eacute;curit&eacute;.</p>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis <highlight language="config">
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis# voir l'avertissement de s&eacute;curit&eacute; ci-dessous !
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis&lt;Location /some/path&gt;
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis DirectorySlash Off
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis SetHandler some-handler
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis&lt;/Location&gt;
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis </highlight>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <note type="warning"><title>Avertissement de s&eacute;curit&eacute;</title>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <p>La d&eacute;sactivation de la redirection "slash de fin" peut entra&icirc;ner
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor la divulgation d'informations. Consid&eacute;rons la situation o&ugrave;
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <module>mod_autoindex</module> est actif (<code>Options
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor +Indexes</code>), o&ugrave; la directive <directive module="mod_dir"
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor >DirectoryIndex</directive> a pour valeur une ressource valide (par
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor exemple <code>index.html</code>), et o&ugrave; aucun gestionnaire
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor particulier n'a &eacute;t&eacute; d&eacute;fini pour cette URL. Dans ce cas, une requ&ecirc;te
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor avec slash de fin afficherait le contenu du fichier
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <code>index.html</code> ; <strong>par contre, une requ&ecirc;te sans slash
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor de fin afficherait un listing du contenu du
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor r&eacute;pertoire</strong>.</p>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor </note>
5e6dcc287b64eb58282c020e8a91a8bfb6ac0339lgentis <p>Notez aussi que certains navigateurs peuvent modifier par erreur
5e6dcc287b64eb58282c020e8a91a8bfb6ac0339lgentis des requ&ecirc;tes POST en requ&ecirc;tes GET lors d'une redirection, les
5e6dcc287b64eb58282c020e8a91a8bfb6ac0339lgentis donn&eacute;es POST &eacute;tant alors perdues.</p>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor</usage>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor</directivesynopsis>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<directivesynopsis>
0066eddda7203f6345b56f77d146a759298dc635gryzor<name>FallbackResource</name>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<description>D&eacute;finit une URL par d&eacute;faut pour les requ&ecirc;tes qui ne ciblent
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzoraucun fichier</description>
d8a9d7c2a80635654276f136e7c49b393a05f254lgentis<syntax>FallbackResource disabled | <var>url-locale</var></syntax>
d8a9d7c2a80635654276f136e7c49b393a05f254lgentis<default>D&eacute;sactiv&eacute; - httpd renvoie un code d'erreur 404 (Not Found)</default>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<contextlist><context>server config</context><context>virtual host</context>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<context>directory</context><context>.htaccess</context></contextlist>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<override>Indexes</override>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor<usage>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <p>Cette directive permet de d&eacute;finir un traitement pour toute URL
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor qui ne correspond &agrave; aucune ressource de votre syst&egrave;me de fichiers,
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor et qui provoquerait sans cela l'envoi d'un code d'erreur HTTP 404
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor (Not Found).
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor Par exemple</p>
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis <highlight language="config">
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis FallbackResource /not-404.php
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis </highlight>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor <p>fait en sorte que les requ&ecirc;tes ne correspondant &agrave; aucun fichier
0066eddda7203f6345b56f77d146a759298dc635gryzor soient trait&eacute;es par <code>non-404.php</code>, sans affecter les
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor requ&ecirc;tes pour des fichiers existants.</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>Il est souvent souhaitable qu'un seul fichier ou ressource traite
0066eddda7203f6345b56f77d146a759298dc635gryzor toutes les requ&ecirc;tes &agrave; destination d'un r&eacute;pertoire
0066eddda7203f6345b56f77d146a759298dc635gryzor particulier, sauf pour les requ&ecirc;tes qui correspondent &agrave; un fichier
0066eddda7203f6345b56f77d146a759298dc635gryzor ou script existant. On y fait souvent r&eacute;f&eacute;rence sous le terme
0066eddda7203f6345b56f77d146a759298dc635gryzor 'contr&ocirc;leur frontal'.</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>Dans les versions plus anciennes de httpd, cet effet n&eacute;cessitait
0066eddda7203f6345b56f77d146a759298dc635gryzor en g&eacute;n&eacute;ral <module>mod_rewrite</module>, et l'utilisation des tests
0066eddda7203f6345b56f77d146a759298dc635gryzor conditionnels <code>-f</code> et <code>-d</code> pour v&eacute;rifier
0066eddda7203f6345b56f77d146a759298dc635gryzor l'existence des fichiers et r&eacute;pertoires. Maintenant, une seule ligne
0066eddda7203f6345b56f77d146a759298dc635gryzor de configuration est n&eacute;cessaire.</p>
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis <highlight language="config">
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis FallbackResource /index.php
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis </highlight>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>Les fichiers existants comme des images, des fichiers css, etc...
0066eddda7203f6345b56f77d146a759298dc635gryzor seront trait&eacute;s normalement.</p>
d8a9d7c2a80635654276f136e7c49b393a05f254lgentis <p>Utilisez l'argument <code>disabled</code> pour d&eacute;sactiver cette
d8a9d7c2a80635654276f136e7c49b393a05f254lgentis fonctionnalit&eacute; si l'h&eacute;ritage d'un r&eacute;pertoire parent n'est pas
d8a9d7c2a80635654276f136e7c49b393a05f254lgentis souhait&eacute;.</p>
1475e66926f2bb491eccdc36d48e2da722228139lgentis <p>Pour un URI interm&eacute;diaire tel que
1475e66926f2bb491eccdc36d48e2da722228139lgentis <em>http://example.com/blog/</em>, cet URI interm&eacute;diaire doit &ecirc;tre
1475e66926f2bb491eccdc36d48e2da722228139lgentis sp&eacute;cifi&eacute; en tant que <var>url-locale</var> :</p>
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis <highlight language="config">
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis&lt;Directory /web/example.com/htdocs/blog&gt;
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis FallbackResource /blog/index.php
d8a9d7c2a80635654276f136e7c49b393a05f254lgentis&lt;/Directory&gt;
d8a9d7c2a80635654276f136e7c49b393a05f254lgentis&lt;Directory /web/example.com/htdocs/blog/images&gt;
d8a9d7c2a80635654276f136e7c49b393a05f254lgentis FallbackResource disabled
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis&lt;/Directory&gt;
06e80fa0dffc17ae61bca1715c96e08ea90d53cblgentis </highlight>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor</usage>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor</directivesynopsis>
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor
dfb59c684345700bf9186b8d44936f8b1ba082ffgryzor</modulesynopsis>