summaryrefslogtreecommitdiffstats
path: root/docs/manual/rewrite/rewrite_guide.html.fr
blob: 6a483bf9ce5eca00ab986be10d808427bed570e3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
              This file is generated from xml source: DO NOT EDIT
        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
      -->
<title>Guide de r��criture des URLs - Serveur Apache HTTP</title>
<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="/images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<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>
<p class="apache">Serveur Apache HTTP Version 2.3</p>
<img alt="" src="/images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="/images/left.gif" /></a></div>
<div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="/">Version 2.3</a> &gt; <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Guide de r��criture des URLs</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span></p>
</div>


    <p>Ce document compl�te la <a href="../mod/mod_rewrite.html">documentation de r�f�rence</a> du
    module <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>. Il d�crit de quelle mani�re on
    peut utiliser le module Apache <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> pour
    r�soudre les probl�mes typiques relatifs aux URLs auxquels les
    webmasters sont souvent confront�s. La r�solution de chaque probl�me
    par la configuration des jeux de r�gles de r��criture d'URLs fait
    l'objet d'une description d�taill�e.</p>

    <div class="warning">ATTENTION : l'adaptation des exemples � votre
    situation en fonction de la configuration de votre serveur pourra
    s'av�rer n�cessaire, par exemple l'ajout du drapeau
    <code>[PT]</code> si vous utilisez les modules
    <code class="module"><a href="/mod/mod_alias.html">mod_alias</a></code>, <code class="module"><a href="/mod/mod_userdir.html">mod_userdir</a></code>, etc... Un
    jeu de r�gles d�fini dans le contexte du serveur devra aussi �tre
    adapt� pour �tre utilis� dans un contexte <code>.htaccess</code>.
    Efforcez-vous toujours de bien comprendre l'effet produit par un jeu
    de r�gles avant de l'utiliser, ce qui pourra vous �viter bien des
    probl�mes.</div>

  </div>
<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#canonicalurl">URLs canoniques</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#canonicalhost">Noms d'h�tes canoniques</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#moveddocroot"><code>DocumentRoot</code>d�plac�</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#trailingslash">Probl�me du slash de fin</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#movehomedirs">D�placement des r�pertoires home vers un autre serveur</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#multipledirs">Recherche de pages dans plus d'un r�pertoire</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#setenvvars">D�finir des variables d'environnement en fonction de
      certaines parties de l'URL</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#uservhosts">H�tes virtuels bas�s sur l'utilisateur</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#redirecthome">Redirection des r�pertoires d'accueil pour les �trangers</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#redirectanchors">Redirection des ancrages</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#time-dependent">R��criture d�pendant de l'heure</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#backward-compatibility">Compatibilit� ascendante pour une migration de YYYY vers
      XXXX</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#old-to-new">De l'ancien au nouveau (en interne)</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#old-to-new-extern">De l'ancien au nouveau (en externe)</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#static-to-dynamic">De statique � dynamique</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#blocking-of-robots">Blocage des robots</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#blocked-inline-images">Blocage du r�f�rencement � chaud (Hotlinking) d'images</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#proxy-deny">Interdiction du mandataire</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#external-rewriting">Moteur de r��criture externe</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du module</a></li><li><a href="intro.html">Introduction � mod_rewrite</a></li><li><a href="rewrite_guide_advanced.html">Guide de r��criture
avanc� - exemples utiles avanc�s</a></li><li><a href="tech.html">D�tails techniques</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="canonicalurl" id="canonicalurl">URLs canoniques</a></h2>



<dl>
 <dt>Description :</dt>

   <dd>
     <p>Sur certains serveurs web, une ressource peut �tre accessible
     depuis plusieurs URLs. On trouve en g�n�ral des URLs canoniques
     (qui sont r�ellement utilisables et distribuables), mais aussi des
     URLs � usage interne, ou celles qui ne sont que des raccourcis,
     etc... On souhaite que, quelle que soit l'URL que l'utilisateur
     a fournie avec sa requ�te, il ne doit en voir en fin de compte
     que la forme canonique.</p>
   </dd>

   <dt>Solution :</dt>

     <dd>
       <p>On effectue une redirection HTTP externe pour toutes les URLs
       non canoniques afin de les rendre compr�hensibles au navigateur
       et ceci pour toutes les requ�tes sous-jacentes. Dans l'exemple de
       jeux de r�gles ci-dessous, <code>/~user</code> est remplac� par
       l'expression canonique <code>/u/user</code>, et une �ventuelle
       absence du slash � la fin de <code>/u/user</code> est corrig�e.</p>

