1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5 This file is generated from xml source: DO NOT EDIT
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
8 <title> Mise en correspondance des URLs avec le système de fichiers - Serveur Apache HTTP</title>
9 <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
10 <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
11 <link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
12 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
13 <body id="manual-page"><div id="page-header">
14 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
15 <p class="apache">Serveur Apache HTTP Version 2.3</p>
16 <img alt="" src="./images/feather.gif" /></div>
17 <div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
19 <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1> Mise en correspondance des URLs avec le système de fichiers</h1>
21 <p><span>Langues Disponibles: </span><a href="./en/urlmapping.html" hreflang="en" rel="alternate" title="English"> en </a> |
22 <a href="./fr/urlmapping.html" title="Français"> fr </a> |
23 <a href="./ja/urlmapping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
24 <a href="./ko/urlmapping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
25 <a href="./tr/urlmapping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
28 <p>Ce document explique comment Apache utilise l'URL contenue dans une
29 requête pour déterminer le noeud du système de fichier à partir duquel le
30 fichier devra être servi.</p>
32 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#related">Modules et directives concernés</a></li>
33 <li><img alt="" src="./images/down.gif" /> <a href="#documentroot">Racine des documents (DocumentRoot)</a></li>
34 <li><img alt="" src="./images/down.gif" /> <a href="#outside">Fichiers situés en dehors de
35 l'arborescence DocumentRoot</a></li>
36 <li><img alt="" src="./images/down.gif" /> <a href="#user">Répertoires des utilisateurs</a></li>
37 <li><img alt="" src="./images/down.gif" /> <a href="#redirect">Redirection d'URL</a></li>
38 <li><img alt="" src="./images/down.gif" /> <a href="#proxy">Mandataire inverse (Reverse Proxy)</a></li>
39 <li><img alt="" src="./images/down.gif" /> <a href="#rewrite">Moteur de réécriture</a></li>
40 <li><img alt="" src="./images/down.gif" /> <a href="#notfound">Fichier non trouvé (File Not Found)</a></li>
42 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
44 <h2><a name="related" id="related">Modules et directives concernés</a></h2>
46 <table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_alias.html">mod_alias</a></code></li><li><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></li><li><code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code></li><li><code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code></li><li><code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code></li><li><code class="module"><a href="./mod/mod_vhost_alias.html">mod_vhost_alias</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code></li><li><code class="directive"><a href="./mod/mod_speling.html#checkspelling">CheckSpelling</a></code></li><li><code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code></li><li><code class="directive"><a href="./mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#redirectmatch">RedirectMatch</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritematch">RewriteMatch</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code></li><li><code class="directive"><a href="./mod/mod_alias.html#scriptaliasmatch">ScriptAliasMatch</a></code></li><li><code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code></li></ul></td></tr></table>
47 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
49 <h2><a name="documentroot" id="documentroot">Racine des documents (DocumentRoot)</a></h2>
51 <p>La méthode par défaut d'Apache pour déterminer quel fichier servir pour
52 une requête donnée, consiste à extraire le chemin du fichier de la requête
53 (la partie de l'URL qui suit le nom d'hôte et le port), puis de l'ajouter
54 à la fin de la valeur de la directive
55 <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> définie dans vos fichiers
57 Ainsi, les fichiers et répertoires
58 situés en dessous de <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
59 constituent l'arborescence de base des documents qui seront visibles
62 <p>Par exemple, si la directive
63 <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> contient
64 <code>/var/www/html</code>, une requête pour
65 <code>http://www.example.com/fish/guppies.html</code> retournera le
66 fichier <code>/var/www/html/fish/guppies.html</code> au client.</p>
68 <p>Apache supporte aussi les <a href="vhosts/">Hôtes virtuels</a>,
69 ce qui lui permet de traiter des requêtes pour plusieurs hôtes.
70 Dans ce cas, un <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>
71 différent peut être défini pour chaque hôte virtuel;
72 les directives fournies par le module
73 <code class="module"><a href="./mod/mod_vhost_alias.html">mod_vhost_alias</a></code> peuvent aussi être utilisées afin de
74 déterminer dynamiquement le noeud approprié du système de fichiers
75 à partir duquel servir un contenu en fonction de l'adresse IP
78 <p>La directive <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> est
79 définie dans le fichier de configuration de votre serveur principal
80 (<code>httpd.conf</code>), mais peut aussi être redéfinie pour chaque
81 <a href="vhosts/">Hôte virtuel</a> supplémentaire que vous avez créé.</p>
82 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
84 <h2><a name="outside" id="outside">Fichiers situés en dehors de
85 l'arborescence DocumentRoot</a></h2>
87 <p>Il existe de nombreuses circonstances pour lesquelles il est nécessaire
88 d'autoriser l'accès web à des portions du système de fichiers qui ne se
89 trouvent pas dans l'arborescence <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>. Apache propose de nombreuses
90 solutions pour réaliser cela. Sur les systèmes Unix, les liens
91 symboliques permettent de rattacher d'autres portions du système de
92 fichiers au <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code>. Pour des raisons de sécurité,
93 Apache ne suivra les liens symboliques que si les <code class="directive"><a href="./mod/core.html#options">Options</a></code> pour le répertoire concerné contiennent
94 <code>FollowSymLinks</code> ou <code>SymLinksIfOwnerMatch</code>.</p>
96 <p>Une autre méthode consiste à utiliser la directive <code class="directive"><a href="./mod/mod_alias.html#alias">Alias</a></code> pour rattacher toute portion
97 du système de fichiers à l'arborescence du site web. Par exemple, avec</p>
99 <div class="example"><p><code>Alias /docs /var/web</code></p></div>
101 <p>l'URL <code>http://www.example.com/docs/dir/file.html</code>
102 correspondra au fichier <code>/var/web/dir/file.html</code>. La
104 <code class="directive"><a href="./mod/mod_alias.html#scriptalias">ScriptAlias</a></code>
105 fonctionne de la même manière, excepté que tout contenu localisé dans le
106 chemin cible sera traité comme un script <a class="glossarylink" href="./glossary.html#cgi" title="see glossary">CGI</a>.</p>
108 <p>Pour les situations qui nécessitent plus de flexibilité, vous disposez
109 des directives <code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code>
110 et <code class="directive"><a href="./mod/mod_alias.html#scriptaliasmatch">ScriptAliasMatch</a></code>
111 qui permettent des substitutions et comparaisons puissantes basées
112 sur les <a class="glossarylink" href="./glossary.html#regex" title="see glossary">expressions rationnelles</a>.
115 <div class="example"><p><code>ScriptAliasMatch ^/~([a-zA-Z0-9]+)/cgi-bin/(.+)
116 /home/$1/cgi-bin/$2</code></p></div>
118 <p>fera correspondre une requête du style
119 <code>http://example.com/~user/cgi-bin/script.cgi</code> au chemin
120 <code>/home/user/cgi-bin/script.cgi</code>, et traitera le fichier résultant
121 comme un script CGI.</p>
122 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
123 <div class="section">
124 <h2><a name="user" id="user">Répertoires des utilisateurs</a></h2>
126 <p>Sur les systèmes Unix, on peut traditionnellement faire référence
127 au répertoire personnel d'un <em>utilisateur</em> particulier à l'aide de
128 l'expression <code>~user/</code>.
129 Le module <code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code>
130 étend cette idée au web en autorisant l'accès aux fichiers situés dans les
131 répertoires home des utilisateurs à l'aide d'URLs
132 comme dans ce qui suit :</p>
134 <div class="example"><p><code>http://www.example.com/~user/file.html</code></p></div>
136 <p>Pour des raisons de sécurité, il est déconseillé de permettre un accès
137 direct à un répertoire home d'utilisateur depuis le web. A cet effet, la
138 directive <code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code>
139 spécifie un répertoire où sont situés les fichiers accessibles depuis le web
140 dans le répertoire home de l'utilisateur.
141 Avec la configuration par défaut
142 <code>Userdir public_html</code>, l'URL ci-dessus correspondra à un fichier
143 dont le chemin sera du style
144 <code>/home/user/public_html/file.html</code> où
145 <code>/home/user/</code> est le répertoire home de l'utilisateur tel qu'il
146 est défini dans <code>/etc/passwd</code>.</p>
148 <p>La directive <code>Userdir</code> met à votre disposition de nombreuses
149 formes différentes pour les systèmes où <code>/etc/passwd</code> ne
150 spécifie pas la localisation du répertoire home.</p>
152 <p>Certains jugent le symbole "~" (dont le code sur le web est souvent
153 <code>%7e</code>) inapproprié et préfèrent utiliser une chaîne de
154 caractères différente pour représenter les répertoires utilisateurs.
155 mod_userdir ne supporte pas cette fonctionnalité. Cependant, si les
156 répertoires home des utilisateurs sont structurés de manière rationnelle,
157 il est possible d'utiliser la directive
158 <code class="directive"><a href="./mod/mod_alias.html#aliasmatch">AliasMatch</a></code>
159 pour obtenir l'effet désiré. Par exemple, pour faire correspondre
160 <code>http://www.example.com/upages/user/file.html</code> à
161 <code>/home/user/public_html/file.html</code>, utilisez la directive
162 <code>AliasMatch</code> suivante :</p>
164 <div class="example"><p><code>AliasMatch ^/upages/([a-zA-Z0-9]+)/?(.*)
165 /home/$1/public_html/$2</code></p></div>
166 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
167 <div class="section">
168 <h2><a name="redirect" id="redirect">Redirection d'URL</a></h2>
170 <p>Les directives de configuration décrites dans les sections précédentes
171 demandent à Apache d'extraire un contenu depuis un emplacement spécifique
172 du système de fichiers
173 et de la retourner au client. Il est cependant parfois
174 souhaitable d'informer le
175 client que le contenu demandé est localisé à une URL différente, et de
176 demander au client d'élaborer une nouvelle requête avec la nouvelle URL.
177 Ce processus se nomme <em>redirection</em> et est implémenté par la
178 directive <code class="directive"><a href="./mod/mod_alias.html#redirect">Redirect</a></code>.
179 Par exemple, si le contenu du répertoire <code>/foo/</code> sous
180 <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> est déplacé vers le
181 nouveau répertoire <code>/bar/</code>, vous pouvez demander aux clients
182 de le requérir à sa nouvelle localisation comme suit :</p>
184 <div class="example"><p><code>Redirect permanent /foo/ http://www.example.com/bar/</code></p></div>
186 <p>Ceci aura pour effet de rediriger tout chemin d'URL commençant par
187 <code>/foo/</code> vers le même chemin d'URL sur le serveur
188 <code>www.example.com</code> en remplaçant <code>/foo/</code> par
189 <code>/bar/</code>. Vous pouvez rediriger les clients non seulement sur le
190 serveur d'origine, mais aussi vers n'importe quel autre serveur.</p>
192 <p>Apache propose aussi la directive <code class="directive"><a href="./mod/mod_alias.html#redirectmatch">RedirectMatch</a></code> pour traiter les problèmes
193 de réécriture d'une plus grande complexité. Par exemple, afin de rediriger
194 les requêtes pour la page d'accueil du site vers un site différent, mais
195 laisser toutes les autres requêtes inchangées, utilisez la
196 configuration suivante :</p>
198 <div class="example"><p><code>RedirectMatch permanent ^/$
199 http://www.example.com/startpage.html</code></p></div>
201 <p>De même, pour rediriger temporairement toutes les pages d'un site
202 vers une page particulière d'un autre site, utilisez ce qui suit :</p>
204 <div class="example"><p><code>RedirectMatch temp .*
205 http://othersite.example.com/startpage.html</code></p></div>
206 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
207 <div class="section">
208 <h2><a name="proxy" id="proxy">Mandataire inverse (Reverse Proxy)</a></h2>
210 <p>Apache vous permet aussi de rapatrier des documents distants
211 dans l'espace des URL du serveur local.
212 Cette technique est appelée <em>mandataire inverse ou reverse
213 proxying</em> car le serveur web agit comme un serveur mandataire en
214 rapatriant les documents depuis un serveur distant puis les renvoyant
215 au client. Ceci diffère d'un service de proxy usuel car, pour le client,
216 les documents semblent appartenir au serveur mandataire inverse.</p>
218 <p>Dans l'exemple suivant, quand les clients demandent des documents situés
220 <code>/foo/</code>, le serveur rapatrie ces documents depuis le répertoire
221 <code>/bar/</code> sur <code>internal.example.com</code>
222 et les renvoie au client comme s'ils appartenaient au serveur local.</p>
224 <div class="example"><p><code>
225 ProxyPass /foo/ http://internal.example.com/bar/<br />
226 ProxyPassReverse /foo/ http://internal.example.com/bar/
227 ProxyPassReverseCookieDomain internal.example.com public.example.com
228 ProxyPassReverseCookiePath /foo/ /bar/
231 <p>La directive <code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code> configure
232 le serveur pour rapatrier les documents appropriés, alors que la directive
233 <code class="directive"><a href="./mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code>
234 réécrit les redirections provenant de
235 <code>internal.example.com</code> de telle manière qu'elles ciblent le
236 répertoire approprié sur le serveur local. De manière similaire, les directives
237 <code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></code>
238 et <code class="directive"><a href="./mod/mod_proxy.html#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></code>
239 réécrivent les cookies élaborés par le serveur d'arrière-plan.</p>
240 <p>Il est important de noter cependant, que les liens situés dans les documents
241 ne seront pas réécrits. Ainsi, tout lien absolu sur
242 <code>internal.example.com</code> fera décrocher le client
243 du serveur mandataire et effectuer sa requête directement sur
244 <code>internal.example.com</code>. Un module tiers
245 <a href="http://apache.webthing.com/mod_proxy_html/">mod_proxy_html</a>
246 permet de réécrire les liens dans les documents HTML et XHTML.</p>
247 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
248 <div class="section">
249 <h2><a name="rewrite" id="rewrite">Moteur de réécriture</a></h2>
251 <p>Le moteur de réécriture <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> peut s'avérer
252 utile lorsqu'une substitution plus puissante est nécessaire.
253 Les directives fournies par ce module utilisent des caractéristiques de la
254 requête comme le type de navigateur ou l'adresse IP source afin de décider
255 depuis où servir le contenu. En outre, mod_rewrite peut utiliser des
256 fichiers ou programmes de bases de données externes pour déterminer comment
257 traiter une requête. Le moteur de réécriture peut effectuer les trois types
258 de mise en correspondance discutés plus haut :
259 redirections internes (aliases), redirections externes, et services mandataires.
260 De nombreux exemples pratiques utilisant mod_rewrite sont discutés dans le
261 <a href="misc/rewriteguide.html">Guide de réécriture des URLs</a>.</p>
262 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
263 <div class="section">
264 <h2><a name="notfound" id="notfound">Fichier non trouvé (File Not Found)</a></h2>
266 <p>Inévitablement, apparaîtront des URLs qui ne correspondront à aucun
267 fichier du système de fichiers.
268 Ceci peut arriver pour de nombreuses raisons.
269 Il peut s'agir du déplacement de documents d'une
270 localisation vers une autre. Dans ce cas, le mieux est d'utiliser la
271 <a href="#redirect">redirection d'URL</a> pour informer les clients de la
272 nouvelle localisation de la ressource. De cette façon, vous êtes sur que
273 les anciens signets et liens continueront de fonctionner, même si la
274 ressource est déplacée.</p>
276 <p>Une autre cause fréquente d'erreurs "File Not Found" est l'erreur de
277 frappe accidentelle dans les URLs, soit directement dans le navigateur,
278 soit dans les liens HTML. Apache propose le module
279 <code class="module"><a href="./mod/mod_speling.html">mod_speling</a></code> (sic) pour tenter de résoudre ce problème.
280 Lorsque ce module est activé, il intercepte les erreurs
281 "File Not Found" et recherche une ressource possédant un nom de fichier
282 similaire. Si un tel fichier est trouvé, mod_speling va envoyer une
283 redirection HTTP au client pour lui communiquer l'URL correcte.
284 Si plusieurs fichiers proches sont trouvés, une liste des alternatives
285 possibles sera présentée au client.</p>
287 <p>mod_speling possède une fonctionnalité particulièrement utile :
288 il compare les noms de fichiers sans tenir compte de la casse.
289 Ceci peut aider les systèmes où les utilisateurs ne connaissent pas la
290 sensibilité des URLs à la casse et bien sûr les systèmes de fichiers unix.
291 Mais l'utilisation de mod_speling pour toute autre chose que la correction
292 occasionnelle d'URLs peut augmenter la charge du serveur, car chaque
293 requête "incorrecte" entraîne une redirection d'URL et une nouvelle requête
294 de la part du client.</p>
296 <p>Si toutes les tentatives pour localiser le contenu échouent, Apache
297 retourne une page d'erreur avec le code de statut HTTP 404
298 (file not found). L'apparence de cette page est contrôlée à l'aide de la
299 directive <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>
300 et peut être personnalisée de manière très flexible comme discuté dans le
302 <a href="custom-error.html">Réponses personnalisées aux erreurs</a>.</p>
304 <div class="bottomlang">
305 <p><span>Langues Disponibles: </span><a href="./en/urlmapping.html" hreflang="en" rel="alternate" title="English"> en </a> |
306 <a href="./fr/urlmapping.html" title="Français"> fr </a> |
307 <a href="./ja/urlmapping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
308 <a href="./ko/urlmapping.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
309 <a href="./tr/urlmapping.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
310 </div><div id="footer">
311 <p class="apache">Copyright 2008 The Apache Software Foundation.<br />Authorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
312 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div>
projects / apache / blob