granicus.if.org Git - apache/blob - docs/manual/urlmapping.xml.fr

   1 <?xml version="1.0" encoding="ISO-8859-1" ?>
   2 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
   3 <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
   4 <!-- French translation : Lucien GENTIS -->
   5 <!-- Reviewed by : Vincent Deffontaines -->
   6 <!-- English Revision: 1041851 -->
   7
   8 <!--
   9  Licensed to the Apache Software Foundation (ASF) under one or more
  10  contributor license agreements.  See the NOTICE file distributed with
  11  this work for additional information regarding copyright ownership.
  12  The ASF licenses this file to You under the Apache License, Version 2.0
  13  (the "License"); you may not use this file except in compliance with
  14  the License.  You may obtain a copy of the License at
  15
  16      http://www.apache.org/licenses/LICENSE-2.0
  17
  18  Unless required by applicable law or agreed to in writing, software
  19  distributed under the License is distributed on an "AS IS" BASIS,
  20  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  21  See the License for the specific language governing permissions and
  22  limitations under the License.
  23 -->
  24
  25 <manualpage metafile="urlmapping.xml.meta">
  26
  27   <title> Mise en correspondance des URLs avec le syst&egrave;me de fichiers</title>
  28
  29   <summary>
  30     <p>Ce document explique comment le serveur HTTP Apache utilise l'URL contenue dans une
  31     requ&ecirc;te pour d&eacute;terminer le noeud du syst&egrave;me de fichier &agrave; partir duquel le
  32     fichier devra &ecirc;tre servi.</p>
  33   </summary>
  34
  35 <section id="related"><title>Modules et directives concern&eacute;s</title>
  36
  37 <related>
  38 <modulelist>
  39 <module>mod_actions</module>
  40 <module>mod_alias</module>
  41 <module>mod_dir</module>
  42 <module>mod_imagemap</module>
  43 <module>mod_negotiation</module>
  44 <module>mod_proxy</module>
  45 <module>mod_rewrite</module>
  46 <module>mod_speling</module>
  47 <module>mod_userdir</module>
  48 <module>mod_vhost_alias</module>
  49 </modulelist>
  50 <directivelist>
  51 <directive module="mod_alias">Alias</directive>
  52 <directive module="mod_alias">AliasMatch</directive>
  53 <directive module="mod_speling">CheckSpelling</directive>
  54 <directive module="core">DocumentRoot</directive>
  55 <directive module="core">ErrorDocument</directive>
  56 <directive module="core">Options</directive>
  57 <directive module="mod_proxy">ProxyPass</directive>
  58 <directive module="mod_proxy">ProxyPassReverse</directive>
  59 <directive module="mod_proxy">ProxyPassReverseCookieDomain</directive>
  60 <directive module="mod_proxy">ProxyPassReverseCookiePath</directive>
  61 <directive module="mod_alias">Redirect</directive>
  62 <directive module="mod_alias">RedirectMatch</directive>
  63 <directive module="mod_rewrite">RewriteCond</directive>
  64 <directive module="mod_rewrite">RewriteRule</directive>
  65 <directive module="mod_alias">ScriptAlias</directive>
  66 <directive module="mod_alias">ScriptAliasMatch</directive>
  67 <directive module="mod_userdir">UserDir</directive>
  68 </directivelist>
  69 </related>
  70 </section>
  71
  72 <section id="documentroot"><title>Racine des documents (DocumentRoot)</title>
  73
  74     <p>La m&eacute;thode par d&eacute;faut de httpd pour d&eacute;terminer quel fichier servir pour
  75     une requ&ecirc;te donn&eacute;e, consiste &agrave; extraire le chemin du fichier de la requ&ecirc;te
  76     (la partie de l'URL qui suit le nom d'h&ocirc;te et le port), puis de l'ajouter
  77     &agrave; la fin de la valeur de la directive
  78     <directive module="core">DocumentRoot</directive> d&eacute;finie dans vos fichiers
  79     de configuration.
  80     Ainsi, les fichiers et r&eacute;pertoires
  81     situ&eacute;s en dessous de <directive module="core">DocumentRoot</directive>
  82     constituent l'arborescence de base des documents qui seront visibles
  83     depuis le web.</p>
  84
  85     <p>Par exemple, si la directive
  86     <directive module="core">DocumentRoot</directive> contient
  87     <code>/var/www/html</code>, une requ&ecirc;te pour
  88     <code>http://www.example.com/fish/guppies.html</code> retournera le
  89     fichier <code>/var/www/html/fish/guppies.html</code> au client.</p>
  90
  91     <p>httpd supporte aussi les <a href="vhosts/">H&ocirc;tes virtuels</a>,
  92     ce qui lui permet de traiter des requ&ecirc;tes pour plusieurs h&ocirc;tes.
  93     Dans ce cas, un <directive module="core">DocumentRoot</directive>
  94     diff&eacute;rent peut &ecirc;tre d&eacute;fini pour chaque h&ocirc;te virtuel;
  95     les directives fournies par le module
  96     <module>mod_vhost_alias</module> peuvent aussi &ecirc;tre utilis&eacute;es afin de
  97     d&eacute;terminer dynamiquement le noeud appropri&eacute; du syst&egrave;me de fichiers
  98     &agrave; partir duquel servir un contenu en fonction de l'adresse IP
  99     ou du nom d'h&ocirc;te.</p>
 100
 101     <p>La directive <directive module="core">DocumentRoot</directive>  est
 102     d&eacute;finie dans le fichier de configuration de votre serveur principal
 103     (<code>httpd.conf</code>), mais peut aussi &ecirc;tre red&eacute;finie pour chaque
 104     <a href="vhosts/">H&ocirc;te virtuel</a> suppl&eacute;mentaire que vous avez cr&eacute;&eacute;.</p>
 105 </section>
 106
 107 <section id="outside"><title>Fichiers situ&eacute;s en dehors de
 108 l'arborescence DocumentRoot</title>
 109
 110     <p>Il existe de nombreuses circonstances pour lesquelles il est n&eacute;cessaire
 111     d'autoriser l'acc&egrave;s web &agrave; des portions du syst&egrave;me de fichiers qui ne se
 112     trouvent pas dans l'arborescence <directive
 113     module="core">DocumentRoot</directive>.  httpd propose de nombreuses
 114     solutions pour r&eacute;aliser cela. Sur les syst&egrave;mes Unix, les liens
 115     symboliques permettent de rattacher d'autres portions du syst&egrave;me de
 116     fichiers au <directive
 117     module="core">DocumentRoot</directive>. Pour des raisons de s&eacute;curit&eacute;,
 118     httpd ne suivra les liens symboliques que si les <directive
 119     module="core">Options</directive> pour le r&eacute;pertoire concern&eacute; contiennent
 120     <code>FollowSymLinks</code> ou <code>SymLinksIfOwnerMatch</code>.</p>
 121
 122     <p>Une autre m&eacute;thode consiste &agrave; utiliser la directive <directive
 123     module="mod_alias">Alias</directive> pour rattacher toute portion
 124     du syst&egrave;me de fichiers &agrave; l'arborescence du site web. Par exemple, avec</p>
 125
 126 <example>Alias /docs /var/web</example>
 127
 128     <p>l'URL <code>http://www.example.com/docs/dir/file.html</code>
 129     correspondra au fichier <code>/var/web/dir/file.html</code>. La
 130     directive
 131     <directive module="mod_alias">ScriptAlias</directive>
 132     fonctionne de la m&ecirc;me mani&egrave;re, except&eacute; que tout contenu localis&eacute; dans le
 133     chemin cible sera trait&eacute; comme un script <glossary ref="cgi"
 134     >CGI</glossary>.</p>
 135
 136     <p>Pour les situations qui n&eacute;cessitent plus de flexibilit&eacute;, vous disposez
 137     des directives <directive module="mod_alias">AliasMatch</directive>
 138     et <directive module="mod_alias">ScriptAliasMatch</directive>
 139     qui permettent des substitutions et comparaisons puissantes bas&eacute;es
 140     sur les <glossary ref="regex">expressions rationnelles</glossary>.
 141     Par exemple,</p>
 142
 143 <example>ScriptAliasMatch ^/~([a-zA-Z0-9]+)/cgi-bin/(.+)
 144       /home/$1/cgi-bin/$2</example>
 145
 146     <p>fera correspondre une requ&ecirc;te du style
 147     <code>http://example.com/~user/cgi-bin/script.cgi</code> au chemin
 148     <code>/home/user/cgi-bin/script.cgi</code>, et traitera le fichier r&eacute;sultant
 149     comme un script CGI.</p>
 150 </section>
 151
 152 <section id="user"><title>R&eacute;pertoires des utilisateurs</title>
 153
 154     <p>Sur les syst&egrave;mes Unix, on peut traditionnellement faire r&eacute;f&eacute;rence
 155     au r&eacute;pertoire personnel d'un <em>utilisateur</em> particulier &agrave; l'aide de
 156     l'expression <code>~user/</code>.
 157     Le module <module>mod_userdir</module>
 158     &eacute;tend cette id&eacute;e au web en autorisant l'acc&egrave;s aux fichiers situ&eacute;s dans les
 159     r&eacute;pertoires home des utilisateurs &agrave; l'aide d'URLs
 160     comme dans ce qui suit :</p>
 161
 162 <example>http://www.example.com/~user/file.html</example>
 163
 164     <p>Pour des raisons de s&eacute;curit&eacute;, il est d&eacute;conseill&eacute; de permettre un acc&egrave;s
 165     direct &agrave; un r&eacute;pertoire home d'utilisateur depuis le web. A cet effet, la
 166     directive <directive module="mod_userdir">UserDir</directive>
 167     sp&eacute;cifie un r&eacute;pertoire o&ugrave; sont situ&eacute;s les fichiers accessibles depuis le web
 168     dans le r&eacute;pertoire home de l'utilisateur.
 169     Avec la configuration par d&eacute;faut
 170     <code>Userdir public_html</code>, l'URL ci-dessus correspondra &agrave; un fichier
 171     dont le chemin sera du style
 172     <code>/home/user/public_html/file.html</code> o&ugrave;
 173     <code>/home/user/</code> est le r&eacute;pertoire home de l'utilisateur tel qu'il
 174     est d&eacute;fini dans <code>/etc/passwd</code>.</p>
 175
 176     <p>La directive <code>Userdir</code> met &agrave; votre disposition de nombreuses
 177     formes diff&eacute;rentes pour les syst&egrave;mes o&ugrave; <code>/etc/passwd</code> ne
 178     sp&eacute;cifie pas la localisation du r&eacute;pertoire home.</p>
 179
 180     <p>Certains jugent le symbole "~" (dont le code sur le web est souvent
 181     <code>%7e</code>) inappropri&eacute; et pr&eacute;f&egrave;rent utiliser une cha&icirc;ne de
 182     caract&egrave;res diff&eacute;rente pour repr&eacute;senter les r&eacute;pertoires utilisateurs.
 183     mod_userdir ne supporte pas cette fonctionnalit&eacute;. Cependant, si les
 184     r&eacute;pertoires home des utilisateurs sont structur&eacute;s de mani&egrave;re rationnelle,
 185     il est possible d'utiliser la directive
 186     <directive module="mod_alias">AliasMatch</directive>
 187     pour obtenir l'effet d&eacute;sir&eacute;. Par exemple, pour faire correspondre
 188     <code>http://www.example.com/upages/user/file.html</code> &agrave;
 189     <code>/home/user/public_html/file.html</code>, utilisez la directive
 190     <code>AliasMatch</code> suivante :</p>
 191
 192 <example>AliasMatch ^/upages/([a-zA-Z0-9]+)(/(.*))?$
 193       /home/$1/public_html/$3</example>
 194 </section>
 195
 196 <section id="redirect"><title>Redirection d'URL</title>
 197
 198     <p>Les directives de configuration d&eacute;crites dans les sections pr&eacute;c&eacute;dentes
 199     demandent &agrave; httpd d'extraire un contenu depuis un emplacement sp&eacute;cifique
 200     du syst&egrave;me de fichiers
 201     et de la retourner au client. Il est cependant parfois
 202     souhaitable d'informer le
 203     client que le contenu demand&eacute; est localis&eacute; &agrave; une URL diff&eacute;rente, et de
 204     demander au client d'&eacute;laborer une nouvelle requ&ecirc;te avec la nouvelle URL.
 205     Ce processus se nomme <em>redirection</em> et est impl&eacute;ment&eacute; par la
 206     directive <directive module="mod_alias">Redirect</directive>.
 207     Par exemple, si le contenu du r&eacute;pertoire <code>/foo/</code> sous
 208     <directive module="core">DocumentRoot</directive> est d&eacute;plac&eacute; vers le
 209     nouveau r&eacute;pertoire <code>/bar/</code>, vous pouvez demander aux clients
 210     de le requ&eacute;rir &agrave; sa nouvelle localisation comme suit :</p>
 211
 212 <example>Redirect permanent /foo/ http://www.example.com/bar/</example>
 213
 214     <p>Ceci aura pour effet de rediriger tout chemin d'URL commen&ccedil;ant par
 215     <code>/foo/</code> vers le m&ecirc;me chemin d'URL sur le serveur
 216     <code>www.example.com</code> en rempla&ccedil;ant <code>/foo/</code> par
 217     <code>/bar/</code>. Vous pouvez rediriger les clients non seulement sur le
 218     serveur d'origine, mais aussi vers n'importe quel autre serveur.</p>
 219
 220     <p>httpd propose aussi la directive <directive
 221     module="mod_alias">RedirectMatch</directive> pour traiter les probl&egrave;mes
 222     de r&eacute;&eacute;criture d'une plus grande complexit&eacute;. Par exemple, afin de rediriger
 223     les requ&ecirc;tes pour la page d'accueil du site vers un site diff&eacute;rent, mais
 224     laisser toutes les autres requ&ecirc;tes inchang&eacute;es, utilisez la
 225     configuration suivante :</p>
 226
 227 <example>RedirectMatch permanent ^/$
 228       http://www.example.com/startpage.html</example>
 229
 230     <p>De m&ecirc;me, pour rediriger temporairement toutes les pages d'un site
 231     vers une page particuli&egrave;re d'un autre site, utilisez ce qui suit :</p>
 232
 233 <example>RedirectMatch temp .*
 234       http://othersite.example.com/startpage.html</example>
 235 </section>
 236
 237 <section id="proxy"><title>Mandataire inverse (Reverse Proxy)</title>
 238
 239 <p>httpd vous permet aussi de rapatrier des documents distants
 240 dans l'espace des URL du serveur local.
 241 Cette technique est appel&eacute;e <em>mandataire inverse ou reverse
 242 proxying</em> car le serveur web agit comme un serveur mandataire en
 243 rapatriant les documents depuis un serveur distant puis les renvoyant
 244 au client. Ceci diff&egrave;re d'un service de mandataire usuel (direct) car, pour le client,
 245 les documents semblent appartenir au serveur mandataire inverse.</p>
 246
 247 <p>Dans l'exemple suivant, quand les clients demandent des documents situ&eacute;s
 248 dans le r&eacute;pertoire
 249 <code>/foo/</code>, le serveur rapatrie ces documents depuis le r&eacute;pertoire
 250 <code>/bar/</code> sur <code>internal.example.com</code>
 251 et les renvoie au client comme s'ils appartenaient au serveur local.</p>
 252
 253 <example>
 254 ProxyPass /foo/ http://internal.example.com/bar/<br />
 255 ProxyPassReverse /foo/ http://internal.example.com/bar/<br />
 256 ProxyPassReverseCookieDomain internal.example.com public.example.com<br />
 257 ProxyPassReverseCookiePath /foo/ /bar/
 258 </example>
 259
 260 <p>La directive <directive module="mod_proxy">ProxyPass</directive> configure
 261 le serveur pour rapatrier les documents appropri&eacute;s, alors que la directive
 262 <directive module="mod_proxy">ProxyPassReverse</directive>
 263 r&eacute;&eacute;crit les redirections provenant de
 264 <code>internal.example.com</code> de telle mani&egrave;re qu'elles ciblent le
 265 r&eacute;pertoire appropri&eacute; sur le serveur local. De mani&egrave;re similaire, les directives
 266 <directive module="mod_proxy">ProxyPassReverseCookieDomain</directive>
 267 et <directive module="mod_proxy">ProxyPassReverseCookiePath</directive>
 268 r&eacute;&eacute;crivent les cookies &eacute;labor&eacute;s par le serveur d'arri&egrave;re-plan.</p>
 269 <p>Il est important de noter cependant, que les liens situ&eacute;s dans les documents
 270 ne seront pas r&eacute;&eacute;crits.  Ainsi, tout lien absolu sur
 271 <code>internal.example.com</code> fera d&eacute;crocher le client
 272 du serveur mandataire et effectuer sa requ&ecirc;te directement sur
 273 <code>internal.example.com</code>. Vous pouvez modifier ces liens (et
 274 d'utres contenus) situ&eacute;s dans la page au moment o&ugrave; elle est envoy&eacute;e au
 275 client en utilisant le module <module>mod_substitute</module>.</p>
 276
 277 <example>
 278 Substitute s/internal\.example\.com/www.example.com/i
 279 </example>
 280
 281 <p>En outre, un module tiers
 282 <a href="http://apache.webthing.com/mod_proxy_html/">mod_proxy_html</a>
 283 permet de r&eacute;&eacute;crire les liens dans les documents HTML et XHTML.</p>
 284 </section>
 285
 286 <section id="rewrite"><title>Moteur de r&eacute;&eacute;criture</title>
 287
 288     <p>Le moteur de r&eacute;&eacute;criture <module>mod_rewrite</module> peut s'av&eacute;rer
 289     utile lorsqu'une substitution plus puissante est n&eacute;cessaire.
 290     Les directives fournies par ce module peuvent utiliser des caract&eacute;ristiques de la
 291     requ&ecirc;te comme le type de navigateur ou l'adresse IP source afin de d&eacute;cider
 292     depuis o&ugrave; servir le contenu. En outre, mod_rewrite peut utiliser des
 293     fichiers ou programmes de bases de donn&eacute;es externes pour d&eacute;terminer comment
 294     traiter une requ&ecirc;te. Le moteur de r&eacute;&eacute;criture peut effectuer les trois types
 295     de mise en correspondance discut&eacute;s plus haut :
 296     redirections internes (aliases), redirections externes, et services mandataires.
 297     De nombreux exemples pratiques utilisant mod_rewrite sont discut&eacute;s dans la
 298     <a href="rewrite/">documentation d&eacute;taill&eacute;e de mod_rewrite</a>.</p>
 299 </section>
 300
 301 <section id="notfound"><title>Fichier non trouv&eacute; (File Not Found)</title>
 302
 303     <p>In&eacute;vitablement, appara&icirc;tront des URLs qui ne correspondront &agrave; aucun
 304     fichier du syst&egrave;me de fichiers.
 305     Ceci peut arriver pour de nombreuses raisons.
 306     Il peut s'agir du d&eacute;placement de documents d'une
 307     localisation vers une autre. Dans ce cas, le mieux est d'utiliser la
 308     <a href="#redirect">redirection d'URL</a> pour informer les clients de la
 309     nouvelle localisation de la ressource. De cette fa&ccedil;on, vous &ecirc;tes sur que
 310     les anciens signets et liens continueront de fonctionner, m&ecirc;me si la
 311     ressource est d&eacute;plac&eacute;e.</p>
 312
 313     <p>Une autre cause fr&eacute;quente d'erreurs "File Not Found" est l'erreur de
 314     frappe accidentelle dans les URLs, soit directement dans le navigateur,
 315     soit dans les liens HTML. httpd propose le module
 316     <module>mod_speling</module> (sic) pour tenter de r&eacute;soudre ce probl&egrave;me.
 317     Lorsque ce module est activ&eacute;, il intercepte les erreurs
 318     "File Not Found" et recherche une ressource poss&eacute;dant un nom de fichier
 319     similaire. Si un tel fichier est trouv&eacute;, mod_speling va envoyer une
 320     redirection HTTP au client pour lui communiquer l'URL correcte.
 321     Si plusieurs fichiers proches sont trouv&eacute;s, une liste des alternatives
 322     possibles sera pr&eacute;sent&eacute;e au client.</p>
 323
 324     <p>mod_speling poss&egrave;de une fonctionnalit&eacute; particuli&egrave;rement utile :
 325     il compare les noms de fichiers sans tenir compte de la casse.
 326     Ceci peut aider les syst&egrave;mes o&ugrave; les utilisateurs ne connaissent pas la
 327     sensibilit&eacute; des URLs &agrave; la casse et bien s&ucirc;r les syst&egrave;mes de fichiers unix.
 328     Mais l'utilisation de mod_speling pour toute autre chose que la correction
 329     occasionnelle d'URLs peut augmenter la charge du serveur, car chaque
 330     requ&ecirc;te "incorrecte" entra&icirc;ne une redirection d'URL et une nouvelle requ&ecirc;te
 331     de la part du client.</p>
 332
 333     <p><module>mod_dir</module> fournit la directive <directive
 334     module="mod_dir">FallbackResource</directive> qui permet d'associer
 335     des URIs virtuels &agrave; une ressource r&eacute;elle qui peut ainsi les servir.
 336     Cette directive remplace avantageusement
 337     <module>mod_rewrite</module> lors de l'impl&eacute;mentation d'un
 338     "contr&ocirc;leur frontal".</p>
 339
 340     <p>Si toutes les tentatives pour localiser le contenu
 341     &eacute;chouent, httpd
 342     retourne une page d'erreur avec le code de statut HTTP 404
 343     (file not found). L'apparence de cette page est contr&ocirc;l&eacute;e &agrave; l'aide de la
 344     directive <directive module="core">ErrorDocument</directive>
 345     et peut &ecirc;tre personnalis&eacute;e de mani&egrave;re tr&egrave;s flexible comme discut&eacute; dans le
 346     document
 347     <a href="custom-error.html">R&eacute;ponses personnalis&eacute;es aux erreurs</a>.</p>
 348 </section>
 349
 350 <section id="other"><title>Autres modules de mise en correspondance des
 351 URLs</title>
 352
 353 <!-- TODO Flesh out each of the items in the list below. -->
 354
 355     <p>Les autres modules disponibles pour la mise en correspondance des
 356     URLs sont :</p>
 357     <ul>
 358     <li><module>mod_actions</module> - Met une URL en correspondance
 359     avec un script CGI en fonction de la m&eacute;thode de la requ&ecirc;te, ou du
 360     type MIME de la ressource.</li>
 361     <li><module>mod_dir</module> - Permet une mise en correspondance
 362     basique d'un slash terminal dans un fichier index comme
 363     <code>index.html</code>.</li>
 364     <li><module>mod_imagemap</module> - Met en correspondance une
 365     requ&ecirc;te avec une URL en fonction de la zone d'une image int&eacute;gr&eacute;e &agrave;
 366     un document HTML dans laquelle un utilisateur clique.</li>
 367     <li><module>mod_negotiation</module> - S&eacute;lectionne le document
 368     appropri&eacute; en fonction de pr&eacute;f&eacute;rences du client telles que la langue
 369     ou la compression du contenu.</li>
 370     </ul>
 371
 372 </section>
 373
 374 </manualpage>