<div class="example"><pre>
RewriteRule   ^/<strong>~</strong>([^/]+)/?(.*)    /<strong>u</strong>/$1/$2  [<strong>R</strong>]
RewriteRule   ^/u/(<strong>[^/]+</strong>)$  /$1/$2<strong>/</strong>   [<strong>R</strong>]
</pre></div>
        </dd>
      </dl>

    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="canonicalhost" id="canonicalhost">Noms d'h�tes canoniques</a></h2>

      <dl>
        <dt>Description :</dt>

        <dd>Le but de cette r�gle est de pr�f�rer l'utilisation d'un nom
	d'h�te particulier par rapport � d'autres noms d'h�te utilisables
	pour atteindre le m�me site. Par exemple, si vous voulez
	utiliser <strong>www.example.com</strong> � la place de
	<strong>example.com</strong>, vous devez utiliser une solution
	de ce style.</dd>

        <dt>Solution :</dt>

        <dd>
<p>Pour les sites �coutant sur un port autre que 80:</p>
<div class="example"><pre>
RewriteCond %{HTTP_HOST}   !^www\.exemple\.com [NC]
RewriteCond %{HTTP_HOST}   !^$
RewriteCond %{SERVER_PORT} !^80$
RewriteRule ^/?(.*)         http://www.example.com:%{SERVER_PORT}/$1
[L,R,NE]
</pre></div>

<p>Et pour un site �coutant sur le port 80</p>
<div class="example"><pre>
RewriteCond %{HTTP_HOST}   !^www\.exemple\.com [NC]
RewriteCond %{HTTP_HOST}   !^$
RewriteRule ^/?(.*)         http://www.example.com/$1 [L,R,NE]
</pre></div>
	<p>
	Si vous souhaitez que cette r�gle s'applique � tous les noms de
	domaine - en d'autres termes, si vous voulez rediriger
	<strong>example.com</strong> vers
	<strong>www.example.com</strong> pour toutes les valeurs
	possibles de <strong>example.com</strong>, vous pouvez utiliser
	le jeu de r�gles suivants :</p>

<div class="example"><pre>
RewriteCond %{HTTP_HOST} !^www\. [NC]
RewriteCond %{HTTP_HOST} !^$
RewriteRule ^/?(.*) http://www.%{HTTP_HOST}/$1 [L,R,NE]
</pre></div>
	<p>
	Vous pouvez utiliser ce jeu de r�gles aussi bien dans le fichier
	de configuration de votre serveur principal que dans un fichier
	<code>.htaccess</code> plac� dans le r�pertoire d�fini par la
	directive <code class="directive"><a href="/mod/core.html#documentroot">DocumentRoot</a></code> du serveur.</p>
        </dd>
      </dl>

    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="moveddocroot" id="moveddocroot"><code>DocumentRoot</code>d�plac�</a></h2>

      

      <dl>
        <dt>Description :</dt>

        <dd>
<p>En g�n�ral, la directive <code class="directive"><a href="/mod/core.html#documentroot">DocumentRoot</a></code> correspond directement � l'URL
"<code>/</code>" du serveur web. Mais souvent, les donn�es qui s'y
trouvent ne sont pas de la premi�re priorit�. Par exemple, il peut �tre
int�ressant, pour les visiteurs qui entrent sur le site pour la premi�re
fois, d'�tre redirig�s vers un sous-r�pertoire particulier
<code>/a-propos-de/</code>. Pour ce faire, on peut utiliser le jeu de
r�gles suivant :</p>
</dd>

        <dt>Solution :</dt>

        <dd>
          <p>On redirige l'URL <code>/</code> vers
          <code>/a-propos-de/</code>:
          </p>

<div class="example"><pre>
RewriteEngine on
RewriteRule   <strong>^/$</strong>  /a-propos-de/  [<strong>R</strong>]
</pre></div>

    <p>Notez que le m�me effet peut �tre obtenu � l'aide de la directive
    <code class="directive"><a href="/mod/mod_alias.html#redirectmatch">RedirectMatch</a></code> :</p>

