<?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">
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>N�gociation de contenu - Serveur Apache HTTP Version 2.5</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>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p>
<p class="apache">Serveur Apache HTTP Version 2.5</p>
<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="/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. V�rifiez la version
anglaise pour les changements r�cents.</div>
<p>Apache HTTPD supporte la n�gociation de
contenu telle qu'elle est d�crite
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="#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>
</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></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
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 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
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>
<pre class="prettyprint lang-config">AddHandler type-map .var</pre>
<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
<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-language: en<br />
<br />
URI: foo.fr.de.html<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 />
<br />
URI: foo.gif<br />
<br />
URI: foo.txt<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
<code>MultiViews</code> est activ�e pour
<code>/tel/r�pertoire</code>, et si
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>
<pre class="prettyprint lang-config">DirectoryIndex index</pre>
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 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
<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 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>
</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>
</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
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
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
<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><pre class="prettyprint lang-config">SetEnvIf Cookie "language=(.+)" prefer-language=$1
Header append Vary cookie</pre>
</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
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
facteurs de qualit� calcul�s � 5 d�cimales avant d'avoir choisi la meilleure
variante.</p>
<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>
</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>foo<br />
foo.html</td>
<td>-</td>
</tr>
<tr>
<td>foo</td>
</tr>
<tr>
<td>foo<br />
foo.html</td>
foo.html.gz</td>
</tr>
<tr>
<td>foo</td>
foo.html.gz<br />
foo.gz</td>
</tr>
<tr>
<td>foo<br />
foo.gz<br />
foo.gz.html</td>
</tr>
<tr>
<td>foo<br />
foo.html<br />
foo.html.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
(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
<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
en cache des r�ponses n�goci�es.</p>
(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
<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
<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="/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="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/trunk/content-negotiation.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2015 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/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html>