diff options
| author |   hongbotian <hongbo.tianhongbo@huawei.com> | 2015-11-30 01:35:09 -0500 |
|---|---|---|
| committer | hongbotian <hongbo.tianhongbo@huawei.com> | 2015-11-30 01:36:35 -0500 |
| commit | cc40af334e619bb549038238507407866f774f8f (patch) | |
| tree | 43ddc1974f72997a57173151eafb23e6025a13c9 /rubbos/app/apache2/manual/content-negotiation.html.fr | |
| parent | 68e74fd78b2485e5914ce34a5b30f4485029e021 (diff) | |
upload apache
JIRA: BOTTLENECK-10
Change-Id: I67eae31de6dc824097dfa56ab454ba36fdd23a2c
Signed-off-by: hongbotian <hongbo.tianhongbo@huawei.com>
Diffstat (limited to 'rubbos/app/apache2/manual/content-negotiation.html.fr')
| -rw-r--r-- | rubbos/app/apache2/manual/content-negotiation.html.fr | 715 |
1 files changed, 715 insertions, 0 deletions
diff --git a/rubbos/app/apache2/manual/content-negotiation.html.fr b/rubbos/app/apache2/manual/content-negotiation.html.fr new file mode 100644 index 00000000..d800ca77 --- /dev/null +++ b/rubbos/app/apache2/manual/content-negotiation.html.fr @@ -0,0 +1,715 @@ +<?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" /></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 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 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>
\ No newline at end of file |