<div class="example"><p><code>
RedirectMatch ^/$ http://example.com/apropos/
</code></p></div>
<p>Notez aussi que cet exemple ne r��crit que l'URL racine. En d'autres
termes, il r��crit une requ�te pour <code>http://example.com/</code>,
mais ne r��crira pas une requ�te pour
<code>http://example.com/page.html</code>. En fait, si vous avez modifi�
la racine de vos documents - c'est � dire si tous vos contenus se
trouvent dans ce sous-r�pertoire, il vaut mieux simplement modifier
votre directive <code class="directive"><a href="/mod/core.html#documentroot">DocumentRoot</a></code> que de
proc�der � une r��criture d'URLs.</p>
</dd>
</dl>

    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="trailingslash" id="trailingslash">Probl�me du slash de fin</a></h2>

      

      <dl>
        <dt>Description :</dt>

    <dd><p>La plupart des probl�mes de "slash de fin" peuvent �tre
    r�solus gr�ce aux techniques d�crites dans ce <a href="http://httpd.apache.org/docs/misc/FAQ-E.html#set-servername">sujet
    de la FAQ</a>. Cependant, dans certaines situations o� l'absence de slash de fin
    peut rendre une URL inop�rante, l'utilisation de
    mod_rewrite s'av�re n�cessaire. Le cas peut se pr�senter, par exemple,
    apr�s une s�rie complexe de r�gles de r��criture.</p>
    </dd>

        <dt>Solution :</dt>

        <dd>
          <p>La solution � ce probl�me subtil consiste � laisser le
	  serveur ajouter le slash de fin automatiquement. Pour y
	  parvenir, il faut utiliser une redirection externe, afin que
	  le navigateur demande correctement les images sous-jacentes,
	  etc... Une r��criture en interne ne fonctionnerait que pour la
	  page du r�pertoire, mais �chouerait pour toute image incluse
	  dans cette page via des liens relatifs, car le navigateur
	  demanderait un objet ins�r�. Par exemple, une requ�te pour
	  <code>image.gif</code> dans <code>/~quux/foo/index.html</code>
	  deviendrait <code>/~quux/image.gif</code> sans la redirection
	  externe !</p>

          <p>Pour y parvenir, on peut utiliser des r�gles de ce style :</p>

<div class="example"><pre>
RewriteEngine  on
RewriteBase    /~quux/
RewriteRule    ^foo<strong>$</strong>  foo<strong>/</strong>  [<strong>R</strong>]
</pre></div>

   <p>Vous pouvez aussi ajouter ce qui suit dans un fichier
   <code>.htaccess</code> situ� dans le r�pertoire contenant la
   ressource. Notez cependant que cela augmente la charge du processeur.</p>

<div class="example"><pre>
RewriteEngine  on
RewriteBase    /~quux/
RewriteCond    %{REQUEST_FILENAME}  <strong>-d</strong>
RewriteRule    ^(.+<strong>[^/]</strong>)$           $1<strong>/</strong>  [R]
</pre></div>
        </dd>
      </dl>

    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="movehomedirs" id="movehomedirs">D�placement des r�pertoires home vers un autre serveur</a></h2>

      

      <dl>
        <dt>Description :</dt>

        <dd>
          <p>De nombreux webmasters ont demand� comment r�soudre le
	  probl�me suivant : ils voudraient tout simplement rediriger
	  les r�pertoires home d'un serveur web vers un autre serveur
	  web. Cette situation se pr�sente en g�n�ral lorsqu'on installe
	  un nouveau serveur web destin� � terme � en remplacer un autre
	  plus ancien.</p>
        </dd>

        <dt>Solution :</dt>

        <dd>
          <p>Avec <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>, la solution est
	  �vidente. Sur l'ancien serveur web, on redirige simplement
	  toutes les URLs du style <code>/~user/chemin</code> vers
	  <code>http://nouveau-serveur/~user/chemin</code>.</p>

