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
|
<?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 Contenus - 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" /><link href="http://httpd.apache.org/docs/current/content-negotiation.html" rel="canonical" /></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.0</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.0</a></div><div id="page-content"><div class="retired"><h4>Please note</h4>
<p>This document refers to the <strong>2.0</strong> version of Apache httpd, which <strong>is no longer maintained</strong>. Upgrade, and refer to the current version of httpd instead, documented at:</p>
<ul><li><a href="http://httpd.apache.org/docs/current/">Current release version of Apache HTTP Server documentation</a></li></ul><p>You may follow <a href="http://httpd.apache.org/docs/current/content-negotiation.html">this link</a> to go to the current version of this document.</p></div><div id="preamble"><h1>Négociation de Contenus</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>
<div class="outofdate">Cette traduction peut être périmée. Consultez la version
Anglaise pour les changements récents.</div>
<p>Apache suit les spécifications HTTP/1.1 en ce qui concerne
les négociations de contenus. Il est ainsi possible d'utiliser
les informations fournies par le navigateur (préférences de langues,
jeu de caractères, encodage et types de médias). Apache essaye
aussi d'optimiser les cas des navigateurs envoyant des
informations incomplètes.</p>
<p>C'est le module <code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code> qui fournit
la négociation de contenus ; ce module est inclus dans Apache
par défaut.</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#about">À propos de la Négociation de Contenus</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#negotiation">Négociations avec Apache</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#methods">Méthodes de Négociations</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#better">Tricher sur les Facteurs de Qualité</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#extensions">Extensions vers la Négociation de Contenu
Transparente</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#naming">À propos des liens hypertextes et des conventions de nommage</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#caching">À propos des Caches</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#more">Plus d'Information</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 Contenus</a></h2>
<p>Différentes représentations peuvent être utilisées pour
communiquer une ressource. Par exemple, plusieurs langues peuvent
être disponibles, ou plusieurs types de médias, voire parfois une
combinaison de ces possibilités.
Une méthode pour gérer cela est de donner le choix au visiteur,
en lui proposant un index général, qui lui permet par exemple de
choisir sa langue. Cependant, il est souvent possible de faire ce
choix de manière automatique car les navigateurs peuvent préciser
avec leurs requêtes, la représentation qu'ils préfèrent recevoir. Par
exemple, un navigateur pourrait spécifier qu'il préfère recevoir les
informations en français si elles sont disponibles, ou en anglais
dans le cas contraire. Ce type d'information est communiqué par les
navigateurs, dans les en-têtes de chaque requête. Un navigateur ne
demandant que des documents en français enverrait</p>
<div class="example"><p><code>Accept-Language: fr</code></p></div>
<p>Notez que cette préférence ne sera gérée par le serveur que
s'il existe un choix de langues du côté du serveur.</p>
<p>Voici un exemple plus complet, où le navigateur est configuré pour
accepter le français et l'anglais, mais avec une préférence pour le
français, et pour accepter divers types de médias, en préférant le
HTML au texte brut, et en préférant le GIF ou le JPEG aux autres types
de médias (sans pour autant refuser ces derniers, le cas échéant) :</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>Apache supporte les négociations de contenus 'gérés par
le serveur', telles que spécifiées dans HTTP/1.1. Les en-têtes
<code>Accept</code>, <code>Accept-Language</code>,
<code>Accept-Charset</code> et <code>Accept-Encoding</code>
sont gérés. Apache supporte également les négociations de
contenus 'transparentes', telles que définies dans les RFC
2295 et 2296. En revanche les fonctions de 'feature
negotiation' définies dans ces RFCs ne sont pas supportées.</p>
<p>On appelle <strong>ressource</strong> une entité conceptuelle
identifiée par un URI (RFC 2396). Le travail d'un serveur HTTP,
tel Apache, est de donner un accès à des
<strong>représentations</strong> des ressources à sa disposition,
chaque représentation étant envoyée sous la forme d'une séquence
d'octets définie selon un type de média, un jeu de caractères,
un encodage, etc. À tout moment, chaque ressource est associée
à zéro, une ou plusieurs représentations. Si plusieurs représentations
sont disponibles pour une ressource, on dit que cette dernière est
<strong>négociable</strong> et chacune de ses représentations
possibles est appelée une <strong>variante</strong>.
Les différentes possibilités de choisir les variantes d'une ressource
négociable sont appelées <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">Négociations avec Apache</a></h2>
<p>Pour qu'Apache puisse procéder à la négociation d'une ressource,
il faut qu'il dispose d'informations à propos de chacune des variantes.
Deux méthodes sont possibles :</p>
<ul>
<li>Réaliser une "Table de Types" (<em>c'est-à-dire</em>,
un fichier <code>*.var</code>) qui précise explicitement les fichiers
définissant les variantes, ou</li>
<li>Utiliser une recherche 'MultiViews', méthode par laquelle
le serveur réalise une recherche par motifs implicites,
et choisit parmi les résultats.</li>
</ul>
<h3><a name="type-map" id="type-map">Utilisation d'une Table de Types (Type Map)</a></h3>
<p>Une table de types est un document qui est associé avec le
gestionnaire <code>type-map</code> (ou, dans les plus anciennes
versions d'Apache, le type mime <code>application/x-type-map</code>).
Notez que pour implémenter cette méthode, un 'handler' doit être
défini dans la configuration pour associer une extension de fichier à
<code>type-map</code> ; ce qui est généralement obtenu au moyen de</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 table de types portent généralement le nom de la
ressource qu'ils décrivent, et contiennent une entrée correspondant
à chaque variante possible ; ces entrées sont constituées de lignes
au format d'en-têtes HTTP. Les entrées de deux variantes distinctes
sont à séparer par des lignes vides. Il n'est pas permis d'utiliser
des lignes vides au sein d'une entrée. Il est courant de placer en
début de fichier une entrée pour l'entité combinée
dans son ensemble (bien que cela ne soit pas nécessaire, et ignoré
par Apache). Un exemple de fichier de table est donné en exemple
ci-après. Le nom de ce fichier serait <code>foo.var</code>, puisque
le fichier décrit une ressource appelée <code>foo</code>.</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 que les fichiers de table de types sont toujours
utilisés en priorité par Apache par rapport à l'extension du
nom du fichier, et ce même si l'option Multiviews est activée.
Des variantes présentant des qualités inégales peuvent être indiquées
au moyen du paramètre de type de média : "qs", comme dans le cas de
cette image (disponible en 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 acceptables sont comprises entre 0.000
et 1.000. Notez qu'une variante avec un qs de 0.000 ne sera
jamais choisie. La valeur de qs par défaut est de 1.0. Le
paramètre qs sert à indiquer la qualité de la variante, par
rapport aux autres variantes disponibles, et ce indépendamment
des possibilités du navigateur. Par exemple, un fichier JPEG
est généralement de meilleure qualité qu'un fichier ASCII, si
les 2 documents sont destinés à représenter une photographie.
Bien sûr, si la ressource originale est elle-même un fichier
ASCII, la représentation ASCII sera considéré comme de meilleure
qualité que la représentation JPEG. La valeur de qs dépend donc
de la nature de la ressource que l'on souhaite représenter.</p>
<p>La liste complète des en-têtes utilisables est disponible
dans la documentation de
<a href="mod/mod_negotiation.html#typemaps">mod_negotation</a>.</p>
<h3><a name="multiviews" id="multiviews">Multiviews</a></h3>
<p>L'option <code>MultiViews</code> est à spécifier par répertoire,
ce qui signifie qu'elle peut être utilisée au moyen d'une directive
<code class="directive"><a href="./mod/core.html#options">Options</a></code> dans 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>
du fichier <code>httpd.conf</code>, ou dans les fichiers
<code>.htaccess</code> (à condition que l'option <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> soit paramétrée pour cela).
Notez que <code>Options All</code> n'active pas l'option
<code>MultiViews</code> ; cette dernière doit être positionnée
explicitement.</p>
<p>Voici comment fonctionne <code>MultiViews</code> : supposons qu'un
serveur reçoive une requête pour <code>/some/dir/foo</code>, que l'option
<code>MultiViews</code> soit activée pour <code>/some/dir</code>,
et que le fichier <code>/some/dir/foo</code> <em>n'</em>existe
<em>pas</em> ; alors le serveur cherche les fichiers nommés foo.*
dans le répertoire /some/dir, et construit une table de types à
partir de ces noms de fichiers. Dans la table, chaque fichier se
voit assigner les types de médias et les encodages de contenu
tels qu'ils seraient envoyés si le client les demandait par leur
nom propre. Apache choisit alors la meilleure représentation à
envoyer au client, en fonction de ses préférences.</p>
<p>L'option <code>MultiViews</code> sert aussi lors du choix d'un
index, lorsque la directive <code class="directive"><a href="./mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> est précisée.
Par exemple, si la configuration contient</p>
<div class="example"><p><code>DirectoryIndex index</code></p></div>
<p>le serveur devra choisir entre les fichiers <code>index.html</code> et
<code>index.html3</code>, dans le cas où ces deux fichiers existent. Si
aucun de ces fichiers n'existe, mais qu'un fichier <code>index.cgi</code>
est présent, ce dernier sera exécuté par le serveur.</p>
<p>Si à la lecture du répertoire, un fichier est trouvé
dont l'extension n'est pas reconnue par <code>mod_mime</code>
comme précisant son jeu de caractères, sa langue, son type de
contenu (Content-Type) ou son encodage, alors tout dépendra de la
directive <code class="directive"><a href="./mod/mod_mime.html#multiviewsmatch">MultiViewsMatch</a></code>.
Cette directive précise en effet quels gestionnaires, filtres, et
autres types d'extensions peuvent contribuer à la négociation
MultiViews.</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">Méthodes de Négociations</a></h2>
<p>Après qu'Apache ait défini la liste de variantes possibles
pour une ressource, que ce soit via un fichier de tables de
types ou à partir des noms de fichiers contenus dans le répertoire,
deux méthodes peuvent être invoquées pour choisir la 'meilleure'
variante qui sera envoyée, pour autant qu'il en existe au moins
une. Il n'est pas nécessaire de connaître ce fonctionnement pour
utiliser les négociations de contenu avec Apache ; cependant pour
le lecteur intéressé la suite de ce document s'attache à décrire
ce fonctionnement.</p>
<p>Il existe deux méthodes de négociations :</p>
<ol>
<li><strong>La négociation menée par le serveur, selon
l'algorithme d'Apache</strong>, est utilisée dans la plupart
des cas. L'algorithme d'Apache est détaillé dans la suite de
ce document. Dans les cas où cet algorithme est utilisé, il
arrive qu'Apache 'triche' sur le facteur qualité (qs) d'une
dimension donnée pour parvenir à un meilleur résultat. Les cas
où cela se produit sont présentés dans la suite de ce document.</li>
<li><strong>La négociation transparente de contenu</strong>
est utilisée sur demande spécifique du navigateur, selon la
méthode définie dans la RFC 2295. Cette méthode de négociation
donne au navigateur les pleins pouvoirs pour choisir la
'meilleure' variante, les résultats dépendent donc des algorithmes
de choix propres à chaque navigateur. Cette méthode permet
également au navigateur de demander à Apache d'utiliser
l'algorithme de 'sélection de variante à distance', tel que défini
par la RFC 2296.</li>
</ol>
<h3><a name="dimensions" id="dimensions">Dimensions d'une 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 présente ses préférences au moyen du
champ <code>Accept</code> de l'en-tête. À chaque élément peut être
associé un facteur de qualité. De la même manière, la description
de la variante peut présenter un facteur de qualité (le
paramètre "qs").</td>
</tr>
<tr valign="top">
<td>Langues</td>
<td>Le navigateur présente ses préférences au moyen du champ
<code>Accept-Language</code> de l'en-tête. À chaque élément
peut être associé un facteur de qualité. Les différentes
variantes peuvent également être associées ou non à une
ou plusieurs langues.</td>
</tr>
<tr valign="top">
<td>Encodage</td>
<td>Le navigateur présente ses préférences au moyen du champ
<code>Accept-Encoding</code> de l'en-tête. À chaque élément
peut être associé un facteur de qualité.</td>
</tr>
<tr valign="top">
<td>Jeu de caractères</td>
<td>Le navigateur présente ses préférences au moyen du champ
<code>Accept-Charset</code> de l'en-tête. À chaque élément
peut être associé un facteur de qualité. Les différentes
variantes peuvent se voir associer un jeu de caractères
comme type de média.</td>
</tr>
</table>
<h3><a name="algorithm" id="algorithm">Algorithme de Négociation d'Apache</a></h3>
<p>Apache peut utiliser l'algorithme présenté ci-après pour choisir la
'meilleure' variante, si elle existe, à renvoyer au navigateur. Cet
algorithme n'est pas configurable. Il fonctionne de cette manière :</p>
<ol>
<li>En premier lieu, pour chaque dimension de la négociation,
vérifier le champ d'en-tête <em>Accept*</em> approprié et
attribuer un facteur de qualité à chacune des variantes. Si
l'en-tête <em>Accept*</em> d'une dimension indique que cette
variante n'est pas acceptable, éliminer cette variante. S'il
ne reste aucune variante, aller à l'étape 4.</li>
<li>
Choisir la 'meilleure' des variantes par élimination.
Chacun des tests suivants est appliqué dans cet ordre.
Toutes les variantes ne passant pas un test sont
systématiquement éliminées. Après chacun des tests, s'il
ne reste qu'une variante, la choisir comme la meilleure
et aller à l'étape 3. S'il reste plus d'une variante, aller
à l'étape suivante.
<ol>
<li>Multiplier le facteur de qualité de l'en-tête
<code>Accept</code> par le facteur qualité de la source du
type de média de cette variante, et choisir les variantes
avec le plus grand résultat.</li>
<li>Choisir les variantes qui présentent le plus grand
facteur de qualité de langue.</li>
<li>Choisir les variantes dont la langue correspond le
mieux, soit à l'ordre de préférence des langues dans
l'en-tête <code>Accept-Language</code> (s'il existe),
soit à l'ordre des langues de la directive
<code>LanguagePriority</code> (si elle existe).</li>
<li>Choisir les variantes présentant le paramètre de niveau
('level') de média le plus grand (c'est ce qui est utilisé
pour connaître la version des types de médias text/html).</li>
<li>Choisir les variantes dont le jeu de caractères est le
meilleur, par rapport à l'en-tête <code>Accept-Charset</code>.
Le jeu de caractères ISO-8859-1 est toujours acceptable, à
moins qu'il n'ait été explicitement refusé. Les variantes
avec un type de média <code>test/*</code> et qui ne sont
pas explicitement associées à un jeu de caractère donné
sont supposées encodées en ISO-8859-1.</li>
<li>Choisir les variantes qui ont un jeu de caractères
défini et qui <em>n'</em>est <em>pas</em> ISO-8859-1.
S'il n'existe pas de telles variantes, alors les
choisir toutes.</li>
<li>Choisir les variantes présentant le meilleur encodage.
S'il existe des variantes avec un encodage acceptable par
le 'user-agent' du navigateur, choisir ces variantes seules.
Dans le cas contraire, s'il existe à la fois des variantes
encodées et non encodées, ne choisir que les variantes
non encodées. Dans les autres cas, choisir toutes les
variantes.</li>
<li>Choisir les variantes présentant la plus petite taille.</li>
<li>Choisir la première variante de celles qui restent. Ce
sera donc soit la première variante listée dans le fichier
des tables de types, soit, si les variantes sont lues d'un
répertoire, celle dont le nom apparaît en premier dans un
classement par code ASCII.</li>
</ol>
</li>
<li>Cet algorithme a permis de choisir la 'meilleure' des
variantes, qui est renvoyée en réponse à la requête du
navigateur. L'en-tête <code>Vary</code> de la réponse HTTP
est utilisé pour indiquer les dimensions de la négociation
(les navigateurs et les serveurs mandataires sont capables de
prendre en compte cette information quand il gardent une
ressource en cache). Fin des opérations.</li>
<li>Arriver à ce point signifie qu'aucune variante n'a pu être
choisie, car aucune n'est acceptable aux yeux du navigateur.
Renvoyer une erreur 406 ("No acceptable representation" - NdT :
"Aucune représentation acceptable") dans un document HTML
présentant les diverses variantes possibles. L'en-tête HTTP
<code>Vary</code> est également renseigné pour présenter les
dimensions de la négociation.</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">Tricher sur les Facteurs de Qualité</a></h2>
<p>Il arrive qu'Apache modifie les facteurs de qualité par rapport
à la valeur qu'ils devraient avoir en suivant strictement
l'algorithme décrit plus haut. Ceci permet d'obtenir de meilleurs
résultats pour gérer les navigateurs qui n'envoient pas toutes
les informations ou envoient des informations erronées. Ainsi,
certains navigateurs, parmi les plus répandus du marché, envoient
des en-têtes <code>Accept</code> qui entraîneraient l'envoi de la
mauvaise variante dans de nombreux cas. Si le navigateur envoie
des informations correctes, Apache ne trichera pas sur les facteurs
de qualité.</p>
<h3><a name="wildcards" id="wildcards">Types de Médias et Jokers</a></h3>
<p>L'en-tête de requête <code>Accept:</code> indique les préférences
des types de médias. Elle peut comporter des 'jokers' tels que
"image/*" ou "*/*", où * signifie "n'importe quoi". Ainsi, une
requête présentant :</p>
<div class="example"><p><code>Accept: image/*, */*</code></p></div>
<p>signifierait que tout type commençant par "image/" est
acceptable, comme serait acceptable tout autre type. Certains
navigateurs envoient sans arrêt des jokers en plus des types
qu'ils peuvent effectivement gérer. Par exemple :</p>
<div class="example"><p><code>
Accept: text/html, text/plain, image/gif, image/jpeg, */*
</code></p></div>
<p>Le but de ces informations est d'indiquer que les types
explicitement cités sont les préférés mais que le
navigateur accepte également d'autres représentations.
En utilisant les facteurs de qualité, voici ce que devrait
envoyer le navigateur :</p>
<div class="example"><p><code>
Accept: text/html, text/plain, image/gif, image/jpeg, */*; q=0.01
</code></p></div>
<p>Les types explicitement cités ne présentent pas de facteur
de qualité, ils reçoivent donc la valeur par défaut de 1.0
(la plus haute valeur possible). Les jokers sont affectés
d'une préférence très basse de 0.01, si bien que les autres
types ne seront utilisés que si aucune des variantes ne
correspond à un des types explicitement préférés.</p>
<p>Si le champ d'en-tête <code>Accept:</code> <em>ne</em>
contient <em>aucun</em> facteur de qualité, Apache modifie
le facteur de qualité de "*/*" (s'il est présent) en 0.01
afin d'émuler le comportement souhaité. Apache positionne
également le facteur de qualité des jokers qui se présentent
sous la forme "type/*" en 0.02 (afin que ces derniers soient
préférés à "*/*"). Si un seul ou plusieurs types de média de
l'en-tête <code>Accept:</code> présente un facteur de qualité,
ces modifications <em>ne</em> sont <em>pas</em> effectuées,
afin que les requêtes des navigateurs qui envoient des
informations correctes fonctionnent comme prévu.</p>
<h3><a name="exceptions" id="exceptions">Exceptions aux Négociations sur la Langue</a></h3>
<p>À partir d'Apache 2.0, certaines exceptions ont été ajoutées
à l'algorithme de négociation afin de retomber élégamment sur
nos pattes dans les cas où la négociation sur la langue
n'aboutit pas.</p>
<p>Si un client demande une page du serveur, sans que ce dernier
ne puisse déterminer une page correspondant au champ
<code>Accept-language</code> envoyé par le navigateur, le serveur
doit renvoyer une réponse parmi "Pas de Variante Acceptable"
et "Choix Multiples" au client. Afin d'éviter ces messages
d'erreur, il est possible de configurer Apache pour qu'il ignore
le champ <code>Accept-language</code> dans ces cas et qu'il
fournisse au client un document qui ne correspond pas
explicitement à sa requête. La directive
<code class="directive"><a href="./mod/mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority</a></code>
peut être utilisée pour passer outre à ces deux messages d'erreur
et modifier la réponse du serveur au moyen de la directive
<code class="directive"><a href="./mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>.</p>
<p>Le serveur va également essayer de modifier la sous-classe
de langue si aucune correspondance n'est trouvée. Par exemple,
dans le cas où un client demande des documents avec le langage
<code>en-GB</code> pour "British English", le protocole HTTP/1.1
n'autorise pas le serveur à répondre par un document qui serait
marqué par <code>en</code>. (Notez que présenter
<code>en-GB</code> dans l'en-tête <code>Accept-language</code>
est loin d'être pertinent, il semble très peu probable que le
lecteur comprenne l'anglais "British" et ne comprenne pas
l'anglais "tout court". Il se trouve malheureusement que
beaucoup de navigateurs présentent ce comportement.) Bref,
si aucune autre langue ne correspond et que le serveur
s'apprêterait normalement à envoyer une réponse d'erreur
"No Acceptable Variants", ou à utiliser la méthode
<code class="directive"><a href="./mod/mod_negociation.html#languagepriority">LanguagePriority</a></code>
présentée ci-avant, le serveur va ignorer la sous-classe de
langue <code>GB</code> et considérer que la requête
<code>en-GB</code> correspond bien au document <code>en</code>.
Implicitement, Apache ajoute la langue parente (<code>en</code>)
à la liste des langues considérées comme acceptables par le
navigateur, avec un facteur de qualité très faible. Notez
cependant que si le client demande "en-GB; qs=0.9, fr; qs=0.8",
et que le serveur dispose de documents marqués comme "en" et
"fr", alors le document en français sera renvoyé par le serveur.
Ce comportement est nécessaire, afin de garder la compatibilité
avec HTTP/1.1 et fonctionner avec les navigateurs correctement
configurés.</p>
<p>Pour supporter les techniques avancées de détection de
préférence de langues de l'utilisateur (telles que les
Cookies, ou les chemins d'URL spéciaux), Apache reconnaît
depuis la version 2.0.47 la <a href="env.html">variable
d'environnement</a> <code>prefer-language</code>. Si cette
variable existe, et qu'elle précise une langue valide,
<code class="module"><a href="./mod/mod_negociation.html">mod_negociation</a></code> cherchera une variante qui
y corresponde. S'il n'en trouve pas, le processus de
négociation normal se déroulera.</p>
<div class="example"><h3>Exemple</h3><p><code>
SetEnvIf Cookie "language=en" prefer-language=en<br />
SetEnvIf Cookie "language=fr" prefer-language=fr
</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 vers la Négociation de Contenu
Transparente</a></h2>
<p>Apache complète le protocole de négociation de contenu (RFC 2295)
comme décrit ici. Un nouvel élément <code>{encoding ..}</code> est
utilisé dans la liste des variantes pour nommer celles qui ne sont
disponibles que sous un encodage spécifique. L'implémentation de
l'algorithme RVSA/1.0 (RFC 2296) est étendue afin d'intégrer les
variantes encodées dans la liste, et de les proposer comme
candidates quand leur encodage est acceptable au vu de l'en-tête
<code>Accept-Encoding</code>. L'implémentation RVSA/1.0 ne tronque
pas les facteurs de qualité à 5 décimales avant de choisir la
meilleure des variantes.</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">À propos des liens hypertextes et des conventions de nommage</a></h2>
<p>Dans le cas où la négociation de langues est utilisée, il est
possible de choisir diverses conventions de nommage, car les
fichiers peuvent présenter plus d'une extension, et l'ordre des
extensions n'est normalement pas significatif (voir la
documentation <a href="mod/mod_mime.html#multipleext">mod_mime</a>
pour plus de détails).</p>
<p>Habituellement, un fichier a une extension pour son type MIME
(par exemple, <code>html</code>), parfois une extension pour son
encodage (par exemple, <code>gz</code>), et bien sûr une extension
de langue (par exemple, <code>en</code>) pour distinguer les
diverses variantes.</p>
<p>Exemples :</p>
<ul>
<li>foo.en.html</li>
<li>foo.html.en</li>
<li>foo.en.html.gz</li>
</ul>
<p>Voici d'autres exemples de noms de fichiers ainsi que des liens
hypertextes valides et invalides :</p>
<table class="bordered">
<tr>
<th>Nom de 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>Le tableau ci-dessus montre qu'il est toujours possible de
spécifier le lien sans aucune extension dans un lien hypertexte.
(par exemple, <code>foo</code>). L'avantage en est qu'il est
ainsi possible de ne pas montrer le type d'un document, et de
le modifier ultérieurement, par exemple le passer de <code>html</code>
à <code>shtml</code> ou <code>cgi</code> sans avoir besoin de
modifier aucun lien.</p>
<p>Pour continuer à utiliser les types MIME dans les liens
(par exemple, <code>foo.html</code>), l'extension correspondant
à la langue (ainsi que l'extension d'encodage, si elle existe)
doit être du coté droit de l'extension du type MIME (par exemple,
<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">À propos des Caches</a></h2>
<p>Quand un cache garde en mémoire une représentation, il l'associe
à l'URL de la requête. Quand la même URL vient à être redemandée,
le cache peut utiliser la représentation gardée en mémoire, plutôt
que de refaire une requête au serveur. Cependant, si la ressource
est négociable coté serveur, le résultat pourrait en être que la
réponse à la première requête mise en cache serait renvoyée de
façon erronée. Pour prévenir ce problème, Apache marque toutes
les réponses issues d'une négociation comme "non-cachables" par
les clients HTTP/1.0. Apache supporte les spécifications du
protocole HTTP/1.1 en ce qui concerne la mise en cache des
réponses négociées.</p>
<p>Les requêtes venant d'un client conforme au protocole HTTP/1.0
(qu'il s'agisse d'un navigateur ou d'un serveur cache) peuvent
être rendues "cachables" si la directive <code class="directive"><a href="./mod/mod_negociation.html#cachenegotiateddocs">CacheNegotiatedDocs</a></code> est
utilisée. Cette directive peut être spécifiée aussi bien dans
la configuration principale du serveur que dans un serveur
virtuel, et ne nécessite pas d'argument. Elle n'a aucun impact
sur les requêtes des clients fonctionnant en HTTP/1.1.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="more" id="more">Plus d'Information</a></h2>
<p>Pour plus d'informations au sujet de la négociation de contenu, voir
<a href="http://ppewww.ph.gla.ac.uk/~flavell/www/lang-neg.html">Language
Negotiation Notes</a> de Alan J. Flavell. Notez que ce
document ne sera peut-être pas mis à jour en fonction des
changements intervenus dans Apache 2.0.</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 2013 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>
|
