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
|
<?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>N�gociation de contenu - 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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.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="./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.5</p>
<img alt="" src="./images/feather.gif" /></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.5</a></div><div id="page-content"><div id="preamble"><h1>N�gociation de contenu</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/content-negotiation.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/content-negotiation.html" title="Fran�ais"> fr </a> |
<a href="./ja/content-negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/content-negotiation.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/content-negotiation.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
</div>
<p>Apache HTTPD supporte la n�gociation de
contenu telle qu'elle est d�crite
dans la sp�cification HTTP/1.1. Il peut choisir la meilleure repr�sentation
d'une ressource en fonction des pr�f�rences du navigateur pour ce qui
concerne le type de media, les langages, le jeu de caract�res et son
encodage. Il impl�mente aussi quelques fonctionnalit�s pour traiter de
mani�re plus intelligente les requ�tes en provenance de navigateurs qui
envoient des informations de n�gociation incompl�tes.</p>
<p>La n�gociation de contenu est assur�e par le module
<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> qui est compil� par d�faut
dans le serveur.</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#about">� propos de la n�gociation de contenu</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#negotiation">La n�gociation avec httpd</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#methods">Les m�thodes de n�gociation</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#better">Ajustement des valeurs de qualit�</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#extensions">Extensions � la n�gociation de contenu
transparente</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#naming">Remarques � propos des liens hypertextes et des
conventions de nommage</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#caching">Remarque sur la mise en cache</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="about" id="about">� propos de la n�gociation de contenu</a></h2>
<p>Une ressource peut �tre disponible selon diff�rentes repr�sentations.
Par exemple, elle peut �tre disponible en diff�rents langages ou pour
diff�rents types de m�dia, ou une combinaison des deux.
Pour faire le meilleur choix, on peut fournir � l'utilisateur une page
d'index, et le laisser choisir. Cependant, le serveur peut souvent faire
ce choix automatiquement. Ceci est possible car les navigateurs peuvent
envoyer des informations sur les
repr�sentations qu'ils pr�f�rent � l'int�rieur de chaque requ�te.
Par exemple, un navigateur peut indiquer
qu'il pr�f�re voir les informations en fran�ais, mais qu'en cas
d'impossibilit� l'anglais peut convenir. Les navigateurs indiquent leurs
pr�f�rences � l'aide d'en-t�tes dans la requ�te. Pour ne demander que des
repr�sentations en fran�ais, le navigateur peut utiliser l'en-t�te :</p>
<div class="example"><p><code>Accept-Language: fr</code></p></div>
<p>Notez qu'il ne sera tenu compte de cette pr�f�rence que s'il existe un
choix de repr�sentations et que ces derni�res varient en fonction
du langage.</p>
<p>� titre d'exemple d'une requ�te plus complexe, ce navigateur a �t�
configur� pour accepter le fran�ais et l'anglais, avec une pr�f�rence pour
le fran�ais, et accepter diff�rents types de m�dia, avec une pr�f�rence
pour HTML par rapport � au texte plat ("plain text") ou autres types de fichiers texte, et
avec une pr�f�rence pour GIF ou JPEG par rapport � tout autre type de
m�dia, mais autorisant tout autre type de m�dia en dernier ressort :</p>
<div class="example"><p><code>
Accept-Language: fr; q=1.0, en; q=0.5<br />
Accept: text/html; q=1.0, text/*; q=0.8, image/gif; q=0.6, image/jpeg; q=0.6, image/*; q=0.5, */*; q=0.1
</code></p></div>
<p>httpd supporte la n�gociation de contenu "server driven" (telle qu'elle
est d�finie dans la sp�cification HTTP/1.1), o� c'est le serveur qui
d�cide quelle est la meilleure repr�sentation � retourner pour la ressource
demand�e. Il supporte enti�rement les en-t�tes de requ�te
<code>Accept</code>, <code>Accept-Language</code>,
<code>Accept-Charset</code> et <code>Accept-Encoding</code>.
httpd supporte aussi la n�gociation de contenu transparente, qui est un
protocole de n�gociation exp�rimental d�fini dans les RFC 2295 et 2296.
Il ne supporte pas la n�gociation de fonctionnalit� (feature negotiation)
telle qu'elle est d�finie dans ces RFCs.</p>
<p>Une <strong>ressource</strong> est une entit� conceptuelle identifi�e
par une URI (RFC 2396). Un serveur HTTP comme le serveur HTTP Apache
propose l'acc�s � des
<strong>repr�sentations</strong> de la ressource � l'int�rieur de son
espace de nommage, chaque repr�sentation �tant compos�e d'une s�quence
d'octets avec la d�finition d'un type de media, d'un jeu de caract�res,
d'un encodage, etc... A un instant donn�, chaque ressource peut �tre
associ�e avec z�ro, une ou plusieurs repr�sentations. Si plusieurs
repr�sentations sont disponibles, la ressource est qualifi�e de
<strong>n�gociable</strong> et chacune de ses repr�sentations se nomme
<strong>variante</strong>. Les diff�rences entre les
variantes disponibles d'une ressource n�gociable constituent les
<strong>dimensions</strong> de la n�gociation.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="negotiation" id="negotiation">La n�gociation avec httpd</a></h2>
<p>Afin de n�gocier une ressource, on doit fournir au serveur des
informations � propos de chacune des variantes. Il y a deux mani�res
d'accomplir ceci :</p>
<ul>
<li>Utiliser une liste de correspondances de type ("type-map") (<em>c'est � dire</em>
un fichier <code>*.var</code>) qui nomme explicitement les fichiers
contenant les variantes, ou</li>
<li>Utiliser une recherche "multivues", o� le serveur effectue une
recherche de correspondance sur un motif de nom de fichier implicite et
fait son choix parmi les diff�rents r�sultats.</li>
</ul>
<h3><a name="type-map" id="type-map">Utilisation d'un fichier de
correspondances de types (type-map)</a></h3>
<p>Une liste de correspondances de types est un document associ� au
gestionnaire <code>type-map</code> (ou, dans un souci de compatibilit�
ascendante avec des configurations de httpd plus anciennes, le
<a class="glossarylink" href="./glossary.html#type mime" title="voir glossaire">type MIME</a>
<code>application/x-type-map</code>). Notez que pour utiliser cette
fonctionnalit�, vous devez, dans le fichier de configuration, d�finir un
gestionnaire qui associe un suffixe de fichier � une <code>type-map</code>;
ce qui se fait simplement en ajoutant</p>
<div class="example"><p><code>AddHandler type-map .var</code></p></div>
<p>dans le fichier de configuration du serveur.</p>
<p>Les fichiers de correspondances de types doivent poss�der le m�me nom que
la ressource qu'ils d�crivent, avec pour extension
<code>.var</code>. Dans l'exemple ci-dessous, la ressource a pour
nom <code>foo</code>, et le fichier de correspondances se nomme donc
<code>foo.var</code>.</p>
<p>Ce fichier doit comporter une entr�e pour chaque variante
disponible; chaque entr�e consiste en une ligne contigu� d'en-t�tes au
format HTTP. les entr�es sont s�par�es par des lignes vides. Les lignes
vides � l'int�rieur d'une entr�e sont interdites. Par convention, le
fichier de correspondances de types d�bute par une entr�e concernant l'entit�
consid�r�e dans son ensemble (bien que ce ne soit pas obligatoire, et
ignor� si pr�sent). Un exemple de fichier de
correspondance de types est fourni
ci-dessous.</p>
<p>Les URIs de ce fichier sont relatifs � la localisation du fichier
de correspondances de types. En g�n�ral, ces fichiers se trouveront dans le
m�me r�pertoire que le fichier de correspondances de types, mais ce
n'est pas obligatoire. Vous pouvez utiliser des URIs absolus ou
relatifs pour tout fichier situ� sur le m�me serveur que le fichier
de correspondances.</p>
<div class="example"><p><code>
URI: foo<br />
<br />
URI: foo.en.html<br />
Content-type: text/html<br />
Content-language: en<br />
<br />
URI: foo.fr.de.html<br />
Content-type: text/html;charset=iso-8859-2<br />
Content-language: fr, de<br />
</code></p></div>
<p>Notez aussi qu'un fichier de correspondances de types prend le pas sur
les extensions de noms de fichiers, m�me si les Multivues sont activ�es.
Si les variantes sont de qualit�s diff�rentes, on doit l'indiquer
� l'aide du param�tre "qs" � la suite du type de m�dia, comme pour cette
image
(disponible aux formats JPEG, GIF, ou ASCII-art) : </p>
<div class="example"><p><code>
URI: foo<br />
<br />
URI: foo.jpeg<br />
Content-type: image/jpeg; qs=0.8<br />
<br />
URI: foo.gif<br />
Content-type: image/gif; qs=0.5<br />
<br />
URI: foo.txt<br />
Content-type: text/plain; qs=0.01<br />
</code></p></div>
<p>Les valeurs de qs peuvent varier de 0.000 � 1.000. Notez que toute
variante poss�dant une valeur de qs de 0.000 ne sera jamais choisie.
Les variantes qui n'ont pas de param�tre qs d�fini se voient attribuer
une valeur de 1.0. Le param�tre qs indique la qualit� relative de la
variante compar�e � celle des autres variantes disponibles, sans tenir
compte des capacit�s du client. Par exemple, un fichier JPEG poss�de
en g�n�ral une qualit� sup�rieure � celle d'un fichier ASCII s'il
repr�sente une photographie. Cependant, si la ressource repr�sent�e est
� un ASCII art original, la repr�sentation ASCII sera de meilleure qualit�
que la repr�sentation JPEG. Ainsi une valeur de qs est associ�e � une
variante en fonction de la nature de la ressource qu'elle repr�sente.</p>
<p>La liste compl�te des en-t�tes reconnus est disponible dans la
documentation sur les <a href="mod/mod_negotiation.html#typemaps">correspondances de types du
module mod_negotiation</a>.</p>
<h3><a name="multiviews" id="multiviews">Multivues (option Multiviews)</a></h3>
<p><code>MultiViews</code> est une option qui s'applique � un r�pertoire,
ce qui signifie qu'elle peut �tre activ�e � l'aide d'une directive
<code class="directive"><a href="./mod/core.html#options">Options</a></code> � l'int�rieur d'une section
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="./mod/core.html#location"><Location></a></code> ou <code class="directive"><a href="./mod/core.html#files"><Files></a></code> dans
<code>httpd.conf</code>, ou (si <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> est correctement positionn�e) dans
des fichiers
<code>.htaccess</code>. Notez que <code>Options All</code>
n'active pas <code>MultiViews</code>; vous devez activer cette option en
la nommant explicitement.</p>
<p>L'effet de <code>MultiViews</code> est le suivant : si le serveur re�oit
une requ�te pour <code>/tel/r�pertoire/foo</code>, si
<code>MultiViews</code> est activ�e pour
<code>/tel/r�pertoire</code>, et si
<code>/tel/r�pertoire/foo</code> n'existe <em>pas</em>, le serveur parcourt
le r�pertoire � la recherche de fichiers nomm�s foo.*, et simule
litt�ralement une correspondance de types (type map) qui liste tous ces
fichiers, en leur associant les m�mes types de m�dia et encodages de
contenu qu'ils auraient eu si le client avait demand� l'acc�s � l'un
d'entre eux par son nom. Il choisit ensuite ce qui correspond le mieux
aux besoins du client.</p>
<p><code>MultiViews</code> peut aussi s'appliquer � la recherche du fichier
nomm� par la directive <code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>, si le serveur tente d'indexer
un r�pertoire. Si les fichiers de configuration sp�cifient</p>
<div class="example"><p><code>DirectoryIndex index</code></p></div>
<p>le serveur va choisir entre <code>index.html</code>
et <code>index.html3</code> si les deux fichiers sont pr�sents. Si aucun
n'est pr�sent, mais <code>index.cgi</code> existe,
le serveur l'ex�cutera.</p>
<p>Si, parcequ'elle n'est pas reconnue par <code>mod_mime</code>,
l'extension d'un des fichiers du r�pertoire ne permet pas de
d�terminer son jeu de caract�res, son type de contenu, son langage, ou son
encodage, alors
le r�sultat d�pendra de la d�finition de la directive <code class="directive"><a href="./mod/mod_mime.html#multiviewsmatch">MultiViewsMatch</a></code>. Cette directive d�termine
si les gestionnaires (handlers), les filtres, et autres types d'extensions
peuvent participer � la n�gociation MultiVues.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="methods" id="methods">Les m�thodes de n�gociation</a></h2>
<p>Une fois obtenue la liste des variantes pour une ressource donn�e,
httpd dispose de deux m�thodes pour choisir la meilleure variante �
retourner, s'il y a lieu, soit � partir d'un fichier de
correspondances de types, soit en se basant sur les noms de fichiers du
r�pertoire. Il n'est pas n�cessaire de conna�tre en d�tails comment la
n�gociation fonctionne r�ellement pour pouvoir utiliser les fonctionnalit�s
de n�gociation de contenu de httpd. La suite de ce document explique
cependant les m�thodes utilis�es pour ceux ou celles qui sont
int�ress�s(�es). </p>
<p>Il existe deux m�thodes de n�gociation :</p>
<ol>
<li><strong>La n�gociation effectu�e par le serveur selon l'algorithme
de httpd</strong> est normalement utilis�e. l'algorithme de
httpd est
expliqu� plus en d�tails ci-dessous. Quand cet algorithme est utilis�,
httpd peut parfois "bricoler" le facteur de qualit� (qs) d'une dimension
particuli�re afin d'obtenir un meilleur r�sultat.
La mani�re dont httpd peut modifier les facteurs de qualit� est
expliqu�e plus en d�tails ci-dessous.</li>
<li><strong>La n�gociation de contenu transparente</strong> est utilis�e
quand le navigateur le demande explicitement selon le m�canisme d�fini
dans la RFC 2295. Cette m�thode de n�gociation donne au navigateur le
contr�le total du choix de la meilleure variante; le r�sultat d�pend
cependant de la sp�cificit� des algorithmes utilis�s par le navigateur.
Au cours du processus de n�gociation transparente, le navigateur peut
demander � httpd d'ex�cuter l'"algorithme de s�lection de variante �
distance" d�fini dans la RFC 2296.</li>
</ol>
<h3><a name="dimensions" id="dimensions">Les dimensions de la n�gociation</a></h3>
<table>
<tr valign="top">
<th>Dimension</th>
<th>Notes</th>
</tr>
<tr valign="top">
<td>Type de m�dia</td>
<td>Le navigateur affiche ses pr�f�rences � l'aide du champ d'en-t�te
<code>Accept</code>. Chaque type de m�dia peut se voir associ� un facteur de
qualit�. La description de la variante peut aussi avoir un facteur de
qualit� (le param�tre "qs").</td>
</tr>
<tr valign="top">
<td>Langage</td>
<td>Le navigateur affiche ses pr�f�rences � l'aide du champ d'en-t�te
<code>Accept-Language</code>. Chaque langue peut se voir associ� un facteur de
qualit�. Les variantes peuvent �tre associ�es avec z�ro, un ou
plusieurs langages.</td>
</tr>
<tr valign="top">
<td>Encoding</td>
<td>Le navigateur affiche ses pr�f�rences � l'aide du champ d'en-t�te
<code>Accept-Encoding</code>. Chaque encodage peut se voir associ� un facteur de
qualit�.</td>
</tr>
<tr valign="top">
<td>Charset</td>
<td>Le navigateur affiche ses pr�f�rences � l'aide du champ d'en-t�te
<code>Accept-Charset</code>. Chaque jeu de caract�re peut se voir associ� un facteur de
qualit�. Les variantes peuvent pr�ciser un jeu de caract�res comme
param�tre du type de m�dia.</td>
</tr>
</table>
<h3><a name="algorithm" id="algorithm">L'algorithme de n�gociation de
httpd</a></h3>
<p>httpd peut utiliser l'algorithme suivant pour choisir la "meilleure"
variante (s'il y en a une) � retourner au navigateur. Cet algorithme n'est pas
configurable. Il fonctionne comme suit :</p>
<ol>
<li>En premier lieu, pour chaque dimension de la n�gociation, consulter
le champ d'en-t�te <em>Accept*</em> appropri� et assigner une qualit� �
chaque variante. Si l'en-t�te <em>Accept*</em> pour toute dimension
implique que la variante n'est pas acceptable, �liminer cette derni�re.
S'il ne reste plus de variante, aller � l'�tape 4.</li>
<li>
Choisir la "meilleure" variante par �limination. Chacun des tests
suivants est effectu� dans cet ordre. Toute variante non s�lectionn�e
� l'issue d'un test est �limin�e. Apr�s chaque test, s'il reste une
seule variante, choisir cette derni�re comme celle qui correspond le
mieux puis aller � l'�tape 3. S'il reste plusieurs variantes, passer
au test suivant.
<ol>
<li>Multiplier le facteur de qualit� de l'en-t�te
<code>Accept</code> par le facteur de qualit� "qs" pour le type de
m�dia de ces variantes, et choisir la variante qui poss�de la valeur
la plus importante.</li>
<li>S�lectionner les variantes qui poss�dent le facteur de qualit�
de langage le plus haut.</li>
<li>S�lectionner les variantes dont le langage correspond le mieux,
en se basant sur l'ordre des langages de l'en-t�te
<code>Accept-Language</code> (s'il existe), ou de la directive
<code>LanguagePriority</code> (si elle existe).</li>
<li>S�lectionner les variantes poss�dant le param�tre de m�dia
"level" le plus �lev� (utilis� pour pr�ciser la version des types de
m�dia text/html).</li>
<li>S�lectionner les variantes poss�dant le param�tre de m�dia
"charset" (jeu de caract�res) qui correspond le mieux, en se basant
sur la ligne d'en-t�te <code>Accept-Charset</code> . Le jeu de
caract�res ISO-8859-1 est acceptable sauf s'il est explicitement
exclus. Les variantes avec un type de m�dia <code>text/*</code>
mais non explicitement associ�es avec un jeu de caract�res
particulier sont suppos�es �tre en ISO-8859-1.</li>
<li>S�lectionner les variantes dont le param�tre de m�dia "charset"
associ� n'est <em>pas</em> ISO-8859-1. S'il n'en existe pas,
s�lectionner toutes les variantes.</li>
<li>S�lectionner les variantes avec le meilleur encodage. S'il existe
des variantes avec un encodage acceptable pour le client,
s�lectionner celles-ci. Sinon, s'il existe des variantes encod�es et
des variantes non encod�es, ne s�lectionner que les variantes non
encod�es. Si toutes les variantes sont encod�es ou si aucune
ne l'est, s�lectionner toutes les variantes.</li>
<li>S�lectionner les variantes dont le contenu a la longueur
la plus courte.</li>
<li>S�lectionner la premi�re des variantes restantes. Il s'agira
soit de la premi�re variante list�e dans le fichier de
correspondances de types, soit, quand les variantes sont lues depuis
le r�pertoire, la premi�re par ordre alphab�tique quand elles sont
tri�es selon le code ASCII.</li>
</ol>
</li>
<li>L'algorithme a maintenant s�lectionn� une variante consid�r�e comme
la "meilleure", il la retourne donc au client en guise de r�ponse.
L'en-t�te HTTP <code>Vary</code> de la r�ponse est renseign� de fa�on �
indiquer les dimensions de la n�gociation (les navigateurs et les caches
peuvent utiliser cette information lors de la mise en cache de la
ressource). Travail termin�.</li>
<li>Le passage par cette �tape signifie qu'aucune variante n'a �t�
s�lectionn�e (parcequ'aucune n'est acceptable pour le navigateur).
Envoyer une r�ponse avec un code de statut 406 (qui signifie "Aucune
repr�sentation acceptable") et un corps comportant un document HTML qui
affiche les variantes disponibles. Renseigner aussi l'en-t�te HTTP
<code>Vary</code> de fa�on � indiquer les dimensions de la variante.</li>
</ol>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="better" id="better">Ajustement des valeurs de qualit�</a></h2>
<p>Parfois httpd modifie les valeurs de qualit� par rapport � celles qui
d�couleraient d'une stricte interpr�tation de l'algorithme de n�gociation
de httpd ci-dessus, ceci pour am�liorer les r�sultats de l'algorithme pour
les navigateurs qui envoient des informations incompl�tes ou inappropri�es.
Certains des navigateurs les plus populaires envoient des informations dans
l'en-t�te <code>Accept</code> qui, sans ce traitement, provoqueraient la
s�lection d'une variante inappropri�e dans de nombreux cas. Quand un
navigateur envoie des informations compl�tes et correctes ces ajustements
ne sont pas effectu�s.</p>
<h3><a name="wildcards" id="wildcards">Types de m�dia et caract�res g�n�riques</a></h3>
<p>L'en-t�te de requ�te <code>Accept:</code> indique les types de m�dia
souhait�s. Il peut aussi contenir des types de m�dia avec caract�res
g�n�riques, comme "image/*" ou "*/*" o� * correspond � n'importe quelle
cha�ne de caract�res. Ainsi une requ�te contenant :</p>
<div class="example"><p><code>Accept: image/*, */*</code></p></div>
<p>indiquerait que tout type de m�dia est acceptable, avec une pr�f�rence
pour les types commen�ant par "image/".
Certains navigateurs ajoutent par d�faut des types de m�dia avec caract�res
g�n�riques aux types explicitement nomm�s qu'ils peuvent g�rer.
Par exemple :</p>
<div class="example"><p><code>
Accept: text/html, text/plain, image/gif, image/jpeg, */*
</code></p></div>
<p>Ceci indique que les types explicitement list�s sont pr�f�r�s, mais
qu'une repr�sentation avec un type diff�rent de ces derniers conviendra
aussi. Les valeurs de qualit�s explicites,
afin de pr�ciser ce que veut vraiment le navigateur, s'utilisent
comme suit :</p>
<div class="example"><p><code>
Accept: text/html, text/plain, image/gif, image/jpeg, */*; q=0.01
</code></p></div>
<p>Les types explicites n'ont pas de facteur de qualit�, la valeur par
d�faut de leur pr�f�rence est donc de 1.0 (la plus haute). Le type avec
caract�res g�n�riques */* se voit attribuer une pr�f�rence basse de 0.01,
si bien que les types autres que ceux explicitement list�s ne seront retourn�s
que s'il n'existe pas de variante correspondant � un type explicitement
list�.</p>
<p>Si l'en-t�te <code>Accept:</code> ne contient <em>pas</em> aucun
facteur de qualit�, httpd positionne la valeur de qualit� de
"*/*", si present, � 0.01 pour simuler l'effet d�sir�. Il positionne aussi
la valeur de qualit� des types avec caract�res g�n�riques au format
"type/*" � 0.02 (ils sont donc pr�f�r�s � ceux correspondant � "*/*"). Si
un type de m�dia dans l'en-t�te <code>Accept:</code> contient un facteur de
qualit�, ces valeurs sp�ciales ne seront <em>pas</em> appliqu�es, de fa�on
� ce que les requ�tes de navigateurs qui envoient les informations
explicites � prendre en compte fonctionnent comme souhait�.</p>
<h3><a name="exceptions" id="exceptions">Exceptions dans la n�gociation du
langage</a></h3>
<p>A partir de la version 2.0 de httpd, certaines exceptions ont �t�
ajout�es � l'algorithme de n�gociation afin de m�nager une issue de secours
quand la n�gociation ne trouve aucun langage correspondant.</p>
<p>Quand un client demande une page sur votre serveur, si ce dernier ne
parvient pas � trouver une page dont la langue corresponde � l'en-t�te
<code>Accept-language</code> envoy� par le navigateur, il enverra au client
une r�ponse "Aucune variante acceptable" ou "Plusieurs choix possibles".
Pour �viter ces
messages d'erreur, il est possible de configurer httpd de fa�on � ce que,
dans ces cas, il ignore l'en-t�te <code>Accept-language</code> et fournisse
tout de m�me un document, m�me s'il ne correspond pas exactement � la
demande explicite du client. La directive <code class="directive"><a href="./mod/mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority</a></code>
peut �tre utilis�e pour �viter ces messages d'erreur et leur substituer une
page dont le langage sera d�termin� en fonction du contenu de la directive
<code class="directive"><a href="./mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>.</p>
<p>Le serveur va aussi essayer d'�tendre sa recherche de correspondance aux
sous-ensembles de langages quand aucune correspondance exacte ne peut �tre
trouv�e. Par exemple, si un client demande des documents poss�dant le
langage <code>en-GB</code>, c'est � dire anglais britannique, le standard
HTTP/1.1 n'autorise normalement pas le serveur � faire correspondre cette
demande � un document dont le langage est simplement <code>en</code>.
(Notez qu'inclure <code>en-GB</code> et non <code>en</code> dans l'en-t�te
<code>Accept-Language</code> constitue une quasi-erreur de configuration,
car il est tr�s peu probable qu'un lecteur qui comprend l'anglais
britannique, ne comprenne pas l'anglais en g�n�ral. Malheureusement, de
nombreux clients ont r�ellement des configurations par d�faut de ce type.)
Cependant, si aucune autre correspondance de langage n'est possible, et que le
serveur est sur le point de retourner une erreur "Aucune variable
acceptable" ou de choisir le langage d�fini par la directive <code class="directive"><a href="./mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>, le serveur ignorera
la sp�cification du sous-ensemble de langage et associera la demande en
<code>en-GB</code> � des documents en <code>en</code>. Implicitement,
httpd ajoute le langage parent � la liste de langues accept�s par le
client avec une valeur de qualit� tr�s basse. Notez cependant que si le
client demande "en-GB; q=0.9, fr; q=0.8", et le serveur dispose de
documents estampill�s "en" et "fr", alors c'est le document "fr" qui sera
retourn�, tout ceci dans un souci de compatibilit� avec la sp�cification
HTTP/1.1 et afin de fonctionner efficacement avec les clients
correctement configur�s.</p>
<p>Pour supporter les techniques avanc�es (comme les cookies ou les chemins
d'URL sp�ciaux) afin de d�terminer le langage pr�f�r� de l'utilisateur, le
module <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> reconna�t la
<a href="env.html">variable d'environnement</a>
<code>prefer-language</code>
depuis la version 2.0.47 de httpd. Si elle est d�finie et contient un
symbole de langage appropri�, <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> va essayer
de s�lectionner une variante correspondante. S'il n'existe pas de telle
variante, le processus normal de n�gociation sera lanc�.</p>
<div class="example"><h3>Exemple</h3><p><code>
SetEnvIf Cookie "language=(.+)" prefer-language=$1<br />
Header append Vary cookie
</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="extensions" id="extensions">Extensions � la n�gociation de contenu
transparente</a></h2>
<p>httpd �tend le protocole de n�gociation de contenu transparente (RFC
2295) comme suit. Un nouvel �l�ment <code>{encodage ..}</code> est utilis� dans
les listes de variantes pour marquer celles qui ne sont disponibles qu'avec un
encodage de contenu sp�cifique. L'impl�mentation de l'algorithme
RVSA/1.0 (RFC 2296) est �tendue � la reconnaissance de variantes encod�es dans
la liste, et � leur utilisation en tant que variantes candidates � partir du
moment o� leur encodage satisfait au contenu de l'en-t�te de requ�te
<code>Accept-Encoding</code>. L'impl�mentation RVSA/1.0 n'arrondit pas les
facteurs de qualit� calcul�s � 5 d�cimales avant d'avoir choisi la meilleure
variante.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="naming" id="naming">Remarques � propos des liens hypertextes et des
conventions de nommage</a></h2>
<p>Si vous utilisez la n�gociation de langage, vous avez le choix entre
diff�rentes conventions de nommage, car les fichiers peuvent poss�der
plusieurs extensions, et l'ordre dans lequel ces derni�res apparaissent
est en g�n�ral sans rapport (voir la documentation sur le module <a href="mod/mod_mime.html#multipleext">mod_mime</a>
pour plus de d�tails).</p>
<p>Un fichier type poss�de une extension li�e au type MIME
(<em>par exemple</em>, <code>html</code>), mais parfois aussi une
extension li�e � l'encodage (<em>par exemple</em>, <code>gz</code>),
et bien s�r une extension li�e au langage
(<em>par exemple</em>, <code>en</code>) quand plusieurs variantes de
langage sont disponibles pour ce fichier.</p>
<p>Exemples :</p>
<ul>
<li>foo.en.html</li>
<li>foo.html.en</li>
<li>foo.en.html.gz</li>
</ul>
<p>Ci-dessous d'autres exemples de noms de fichiers avec des liens
hypertextes valides et invalides :</p>
<table class="bordered">
<tr>
<th>Nom fichier</th>
<th>lien valide</th>
<th>Lien invalide</th>
</tr>
<tr>
<td><em>foo.html.en</em></td>
<td>foo<br />
foo.html</td>
<td>-</td>
</tr>
<tr>
<td><em>foo.en.html</em></td>
<td>foo</td>
<td>foo.html</td>
</tr>
<tr>
<td><em>foo.html.en.gz</em></td>
<td>foo<br />
foo.html</td>
<td>foo.gz<br />
foo.html.gz</td>
</tr>
<tr>
<td><em>foo.en.html.gz</em></td>
<td>foo</td>
<td>foo.html<br />
foo.html.gz<br />
foo.gz</td>
</tr>
<tr>
<td><em>foo.gz.html.en</em></td>
<td>foo<br />
foo.gz<br />
foo.gz.html</td>
<td>foo.html</td>
</tr>
<tr>
<td><em>foo.html.gz.en</em></td>
<td>foo<br />
foo.html<br />
foo.html.gz</td>
<td>foo.gz</td>
</tr>
</table>
<p>En regardant la table ci-dessus, vous remarquerez qu'il est toujours
possible d'utiliser le nom de fichier sans extension dans un lien
(<em>par exemple</em>, <code>foo</code>). L'avantage est de pouvoir
dissimuler le type r�el du fichier associ� � un document et de pouvoir
le modifier
ult�rieurement, <em>par exemple</em>, de <code>html</code> �
<code>shtml</code> ou <code>cgi</code> sans avoir �
mettre � jour aucun lien.</p>
<p>Si vous souhaitez continuer � utiliser un type MIME dans vos liens
(<em>par exemple </em> <code>foo.html</code>), l'extension li�e au langage
(y compris une extension li�e � l'encodage s'il en existe une)
doit se trouver � droite de l'extension li�e au type MIME
(<em>par exemple</em>, <code>foo.html.en</code>).</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="caching" id="caching">Remarque sur la mise en cache</a></h2>
<p>Quand un cache stocke une repr�sentation, il l'associe avec l'URL de la
requ�te. Lorsque cette URL est � nouveau demand�e, le cache peut utiliser
la repr�sentation stock�e. Cependant, si la ressource est n�gociable au
niveau du serveur, il se peut que seule la premi�re variante demand�e soit
mise en cache et de ce fait, la correspondance positive du cache peut
entra�ner une r�ponse inappropri�e. Pour
�viter ceci, httpd marque par
d�faut toutes les r�ponses qui sont retourn�es apr�s une n�gociation de
contenu comme "non-cachables" par les clients HTTP/1.0. httpd supporte
aussi les fonctionnalit�s du protocole HTTP/1.1 afin de permettre la mise
en cache des r�ponses n�goci�es.</p>
<p>Pour les requ�tes en provenance d'un client compatible HTTP/1.0
(un navigateur ou un cache), la directive <code class="directive"><a href="./mod/mod_negotiation.html#cachenegotiateddocs">CacheNegotiatedDocs</a></code> peut �tre utilis�e
pour permettre la mise en cache des r�ponses qui ont fait l'objet d'une
n�gociation. Cette directive peut intervenir dans la configuration au
niveau du serveur ou de l'h�te virtuel, et n'accepte aucun argument. Elle
n'a aucun effet sur les requ�tes en provenance de clients HTTP/1.1.</p>
<p>Pour les clients HTTP/1.1, httpd envoie un en-t�te de r�ponse HTTP
<code>Vary</code> afin d'indiquer les dimensions de la n�gociation pour
cette r�ponse. Les caches peuvent
utiliser cette information afin de d�terminer
si une requ�te peut �tre servie � partir de la copie locale. Pour inciter
un cache � utiliser la copie locale sans tenir compte des dimensions de la
n�gociation, d�finissez la
<a href="env.html#special">variable d'environnement</a>
<code>force-no-vary</code>.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/content-negotiation.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/content-negotiation.html" title="Fran�ais"> fr </a> |
<a href="./ja/content-negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/content-negotiation.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/content-negotiation.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2012 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><script type="text/javascript">
if (typeof(prettyPrint) !== undefined) {
prettyPrint();
}
</script>
</body></html>
|