<div class="example"><pre>
RewriteEngine on
RewriteRule   ^/~(.+)  http://<strong>nouveau-serveur</strong>/~$1  [R,L]
</pre></div>
        </dd>
      </dl>

    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="multipledirs" id="multipledirs">Recherche de pages dans plus d'un r�pertoire</a></h2>

      

      <dl>
        <dt>Description :</dt>

        <dd>
          <p>Le serveur web doit parfois rechercher des pages dans plus
	  d'un r�pertoire. Dans ce cas, les vues multiples ou autres
	  techniques similaires ne sont d'aucun secours.</p>
        </dd>

        <dt>Solution :</dt>

        <dd>
          <p>On d�finit explicitement un jeu de r�gles qui recherche les
	  fichiers dans les r�pertoires.</p>

<div class="example"><pre>
RewriteEngine on

#   on cherche tout d'abord dans dir1/...
#   ... et si on trouve, on est content et on arr�te :
RewriteCond         %{DOCUMENT_ROOT}/<strong>dir1</strong>/%{REQUEST_URI}  -f
RewriteRule  ^(.+)  %{DOCUMENT_ROOT}/<strong>dir1</strong>/$1  [L]

#   on cherche ensuite dans dir2/...
#   ... et si on trouve, on est content et on arr�te :
RewriteCond         %{DOCUMENT_ROOT}/<strong>dir2</strong>/%{REQUEST_URI}  -f
RewriteRule  ^(.+)  %{DOCUMENT_ROOT}/<strong>dir2</strong>/$1  [L]

#   sinon, on continue la recherche avec d'autres directives Alias
#   ou ScriptAlias, etc...
RewriteRule   ^(.+)  -  [PT]
</pre></div>
        </dd>
      </dl>

    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="setenvvars" id="setenvvars">D�finir des variables d'environnement en fonction de
      certaines parties de l'URL</a></h2>

      

      <dl>
        <dt>Description :</dt>

        <dd>
          <p>Comment conserver des informations
	  d'�tat d'une requ�te � l'autre et utiliser l'URL pour les
	  encoder, sans utiliser d'encapsulateur CGI
	  pour toutes les pages pour seulement supprimer ces
	  informations.</p>
        </dd>

        <dt>Solution :</dt>

        <dd>
          <p>On utilise une r�gle de r��criture pour supprimer
	  l'information d'�tat et l'enregistrer dans une variable
	  d'environnement dont on pourra plus tard extraire la valeur
	  dans XSSI ou CGI. De cette fa�on, une URL telle que
	  <code>/foo/S=java/bar/</code> sera traduite en
	  <code>/foo/bar/</code> et la variable d'environnement
	  <code>STATUS</code> aura pour valeur "java".</p>

<div class="example"><pre>
RewriteEngine on
RewriteRule   ^(.*)/<strong>S=([^/]+)</strong>/(.*)    $1/$3 [E=<strong>STATUS:$2</strong>]
</pre></div>
        </dd>
      </dl>

    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="uservhosts" id="uservhosts">H�tes virtuels bas�s sur l'utilisateur</a></h2>

      

      <dl>
        <dt>Description :</dt>

        <dd>
          <p>Supposons que vous vouliez atteindre la page d'accueil des
	  utilisateurs sur une m�me machine au moyen de l'URL
	  <code>www.<strong>nom-utilisateur</strong>.h�te.domaine.com</code>,
	  en vous basant
	  seulement sur les enregistrements DNS de type A, et ceci sans qu'aucun
	  h�te virtuel ne soit install� sur cette machine.</p>
        </dd>

        <dt>Solution :</dt>

        <dd>
          <p>Dans le cas des requ�tes HTTP/1.0, il n'y a pas de solution
	  ; par contre, avec une requ�te HTTP/1.1 qui contient un
	  en-t�te HTTP Host:, on peut utiliser le jeu de r�gles suivant
	  pour r��crire en interne
	  <code>http://www.nom-utilisateur.h�te.com/chemin</code> vers
	  <code>/home/nom-utilisateur/chemin</code> :</p>

