Newer
Older
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
<?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>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Utilisation de RewriteMap - Serveur Apache HTTP Version 2.4</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 rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<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="http://wiki.apache.org/httpd/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.4</p>
<img alt="" src="../images/feather.png" /></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
<div id="path">
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Utilisation de RewriteMap</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/rewritemap.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/rewritemap.html" title="Franais"> fr </a></p>
</div>
<div class="outofdate">Cette traduction peut tre prime. Vrifiez la version
anglaise pour les changements rcents.</div>
<p>Ce document est un complment la <a href="../mod/mod_rewrite.html">documentation de rfrence</a> du
module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Il dcrit l'utilisation de la
directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>, et
fournit des exemples pour chacun des diffrents types de
<code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>.</p>
<div class="warning">Notez que la plupart de ces exemples ne
fonctionneront pas en l'tat dans le contexte de votre configuration
particulire ; vous devez donc vous attacher les
comprendre, plutt que de simplement les insrer dans votre
configuration par copier/coller.</div>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#introduction">Introduction</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#int">int: Fonction interne</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#txt">txt: tables de correspondances au format texte</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rnd">rnd: Fichier texte valeurs de substitution multiples
choisies de manire alatoire</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#dbm">dbm: Fichier condens DBM</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#prg">prg: Programme de rcriture externe</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#dbd">dbd ou fastdbd: requte SQL</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#summary">Rsum</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du module
mod_rewrite</a></li><li><a href="intro.html">Introduction mod_rewrite</a></li><li><a href="remapping.html">Redirection et remise en
correspondance</a></li><li><a href="access.html">Contrle d'accs</a></li><li><a href="vhosts.html">Serveurs virtuels</a></li><li><a href="proxy.html">Mise en cache</a></li><li><a href="advanced.html">Techniques avances</a></li><li><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></li><li><a href="#comments_section">Commentaires</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="introduction" id="introduction">Introduction</a></h2>
<p>
La directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>
dfinit une fonction externe qui peut tre appele depuis une
directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> ou
<code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> pour
accomplir une rcriture trop complique, ou trop spcialise pour
tre effectue partir d'expressions rationnelles. Vous trouverez
ci-dessous les diffrents types disponibles pour la source de
donnes, ceux-ci tant par ailleurs numrs dans la documentation de
rfrence de <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>.</p>
<p>La syntaxe de la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> est la suivante
:</p>
<pre class="prettyprint lang-config">RewriteMap <em>MapName</em> <em>MapType</em>:<em>MapSource</em></pre>
<p>L'argument <a id="mapfunc" name="mapfunc"><em>MapName</em></a>
est un nom arbitraire que vous associez la table de
correspondances, et que vous
pourrez utilisez par la suite dans les directives de rcriture. Les
recherches dans la table de correspondance s'effectuent en
respectant cette syntaxe :</p>
<p class="indent">
<strong>
<code>${</code> <em>nom-map</em> <code>:</code>
<em>cl-recherche</em>
<code>}</code> <br /> <code>${</code> <em>nom-map</em> <code>:</code>
<em>cl-recherche</em> <code>|</code> <em>DefaultValue</em> <code>}</code>
</strong>
</p>
<p>Lorsque cette syntaxe est employe, la table de correspondances
<em>nom-map</em> est consulte et la cl <em>cl-recherche</em>
recherche. Si la cl est trouve, la fonction de recherche dans la
table de correspondance est remplace par <em>SubstValue</em>, ou
par <em>DefaultValue</em> dans le cas contraire, ou par la chane
vide si aucune <em>DefaultValue</em> n'a t spcifie.</p>
<p>Par exemple, vous pouvez dfinir une directive
<code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> comme suit :</p>
<pre class="prettyprint lang-config">RewriteMap examplemap "txt:/path/to/file/map.txt"</pre>
<p>Vous pourrez par la suite utiliser cette table de correspondances
dans une directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> comme suit :</p>
<pre class="prettyprint lang-config">RewriteRule "^/ex/(.*)" "${examplemap:$1}"</pre>
<p>Il est possible de spcifier une valeur par dfaut qui sera utilise
si la recherche dans la table de correspondances est infructueuse :</p>
<pre class="prettyprint lang-config">RewriteRule "^/ex/(.*)" "${examplemap:$1|/not_found.html}"</pre>
<div class="note"><h3>Contexte de rpertoire et fichiers.htaccess</h3>
<p>
Vous ne pouvez utiliser la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> ni dans
les sections <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, ni dans les fichiers
<code>.htaccess</code>. Vous devez dclarer la table de correspondances
au niveau du serveur principal ou dans un contexte de serveur virtuel.
En revanche, si vous ne pouvez pas dclarer la table dans une section
<Directory> ou dans un fichier <code>.htaccess</code>, vous
pourrez y faire rfrence dans ces contextes, une fois cette table
cre.
</p>
</div>
<p>Les sections suivantes dcrivent les diffrents types de tables de
correspondances <em>type-map</em> disponibles, et fournissent des
exemples pour chacun d'entre eux.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="int" id="int">int: Fonction interne</a></h2>
<p>Lorsque le type-map <code>int</code> est spcifi, la source est
une des fonctions RewriteMap internes disponibles. Les dveloppeurs
de modules peuvent fournir des fonctions internes supplmentaires en
les enregistrant via l'API <code>ap_register_rewrite_mapfunc</code>.
Les fonctions fournies par dfaut sont :
</p>
<ul>
<li><strong>toupper</strong>:<br />
Met tous les caractres de la cl en majuscules.</li>
<li><strong>tolower</strong>:<br />
Met tous les caractres de la cl en minuscules.</li>
<li><strong>escape</strong>:<br />
Protge les caractres spciaux de la cl en les
transformant en leur code hexadcimal.</li>
<li><strong>unescape</strong>:<br />
Retraduit les codes hexadcimaux de la cl en caractres
spciaux.</li>
</ul>
<p>
Pour utiliser une de ces fonctions, crez une
<code>RewriteMap</code> faisant rfrence cette fonction int, et
utilisez-la dans votre rgle <code>RewriteRule</code> :
</p>
<p> <strong>Redirige un URI vers son quivalent en minuscules</strong></p>
<pre class="prettyprint lang-config">RewriteMap lc int:tolower
RewriteRule "(.*)" "${lc:$1}" [R]</pre>
<div class="note">
<p>Notez que cet exemple n'est fourni qu' titre d'illustration,
et ne constitue en aucun cas une recommandation. Si vous voulez
rendre des URLs insensibles la casse, vous devez plutt vous
tourner vers <code class="module"><a href="../mod/mod_speling.html">mod_speling</a></code>.
</p>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="txt" id="txt">txt: tables de correspondances au format texte</a></h2>
<p>Lorsqu'un type-map <code>txt</code> est utilis, la source-map
est un chemin du systme de fichiers vers un fichier de
correspondances au format texte, contenant sur chaque ligne une
paire cl/valeur spares par un espace. Il est possible d'insrer
des commentaires sous la forme de chanes commenant par le caractre
'#'.</p>
<p>Voici un exemple d'entres valides dans un fichier de
correspondances :</p>
<div class="example"><p><code>
# Ligne de commentaires<br />
<strong><em>cl</em> <em>valeur-substitution</em></strong><br />
<strong><em>cl</em> <em>valeur-substitution</em></strong> # commentaire<br />
</code></p></div>
<p>Lorsque la table de correspondance fait l'objet d'une recherche,
la valeur spcifie est recherche dans le premier champ, et si elle
est trouve, la valeur de substitution est renvoye.</p>
<p>Par exemple, nous pourrions utiliser un fichier de
correspondances pour traduire des noms de produits en identifiants
produits pour obtenir des URLs plus simples mmoriser, en
utilisant la recette suivante :</p>
<p><strong>Product to ID configuration</strong></p>
<pre class="prettyprint lang-config">RewriteMap product2id "txt:/etc/apache2/productmap.txt"
RewriteRule "^/product/(.*)" "/prods.php?id=${product2id:$1|NOTFOUND}" [PT]</pre>
<p>Nous supposons ici que le script <code>prods.php</code> sait quoi
faire lorsqu'il reoit un argument <code>id=NOTFOUND</code>, dans
le cas o le produit ne se trouve pas dans la table de
correspondances.</p>
<p>Le fichier <code>/etc/apache2/map-produit.txt</code> contient ce
qui suit :</p>
<div class="example"><h3>Fichier de correspondances Produit - Identifiant</h3><p><code>
##<br />
## map-produit.txt - Fichier de correspondances Produit - Identifiant<br />
##<br />
<br />
TELEVISION 993<br />
STEREO 198<br />
CANNE-A-PECHE 043<br />
BALLON-BASKET 418<br />
TELEPHONE 328
</code></p></div>
<p>Ainsi, lorsqu'une requte pour
<code>http://example.com/produit/TELEVISION</code> arrive, la directive
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> s'applique, et la
requte est transforme en interne en <code>/prods.php?id=993</code>.</p>
<div class="note"><h3>Note: fichiers .htaccess</h3>
L'exemple donn est conu pour tre utilis dans un contexte de
serveur principal ou de serveur virtuel. Si vous voulez l'utiliser
dans un fichier <code>.htaccess</code>, vous devrez supprimer le
slash de dbut dans le modle de rcriture afin que ce dernier
puisse correspondre toute URL :
<pre class="prettyprint lang-config">RewriteRule "^product/(.*)" "/prods.php?id=${product2id:$1|NOTFOUND}" [PT]</pre>
</div>
<div class="note"><h3>Recherches mises en cache</h3>
<p>
Les cls de recherche sont mises en cache par httpd jusqu' ce que
le <code>mtime</code> (date de modification) du fichier de
correspondances soit modifi, ou que le serveur httpd soit
redmarr, ce qui amliore les performances pour les tables de
correspondances consultes par de nombreuses requtes.
</p>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="rnd" id="rnd">rnd: Fichier texte valeurs de substitution multiples
choisies de manire alatoire</a></h2>
<p>Lorsque le type-map spcifi est <code>rnd</code>, la source est
un chemin du systme de fichiers vers un fichier de correspondances
au format texte dont chaque ligne contient une cl, et une ou
plusieurs valeurs spares par le caractre <code>|</code>. Si une
cl convient, une des valeurs correspondantes sera choisie de
manire alatoire.</p>
<p>Par exemple, vous pouvez utiliser le fichier de correspondances
et les directives suivants pour implmenter une rpartition de
charge alatoire entre plusieurs serveurs d'arrire-plan, par
l'intermdiaire d'un mandataire inverse. Les images sont envoyes
vers un des serveurs de l'ensemble 'statique', tandis que tout le
reste est envoy vers un des serveurs de l'ensemble 'dynamique'.</p>
<div class="example"><h3>Fichier de correspondances</h3><p><code>
##<br />
## map.txt -- table de rcriture<br />
##<br />
<br />
statique www1|www2|www3|www4<br />
dynamique www5|www6
</code></p></div>
<p><strong>Directives de configuration</strong></p>
<pre class="prettyprint lang-config">RewriteMap servers "rnd:/path/to/file/map.txt"
RewriteRule "^/(.*\.(png|gif|jpg))" "http://${servers:static}/$1" [NC,P,L]
RewriteRule "^/(.*)" "http://${servers:dynamic}/$1" [P,L]</pre>
<p>Ainsi, lorsqu'une image est demande et que la premire rgle
convient, <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> recherche la chane
<code>statique</code> dans le fichier de correspondances qui
renvoie un des noms de serveurs spcifis de manire alatoire,
ce dernier tant utilis dans la cible de la rgle
<code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>.</p>
<p>Si vous voulez qu'un des serveurs soit plus souvent sollicit que
les autres (par exemple s'il possde plus de mmoire, et peut donc
traiter d'avantage de requtes), spcifiez-le plusieurs fois dans la
liste des serveurs.</p>
<div class="example"><p><code>
statique www1|www1|www2|www3|www4
</code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="dbm" id="dbm">dbm: Fichier condens DBM</a></h2>
<p>Lorsque le type-map <code>dbm</code> est utilis, la source est
un chemin du systme de fichiers vers un fichier de donnes DBM
contenant des paires cl/valeur permettant d'effectuer la
correspondance. Le fonctionnement est identique celui du type-map
<code>txt</code>, mais beaucoup plus rapide car un fichier DBM est
index, alors qu'un fichier texte ne l'est pas. L'accs la cl
recherche est donc plus rapide.</p>
<p>Vous pouvez ventuellement spcifier un type dbm particulier :</p>
<pre class="prettyprint lang-config">RewriteMap examplemap "dbm=sdbm:/etc/apache/mapfile.dbm"</pre>
<p>Ce type peut tre choisi parmi <code>sdbm</code>, <code>gdbm</code>,
<code>ndbm</code> ou <code>db</code>. Il est
cependant recommand d'utiliser l'utilitaire <a href="../programs/httxt2dbm.html">httxt2dbm</a> fourni avec le
serveur HTTP Apache, car il utilise la bibliothque DBM approprie,
savoir celle qui a t utilise lors de la compilation de httpd.</p>
<p>Pour crer un fichier dbm, crez tout d'abord un fichier de
correspondances au format texte comme dcrit dans la section <a href="#txt">txt</a>. Traitez ensuite ce fichier avec
<code>httxt2dbm</code> :</p>
<div class="example"><p><code>
$ httxt2dbm -i fichier-map.txt -o fichier-map.map
</code></p></div>
<p>Vous pouvez alors faire rfrence au fichier obtenu dans votre
directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> :</p>
<pre class="prettyprint lang-config">RewriteMap mapname "dbm:/etc/apache/mapfile.map"</pre>
<div class="note">
<p>Notez qu'avec certains types dbm, plusieurs fichiers possdant le
mme nom de base sont crs. Par exemple, vous pouvez obtenir deux
fichiers nomms <code>fichier-map.map.dir</code> et
<code>fichier-map.map.pag</code>. Ceci est tout fait normal, et vous
ne devez utiliser que le nom de base <code>fichier-map.map</code> dans votre
directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>.</p>
</div>
<div class="note"><h3>Mise en cache des recherches</h3>
<p>
Les cls de recherche sont mises en cache par httpd jusqu' ce que
le <code>mtime</code> (date de modification) du fichier de
correspondances soit modifi, ou que le serveur httpd soit
redmarr, ce qui amliore les performances pour les tables de
correspondances consultes par de nombreuses requtes.
</p>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="prg" id="prg">prg: Programme de rcriture externe</a></h2>
<p>Lorque le type-map <code>prg</code> est spcifi, la source est
un chemin du systme de fichiers vers un programme excutable
destin effectuer la mise en correspondance. Il peut s'agir d'un
fichier binaire compil, ou d'un programme en langage interprt
comme Perl ou Python.</p>
<p>Ce programme est lanc une fois au dmarrage du serveur HTTP
Apache, puis communique avec le moteur de rcriture via
<code>STDIN</code> et <code>STDOUT</code>. En d'autres termes, pour
chaque recherche de correspondance, il reoit un argument via
<code>STDIN</code>, et doit renvoyer en guise de rponse une chane
termine par un caractre nouvelle-ligne sur <code>STDOUT</code>. Si
la recherche de correspondance est infructueuse, le programme doit
l'indiquer en retournant la chane de quatre caractres
"<code>NULL</code>".</p>
<p>Les programmes de rcriture externes ne sont pas lancs s'il
n'ont pas t dfinis dans un contexte o la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriteengine">RewriteEngine</a></code> est dfinie
<code>on</code>.</p>
<p>Cette fonctionnalit utilise le mutex <code>rewrite-map</code>
ncessaire la fiabilit des communications avec le programme. Le
mcanisme de mutex et le fichier verrou peuvent tre dfinis via la
directive <code class="directive"><a href="../mod/core.html#mutex">Mutex</a></code>.</p>
<p>Voici un exemple simple qui remplace tous les tirets par des
caractres de soulignement dans l'URI de la requte.</p>
<p><strong>Configuration de la rcriture</strong></p>
<pre class="prettyprint lang-config">RewriteMap d2u "prg:/www/bin/dash2under.pl"
RewriteRule "-" "${d2u:%{REQUEST_URI}}"</pre>
<p><strong>dash2under.pl</strong></p>
<pre class="prettyprint lang-perl"> #!/usr/bin/perl
$| = 1; # Turn off I/O buffering
while (<STDIN>) {
s/-/_/g; # Remplace tous les tirets par des caractres de soulignement
print $_;
}</pre>
<div class="note"><h3>Mises en garde !</h3>
<ul>
<li>Votre programme doit tre le plus
simple possible. Si le programme se bloque, httpd va attendre
indfiniment une rponse de sa part, et par consquent ne rpondra plus
aux requtes.</li>
<li>Assurez-vous de bien dsactiver la mise en tampon dans votre
programme. En Perl, ceci est effectu la seconde ligne du script de
l'exemple - <code>$| = 1;</code> - La syntaxe sera bien entendu
diffrente dans
d'autres langages. Si les entres/sorties sont mises en tampon, httpd va
attendre une sortie, et va par consquent se bloquer.</li>
<li>Rappelez-vous qu'il n'existe qu'une copie du programme lanc au
dmarrage du serveur, et que toutes les requtes vont devoir passer par
ce goulot d'tranglement. Ceci peut provoquer des ralentissements
significatifs si de nombreuses requtes doivent tre traites, ou si le
script lui-mme est trs lent.</li>
</ul>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="dbd" id="dbd">dbd ou fastdbd: requte SQL</a></h2>
<p>Lorsque le type-map <code>dbd</code> ou <code>fastdbd</code> est
spcifi, la source est une requte SQL SELECT qui reoit un
argument et renvoie une seule valeur.</p>
<p>Pour que cette requte puisse tre excute,
<code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> doit tre configur pour attaquer la base
de donnes concerne.</p>
<p>Ce type-map existe sous deux formes. Avec le type-map
<code>dbd</code>, la requte est excute chaque demande, tandis
qu'avec le type-map <code>fastdbd</code>, les recherches dans la
base de donnes sont mises en cache en interne. <code>fastdbd</code>
est donc plus efficace et donc plus rapide ; par contre, il ne
tiendra pas compte des modifications apportes la base de donnes
jusqu' ce que le serveur soit redmarr.</p>
<p>Si une requte renvoie plusieurs enregistrements, un de ceux-ci
sera slectionn alatoirement.</p>
<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">RewriteMap ma-requete "fastdbd:SELECT destination FROM rewrite WHERE source = %s"</pre>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="summary" id="summary">Rsum</a></h2>
<p>La directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> peut apparatre
plusieurs fois. Utilisez une directive
<code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> pour chaque fonction de mise en
correspondance pour dclarer son fichier de correspondances.</p>
<p>Bien que l'on ne puisse pas <strong>dclarer</strong> de fonction
de mise en correspondance dans un contexte de rpertoire (fichier
<code>.htaccess</code> ou section <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>), il est
possible d'utiliser cette fonction dans un tel contexte.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/rewrite/rewritemap.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/rewrite/rewritemap.html" title="Franais"> fr </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/rewritemap.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2017 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="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html>