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
|
<?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>mod_negotiation - Serveur Apache HTTP</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body>
<div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur Apache HTTP Version 2.3</p>
<img alt="" src="../images/feather.gif" /></div>
<div class="up"><a href="./"><img title="<-" 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.3</a> > <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Module Apache mod_negotiation</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_negotiation.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/mod/mod_negotiation.html" title="Fran�ais"> fr </a> |
<a href="../ja/mod/mod_negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Effectue la <a href="../content-negotiation.html">n�gociation de
contenu</a></td></tr>
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>negotiation_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Fichier�Source:</a></th><td>mod_negotiation.c</td></tr></table>
<h3>Sommaire</h3>
<p>La n�gociation de contenu, ou plus pr�cis�ment la s�lection de
contenu, est la s�lection parmi plusieurs documents disponibles, du
document qui "colle" au plus pr�s des possibilit�s du client. Pour y
parvenir, deux m�thodes sont employ�es.</p>
<ul>
<li>Une table de correspondances de types (un fichier associ� au
gestionnaire <code>type-map</code>) qui contient une liste
explicite des fichiers contenant les diff�rentes variantes.</li>
<li>Une recherche multivues (Multiviews) (activ�e par l'<code class="directive"><a href="../mod/core.html#options">Options</a></code> <code>Multiviews</code>), o� le
serveur effectue une recherche de correspondance de mod�le de nom
de fichier implicite, et fait son choix parmi les r�sultats.</li>
</ul>
</div>
<div id="quickview"><h3 class="directives">Directives</h3>
<ul id="toc">
<li><img alt="" src="../images/down.gif" /> <a href="#cachenegotiateddocs">CacheNegotiatedDocs</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#forcelanguagepriority">ForceLanguagePriority</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#languagepriority">LanguagePriority</a></li>
</ul>
<h3>Sujets</h3>
<ul id="topics">
<li><img alt="" src="../images/down.gif" /> <a href="#typemaps">Tables de correspondances de types</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#multiviews">Multivues</a></li>
</ul><h3>Voir aussi</h3>
<ul class="seealso">
<li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li>
<li><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></li>
<li><a href="../content-negotiation.html">N�gociation de
contenu</a></li>
<li><a href="../env.html">Variables d'environnement</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="typemaps" id="typemaps">Tables de correspondances de types</a></h2>
<p>Une table de correspondances de types poss�de un format similaire
� celui des en-t�tes de messagerie RFC822. Elle contient des
descriptions de documents s�par�es par des lignes vides, toute ligne
commen�ant par un di�se ('#') �tant consid�r�e comme un
commentaire. Une description de document comporte plusieurs
enregistrements d'en-t�tes ; chaque enregistrement peut �tre r�parti
sur plusieurs lignes � condition que les lignes suppl�mentaires
commencent par un ou plusieurs espaces. Lors du traitement, les
espaces de d�but de ligne seront supprim�s et les lignes
concat�n�es. L'enregistrement d'un en-t�te comprend un mot-cl� qui
se termine toujours par un caract�re "deux-points" ':', suivi d'une
valeur. Les espaces sont autoris�s entre le nom d'en-t�te et sa
valeur, ainsi qu'entre les diff�rents �l�ments de la valeur. Les
en-t�tes autoris�s sont :</p>
<dl>
<dt><code>Content-Encoding:</code></dt>
<dd>Le codage du fichier. Apache ne reconna�t que les codages
d�finis par une directive <code class="directive"><a href="../mod/mod_mime.html#addencoding">AddEncoding</a></code>. Sont normalement inclus
les codages <code>x-compress</code> pour les fichiers compress�s
avec compress, et <code>x-gzip</code> pour les fichiers compress�s
avec gzip. Le pr�fixe <code>x-</code> est ignor� lors des
comparaisons de codages.</dd>
<dt><code>Content-Language:</code></dt>
<dd>Le(s) langage(s) de la variante, sous la forme d'un symbole de
langage Internet standard (<a href="http://www.ietf.org/rfc/rfc1766.txt">RFC 1766</a>). Par
exemple, <code>en</code> correspond � l'anglais. Si la variante
contient plusieurs langages, ils sont s�par�s par des
virgules.</dd>
<dt><code>Content-Length:</code></dt>
<dd>La taille du fichier en octets. Si cet en-t�te n'est pas
pr�sent, c'est la taille r�elle du fichier qui est utilis�e.</dd>
<dt><code>Content-Type:</code></dt>
<dd>
Le <a class="glossarylink" href="../glossary.html#mime-type" title="voir glossaire">type MIME</a> du document
avec des param�tres optionnels. Les param�tres sont s�par�s du
type de m�dium ainsi qu'entre eux par un point-virgule, et
poss�dent la syntaxe <code>nom=valeur</code>. Les param�tres
courants sont :
<dl>
<dt><code>level</code></dt>
<dd>un entier sp�cifiant la version du type de m�dia. Pour
<code>text/html</code>, la valeur par d�faut est 2, sinon
0.</dd>
<dt><code>qs</code></dt>
<dd>un nombre en virgule flottante de 0.0 � 1.0, indiquant la
"qualit�" relative de la variante courante par rapport aux
autres variantes disponibles, ind�pendamment des possibilit�s
du client. Par exemple, un fichier jpeg est en g�n�ral une
source de qualit� sup�rieure � un fichier ascii s'il est cens�
repr�senter une image. Cependant, si la ressource repr�sent�e
est une image ascii, un fichier ascii poss�dera une qualit�
sup�rieure � un fichier jpeg. Toutes les valeurs de
<code>qs</code> sont donc sp�cifiques � une certaine
ressource.</dd>
</dl>
<div class="example"><h3>Exemple</h3><p><code>
Content-Type: image/jpeg; qs=0.8
</code></p></div>
</dd>
<dt><code>URI:</code></dt>
<dd>l'URI du fichier contenant la variante (du type de m�dium
donn�, cod� selon le codage de contenu donn�). Cet URI est
consid�r� comme relatif au fichier de correspondances ; il doit
�tre situ� sur le m�me serveur (!), et doit faire r�f�rence au
fichier auquel le client se verrait accorder l'acc�s s'il �tait
requis directement.</dd>
<dt><code>Body:</code></dt>
<dd>une nouveaut� d'Apache 2.0 : le contenu r�el de la ressource
peut �tre inclus dans la table de correspondances en utilisant
l'en-t�te Body. Cet en-t�te doit contenir une cha�ne d�signant un
d�limiteur pour le contenu du corps. Les lignes suivantes du
fichier de correspondances de types seront alors consid�r�es comme
parties du corps de la ressource jusqu'� ce que le d�limiteur soit
d�tect�.
<div class="example"><h3>Exemple:</h3><p><code>
Body:----xyz----<br />
<html><br />
<body><br />
<p>Contenu de la page.</p><br />
</body><br />
</html><br />
----xyz----
</code></p></div>
</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="multiviews" id="multiviews">Multivues</a></h2>
<p>Une recherche Multivues est activ�e par l'<code class="directive"><a href="../mod/core.html#options">Options</a></code> <code>Multiviews</code>. Si le
serveur re�oit une requ�te pour <code>/un/r�pertoire/foo</code>, et
si <code>/un/r�pertoire/foo</code> n'existe pas, le serveur parcourt
le r�pertoire � la recherche de tous les fichiers de nom
<code>foo.*</code>, et simule v�ritablement une correspondance de
type qui nomme tous ces fichiers en leur assignant les m�mes type
de m�dia et codage de contenu qu'ils auraient eus si le client avait
requis l'un d'entre eux avec son nom complet. Il choisit ensuite le
fichier qui correspond le mieux au profile du client, puis renvoie
le document.</p>
<p>La directive <code class="directive"><a href="../mod/mod_mime.html#multiviewsmatch">MultiviewsMatch</a></code> d�finit si Apache doit
prendre en compte les fichiers qui ne comportent pas de m�tadonn�es
de n�gociation de contenu lors du choix du fichier � servir.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="CacheNegotiatedDocs" id="CacheNegotiatedDocs">CacheNegotiatedDocs</a> <a name="cachenegotiateddocs" id="cachenegotiateddocs">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet la mise en cache au niveau des serveurs mandataires
des documents dont le contenu a �t� n�goci�</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheNegotiatedDocs On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>CacheNegotiatedDocs Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_negotiation</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>La syntaxe a �t� modifi�e dans la version
2.0.</td></tr>
</table>
<p>Si elle est d�finie � "on", cette directive permet la mise en
cache au niveau des serveurs mandataires des documents dont le
contenu a �t� n�goci�. Le processus de mise en cache sera alors plus
efficace, mais des clients se trouvant derri�re le mandataire
seront alors susceptibles de se voir servir des versions de
documents qui ne correspondent pas forc�ment � leurs attentes.</p>
<p>Cette directive ne s'applique qu'aux requ�tes en provenance de
navigateurs HTTP/1.0. HTTP/1.1 fournit un bien meilleur contr�le de
la mise en cache des documents au contenu n�goci�, et cette
directive n'a aucun effet sur les r�ponses aux requ�tes
HTTP/1.1.</p>
<p>Avant la version 2.0, la directive
<code class="directive">CacheNegotiatedDocs</code> n'acceptait aucun
argument ; la seule pr�sence de la directive suffisait � la d�finir
� "on".</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ForceLanguagePriority" id="ForceLanguagePriority">ForceLanguagePriority</a> <a name="forcelanguagepriority" id="forcelanguagepriority">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Action � entreprendre si un document acceptable unique
n'est pas trouv�</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ForceLanguagePriority Prefer</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_negotiation</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.0.30</td></tr>
</table>
<p>La directive <code class="directive">ForceLanguagePriority</code> utilise
le langage d�fini par la directive <code class="directive"><a href="#languagepriority">LanguagePriority</a></code> pour terminer
la n�gociation lorsque le serveur n'est pas en mesure de trouver une
solution satisfaisante unique.</p>
<p><code>ForceLanguagePriority Prefer</code> utilise la directive
<code>LanguagePriority</code> pour servir le r�sultat d'un choix
unique, au lieu de renvoyer un r�sultat HTTP 300 (MULTIPLE CHOICES),
lorsque que plusieurs choix �quivalents sont disponibles. Par
exemple, avec les deux directives ci-dessous, si l'en-t�te
<code>Accept-Language</code> de l'utilisateur assigne �
<code>en</code> et <code>de</code> une qualit� de <code>.500</code>
(les deux langages sont �galement acceptables), alors c'est la
premi�re variante acceptable de langue <code>en</code> qui sera
servie.</p>
<div class="example"><p><code>
LanguagePriority en fr de<br />
ForceLanguagePriority Prefer
</code></p></div>
<p><code>ForceLanguagePriority Fallback</code> utilise la directive
<code class="directive"><a href="#languagepriority">LanguagePriority</a></code>
pour servir un r�sultat valide, au lieu de renvoyer un r�sultat HTTP
406 (NOT ACCEPTABLE). Avec les deux directives ci-dessous, si
l'en-t�te <code>Accept-Language</code> de l'utilisateur ne mentionne
que les r�ponses de langage <code>es</code>, et si aucune variante
dans cette langue n'est trouv�e, c'est la premi�re variante de la
liste d�finie par la directive <code class="directive"><a href="#languagepriority">LanguagePriority</a></code> qui sera servie.</p>
<div class="example"><p><code>
LanguagePriority en fr de<br />
ForceLanguagePriority Fallback
</code></p></div>
<p>Les deux options, <code>Prefer</code> et <code>Fallback</code>,
peuvent �tre sp�cifi�es, de fa�on � ce que la variante servie soit
la premi�re variante qui convient d�finie par la directive
<code class="directive"><a href="#languagepriority">LanguagePriority</a></code> si
plusieurs variantes sont �galement acceptables, ou le premier
document disponible si aucune variante ne convient � la liste de
langages acceptables fournie par le client.</p>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="../mod/mod_mime.html#addlanguage">AddLanguage</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="LanguagePriority" id="LanguagePriority">LanguagePriority</a> <a name="languagepriority" id="languagepriority">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'ordre de priorit� des variantes de langages pour les
cas o� le client n'a pas formul� de pr�f�rences</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LanguagePriority <var>langage-MIME</var> [<var>langage-MIME</var>]
...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_negotiation</td></tr>
</table>
<p>La directive <code class="directive">LanguagePriority</code> permet de
d�finir, au cours du traitement d'une requ�te Multivues, l'ordre de
priorit� des variantes de langages pour les cas
o� le client n'a pas formul� de pr�f�rences. La liste �num�re les
<var>langages-MIME</var> dans un ordre de pr�f�rences
d�croissantes.</p>
<div class="example"><h3>Exemple:</h3><p><code>
LanguagePriority en fr de
</code></p></div>
<p>Dans le cas d'une requ�te pour <code>foo.html</code>, si
<code>foo.html.fr</code> et <code>foo.html.de</code> existent, et si
le client n'a pas formul� de pr�f�rences, c'est le fichier
<code>foo.html.fr</code> qui sera renvoy�.</p>
<p>Notez que cette directive n'a d'effet que si le 'meilleur'
langage n'a pas pu �tre d�termin� d'une autre mani�re ou si la
valeur de la directive <code class="directive"><a href="#forcelanguagepriority">ForceLanguagePriority</a></code> est
diff�rente de <code>None</code>. En g�n�ral, c'est le client qui
d�termine le langage pr�f�r�, non le serveur.</p>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="../mod/mod_mime.html#addlanguage">AddLanguage</a></code></li>
</ul>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_negotiation.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/mod/mod_negotiation.html" title="Fran�ais"> fr </a> |
<a href="../ja/mod/mod_negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div><div id="footer">
<p class="apache">Copyright 2009 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>
|