<div class="example"><pre>
RewriteEngine on
RewriteCond   %{<strong>HTTP_HOST</strong>}                 ^www\.<strong>([^.]+)</strong>\.host\.com$
RewriteRule   ^(.*) /home/<strong>%1</strong>$1
</pre></div>
<p>Les parenth�ses utilis�es dans une directive <code class="directive"><a href="/mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> sont captur�es dans les
r�f�rences arri�res <code>%1</code>, <code>%2</code>, etc..., alors que
les parenth�ses utilis�es dans une directive <code class="directive"><a href="/mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> sont captur�es dans les
r�f�rences arri�res <code>$1</code>, <code>$2</code>, etc...</p>
        </dd>
      </dl>

    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="redirecthome" id="redirecthome">Redirection des r�pertoires d'accueil pour les �trangers</a></h2>

      

      <dl>
        <dt>Description :</dt>

        <dd>
          <p>On veut rediriger les URLs des r�pertoires d'accueil vers
	  un autre serveur <code>www.quelque-part.com</code> lorsque
	  l'utilisateur demandeur n'appartient pas au domaine local
	  <code>notre-domaine.com</code>. On rencontre parfois cette
	  situation dans un contexte d'h�tes virtuels.</p>
        </dd>

        <dt>Solution :</dt>

        <dd>
          <p>Juste une condition de r��criture :</p>

<div class="example"><pre>
RewriteEngine on
RewriteCond   %{REMOTE_HOST}  <strong>!^.+\.notre-domaine\.com$</strong>
RewriteRule   ^(/~.+)         http://www.quelque-part.com/$1 [R,L]
</pre></div>
        </dd>
      </dl>

    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="redirectanchors" id="redirectanchors">Redirection des ancrages</a></h2>

      

      <dl>
        <dt>Description :</dt>

        <dd>
        <p>Par d�faut, la redirection vers un ancrage HTML ne fonctionne
	pas, car mod_rewrite �chappe le caract�re <code>#</code> en le
	transformant en <code>%23</code>, ce qui rend la redirection
	inop�rante.</p>
        </dd>

        <dt>Solution :</dt>

        <dd>
          <p>On utilise le drapeau <code>[NE]</code> dans la r�gle
	  <code>RewriteRule</code>. NE signifie "No Escape".
          </p>
        </dd>
      </dl>

    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="time-dependent" id="time-dependent">R��criture d�pendant de l'heure</a></h2>

      

      <dl>
        <dt>Description :</dt>

        <dd>
          <p>Lorsqu'il s'agit de distribuer des contenus dont la nature
	  d�pend de l'heure, de nombreux webmasters utilisent encore des
	  scripts CGI qui redirigent par exemple vers des pages
	  sp�cifiques. Comment peut-on y parvenir � tenir compte de
	  l'heure � l'aide de <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> ?</p>
        </dd>

        <dt>Solution :</dt>

        <dd>
          <p>Il existe de nombreuses variables nomm�es
	  <code>TIME_xxx</code> utilisables dans les conditions de
	  r��criture. Utilis�es en conjonction avec les mod�les de
	  comparaison lexicographique sp�ciaux <code>&lt;STRING</code>,
	  <code>&gt;STRING</code> et <code>=STRING</code>, elles
	  permettent d'effectuer des redirections d�pendant de
	  l'heure :</p>

<div class="example"><pre>
RewriteEngine on
RewriteCond   %{TIME_HOUR}%{TIME_MIN} &gt;0700
RewriteCond   %{TIME_HOUR}%{TIME_MIN} &lt;1900
RewriteRule   ^foo\.html$             foo.jour.html
RewriteRule   ^foo\.html$             foo.nuit.html
</pre></div>

          <p>Avec cet exemple, l'URL <code>foo.html</code> renvoie
	  le contenu de <code>foo.jour.html</code> durant le
	  cr�neau horaire <code>07:00-19:00</code>, et le contenu de
	  <code>foo.nuit.html</code> le reste du temps. Agr�able
	  fonctionnalit� pour une page d'accueil...</p>
        </dd>
      </dl>

    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="backward-compatibility" id="backward-compatibility">Compatibilit� ascendante pour une migration de YYYY vers
      XXXX</a></h2>

      

      <dl>
        <dt>Description :</dt>

        <dd>
          <p>Comment conf�rer une compatibilit� ascendante aux URLs
	  (existant encore virtuellement) apr�s avoir migr�
	  <code>document.YYYY</code> vers <code>document.XXXX</code>,
	  c'est � dire apr�s avoir par exemple traduit un lot de
	  fichiers <code>.html</code> en fichiers <code>.phtml</code>
	  ?</p>
        </dd>

        <dt>Solution :</dt>

        <dd>
          <p>On r��crit simplement le nom du fichier en son nom
	  de base et v�rifie s'il existe aussi avec la nouvelle
	  extension. Si c'est le cas, on utilise ce nom, sinon on
	  r��crit l'URL sous sa forme originale.</p>


<div class="example"><pre>
#   jeu de r�gles assurant une compatibilit� ascendante en r��crivant
#   document.html en document.phtml si et seulement si document.phtml
#   existe et document.html n'existe plus
RewriteEngine on
RewriteBase   /~quux/
#   r��criture du fichier en son nom de base,
#   mais garde en m�moire le fait qu'il s'agit
#   d'un fichier html
RewriteRule   ^(.*)\.html$              $1      [C,E=WasHTML:yes]
#   r��crit vers document.phtml s'il existe
#   Note : il s'agit d'un exemple de niveau r�pertoire, si bien que
#   %{REQUEST_FILENAME} contient le chemin complet du syst�me de fichier
#   tel qu'il a �t� construit par le serveur.
RewriteCond   %{REQUEST_FILENAME}.phtml -f
RewriteRule   ^(.*)$ $1.phtml                   [S=1]
#   sinon, restauration du nom de fichier complet original
RewriteCond   %{ENV:WasHTML}            ^yes$
RewriteRule   ^(.*)$ $1.html
</pre></div>
        </dd>
      </dl>

    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="old-to-new" id="old-to-new">De l'ancien au nouveau (en interne)</a></h2>

      

      <dl>
        <dt>Description :</dt>

        <dd>
          <p>Supposons que nous ayons r�cemment renomm� la page
	  <code>foo.html</code> en <code>bar.html</code>, et voulions
	  maintenant que l'ancienne URL soit toujours valide � des fins
	  de compatibilit� ascendante. En fait, on voudrait que le
	  changement de nom soit transparent aux utilisateurs de
	  l'ancienne URL.</p>
        </dd>

        <dt>Solution :</dt>

        <dd>
          <p>On r��crit l'ancienne URL en interne vers la nouvelle via
	  la r�gle suivante :</p>

<div class="example"><pre>
RewriteEngine  on
RewriteBase    /~quux/
RewriteRule    ^<strong>foo</strong>\.html$  <strong>bar</strong>.html
</pre></div>
        </dd>
      </dl>

    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="old-to-new-extern" id="old-to-new-extern">De l'ancien au nouveau (en externe)</a></h2>

      

      <dl>
        <dt>Description :</dt>

        <dd>
          <p>Supposons toujours que nous ayons r�cemment renomm� la page
	  <code>foo.html</code> en <code>bar.html</code>, et voulions
	  maintenant que l'ancienne URL soit toujours valide � des fins
	  de compatibilit� ascendante. Par contre, nous voulons cette
	  fois que les utilisateurs de l'ancienne URL soient redirig�s
	  vers la nouvelle, c'est � dire que l'adresse tap�e
	  dans leur navigateur doit aussi �tre modifi�e.</p>
        </dd>

        <dt>Solution :</dt>

        <dd>
          <p>On force une redirection HTTP vers la nouvelle URL, ce qui
	  entra�ne une modification de celle du navigateur et aussi de ce
	  que voit l'utilisateur :</p>

<div class="example"><pre>
RewriteEngine  on
RewriteBase    /~quux/
RewriteRule    ^<strong>foo</strong>\.html$  <strong>bar</strong>.html  [<strong>R</strong>]
</pre></div>
        </dd>
      </dl>

    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="static-to-dynamic" id="static-to-dynamic">De statique � dynamique</a></h2>

      

      <dl>
        <dt>Description :</dt>

        <dd>
          <p>Comment transformer une page statique <code>foo.html</code>
	  en sa variante dynamique <code>foo.cgi</code> de mani�re
	  transparente, c'est � dire sans en avertir le
	  navigateur/utilisateur.</p>
        </dd>

        <dt>Solution :</dt>

        <dd>
          <p>On r��crit simplement l'URL en script CGI et force le
	  gestionnaire de contenu � <strong>cgi-script</strong> de fa�on
	  � ce que le script s'ex�cute en tant que programme CGI.
	  Ainsi, une requ�te vers <code>/~quux/foo.html</code> conduit
	  en interne � l'invocation de
	  <code>/~quux/foo.cgi</code>.</p>

<div class="example"><pre>
RewriteEngine  on
RewriteBase    /~quux/
RewriteRule    ^foo\.<strong>html</strong>$  foo.<strong>cgi</strong>  [H=<strong>cgi-script</strong>]
</pre></div>
        </dd>
      </dl>

    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="blocking-of-robots" id="blocking-of-robots">Blocage des robots</a></h2>

      

      <dl>
        <dt>Description :</dt>

        <dd>
          <p>Comment emp�cher un robot vraiment g�nant de collecter les
	  pages d'une partie sp�cifique du site web ? Un fichier
	  <code>/robots.txt</code> comportant les entr�es du "Protocole
	  d'Exclusion des Robots" ne suffit g�n�ralement pas � en venir
	  � bout.</p>
        </dd>

        <dt>Solution :</dt>

        <dd>
          <p>On utilise un jeu de r�gles qui interdit les URLs de la
	  partie du site web concern�e <code>/~quux/foo/arc/</code>
	  (peut-�tre une partie du serveur avec une arborescence tr�s
	  d�velopp�e � travers laquelle le parcours du
	  robot induirait une charge importante pour le serveur). Nous
	  devons nous assurer de n'interdire l'acc�s qu'� ce robot
	  particulier, c'est � dire qu'il ne suffit pas d'interdire
	  l'acc�s � l'h�te sur lequel le robot fonctionne, ce qui
	  bloquerait aussi les utilisateurs de cet h�te. Pour y
	  parvenir, on tient aussi compte des informations contenues
	  dans l'en-t�te HTTP User-Agent.</p>

<div class="example"><pre>
RewriteCond %{HTTP_USER_AGENT}   ^<strong>NameOfBadRobot</strong>.*
RewriteCond %{REMOTE_ADDR}       ^<strong>123\.45\.67\.[8-9]</strong>$
RewriteRule ^<strong>/~quux/foo/arc/</strong>.+   -   [<strong>F</strong>]
</pre></div>
        </dd>
      </dl>

    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="blocked-inline-images" id="blocked-inline-images">Blocage du r�f�rencement � chaud (Hotlinking) d'images</a></h2>

      

      <dl>
        <dt>Description :</dt>

        <dd>
          <p>Cette technique vous permet d'interdire � d'autres sites
	  d'inclure directement vos images dans leurs pages. On fait
	  souvent r�f�rence � cette pratique sous le nom de
	  r�f�rencement � chaud (Hotlinking) qui entra�ne l'utilisation
	  de votre bande passante pour servir des contenus faisant
	  partie du site de quelqu'un d'autre.</p>
        </dd>

        <dt>Solution :</dt>

        <dd>
	<p>Cette technique repose sur la valeur de la variable
	optionnelle <code>HTTP_REFERER</code>. Certaines personnes
	pourront donc contourner cette limitation. Pour la plupart des
	utilisateurs cependant, la requ�te �chouera, en ce sens que
	l'image ne sera pas affich�e depuis le site tiers.</p>
	<p>Il y a plusieurs mani�res de g�rer cette situation.</p>

	<p>Dans le premier exemple, nous rejetons tout simplement la
	requ�te si elle ne provenait pas d'une page appartenant � notre
	site. Pour les besoins de cet exemple, nous supposons que le nom
	de votre site est <code>www.example.com</code>.</p>

<div class="example"><pre>
RewriteCond %{HTTP_REFERER} <strong>!^$</strong>
RewriteCond %{HTTP_REFERER} !www.example.com [NC]
RewriteRule <strong>\.(gif|jpg|png)$</strong>    -   [F,NC]
</pre></div>

	<p>Dans le second exemple, plut�t que de rejeter la requ�te,
	nous affichons une autre image � la place.</p>

<div class="example"><pre>
RewriteCond %{HTTP_REFERER} <strong>!^$</strong>
RewriteCond %{HTTP_REFERER} !www.example.com [NC]
RewriteRule <strong>\.(gif|jpg|png)$</strong>    /images/go-away.png   [R,NC]
</pre></div>

	<p>Dans le troisi�me exemple, nous redirigeons la requ�te vers
	une image appartenant � un site tiers.</p>


<div class="example"><pre>
RewriteCond %{HTTP_REFERER} <strong>!^$</strong>
RewriteCond %{HTTP_REFERER} !www.example.com [NC]
RewriteRule <strong>\.(gif|jpg|png)$</strong> http://other.site.com/image.gif   [R,NC]
</pre></div>
	<p>De tous ces exemples, les deux derniers semblent les plus
	efficaces pour faire en sorte que les gens arr�tent de
	r�f�rencer vos images � chaud, car il ne verront pas les images
	qu'ils s'attendent � voir.</p>

        </dd>
      </dl>

    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="proxy-deny" id="proxy-deny">Interdiction du mandataire</a></h2>

      

      <dl>
        <dt>Description :</dt>

        <dd>
          <p>Comment interdire l'utilisation du mandataire d'Apache � un
	  certain h�te, ou m�me � un utilisateur d'un certain h�te ?</p>
        </dd>

        <dt>Solution :</dt>

        <dd>
          <p>Nous devons tout d'abord nous assurer que
	  <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> se situe en dessous (!) de
	  <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> dans le fichier de configuration
	  lors de la compilation du serveur web Apache. De cette fa�on,
	  il est appel� <em>avant</em> <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>. Nous
	  pouvons alors utiliser la r�gle suivante pour une interdiction
	  concernant un h�te...</p>

<div class="example"><pre>
RewriteCond %{REMOTE_HOST} <strong>^mauvais-h�te\.mon-domaine\.com$</strong>
RewriteRule !^http://[^/.]\.mon-domaine.com.*  - [F]
</pre></div>

          <p>...et celle-ci pour une interdiction concernant un
	  utilisateur d'un certain h�te :</p>

<div class="example"><pre>
RewriteCond %{REMOTE_IDENT}@%{REMOTE_HOST}
<strong>^mauvais-sujet@mauvais-h�te\.mon-domaine\.com$</strong>
RewriteRule !^http://[^/.]\.mon-domaine.com.*  - [F]
</pre></div>
        </dd>
      </dl>

    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="external-rewriting" id="external-rewriting">Moteur de r��criture externe</a></h2>

      

      <dl>
        <dt>Description :</dt>

        <dd>
          <p>Une question de la Faq : comment r�soudre le probl�me
	  FOO/BAR/QUUX/etc. ? <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> ne semble pas
	  devoir y apporter de solution...</p>
        </dd>

        <dt>Solution :</dt>

        <dd>
          <p>Utiliser une <code class="directive"><a href="/mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> ou table de r��criture externe, c'est
	  � dire un programme qui agit de la m�me fa�on qu'une
	  <code class="directive"><a href="/mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>. Il
	  doit �tre lanc� une fois au d�marrage d'Apache, recevoir les
	  URLs des requ�tes sur <code>STDIN</code>, et restituer l'URL
	  r�sultante (en g�n�ral r��crite) sur <code>STDOUT</code> (dans
	  cet ordre !).</p>

<div class="example"><pre>
RewriteEngine on
RewriteMap    quux-table       <strong>prg:</strong>/chemin/vers/table.quux.pl
RewriteRule   ^/~quux/(.*)$  /~quux/<strong>${quux-table:$1}</strong>
</pre></div>

<div class="example"><pre>
#!/chemin/vers/perl

#   d�sactive la mise en tampon des entr�es/sorties, qui risque
#   de provoquer des bouclages infinis pour le serveur Apache
$| = 1;

#   lit les URLs (une par ligne) depuis stdin et
#   g�n�re l'URL transform�e sur stdout

#   read URLs one per line from stdin and
#   generate substitution URL on stdout
while (&lt;&gt;) {
    s|^foo/|bar/|;
    print $_;
}
</pre></div>

          <p>Ceci n'est qu'un exemple de d�monstration qui ne fait que
	  r��crire les URLs du style <code>/~quux/foo/...</code> vers
	  <code>/~quux/bar/...</code>. En fait, vous pouvez programmer
	  la substitution que vous voulez. Notez cependant que si de
	  tels programmes peuvent aussi �tre <strong>utilis�s</strong>
	  par un utilisateur standard, seul l'administrateur du syst�me
	  peut les <strong>�crire</strong>.</p>
        </dd>
      </dl>

    </div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span></p>
</div><div id="footer">
<p class="apache">Copyright 2010 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<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>
</body></html>