You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by gr...@apache.org on 2017/02/04 09:19:04 UTC
svn commit: r1781647 - in /httpd/httpd/branches/2.4.x/docs/manual/howto:
http2.html http2.html.fr http2.xml.fr http2.xml.meta
Author: gryzor
Date: Sat Feb 4 09:19:04 2017
New Revision: 1781647
URL: http://svn.apache.org/viewvc?rev=1781647&view=rev
Log:
Adding .fr translation for howto/http2
Added:
httpd/httpd/branches/2.4.x/docs/manual/howto/http2.html.fr
httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.fr
Modified:
httpd/httpd/branches/2.4.x/docs/manual/howto/http2.html
httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.meta
Modified: httpd/httpd/branches/2.4.x/docs/manual/howto/http2.html
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/howto/http2.html?rev=1781647&r1=1781646&r2=1781647&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/howto/http2.html (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/howto/http2.html Sat Feb 4 09:19:04 2017
@@ -3,3 +3,7 @@
URI: http2.html.en
Content-Language: en
Content-type: text/html; charset=ISO-8859-1
+
+URI: http2.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
Added: httpd/httpd/branches/2.4.x/docs/manual/howto/http2.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/howto/http2.html.fr?rev=1781647&view=auto
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/howto/http2.html.fr (added)
+++ httpd/httpd/branches/2.4.x/docs/manual/howto/http2.html.fr Sat Feb 4 09:19:04 2017
@@ -0,0 +1,380 @@
+<?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>
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
+<!--
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ This file is generated from xml source: DO NOT EDIT
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ -->
+<title>Guide HTTP/2 - Serveur Apache HTTP Version 2.4</title>
+<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
+<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
+<script src="../style/scripts/prettify.min.js" type="text/javascript">
+</script>
+
+<link href="../images/favicon.ico" rel="shortcut icon" /></head>
+<body id="manual-page"><div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="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.4</p>
+<img alt="" src="../images/feather.png" /></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.4</a> > <a href="./">How-To / Tutoriels</a></div><div id="page-content"><div id="preamble"><h1>Guide HTTP/2</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/howto/public_html.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/howto/public_html.html" title="Fran�ais"> fr </a> |
+<a href="../ja/howto/public_html.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
+<a href="../ko/howto/public_html.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
+<a href="../tr/howto/public_html.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
+</div>
+
+ <p>Ce document est le guide de l'utilisateur de l'impl�mentation de HTTP/2
+ dans Apache httpd. Cette fonctionnalit� en est au stade
+ <em>exp�rimental</em>, et des modifications sont � pr�voir dans
+ les interfaces et les directives avec les changements de versions.
+ </p>
+ </div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#protocol">Le protocole HTTP/2</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#implementation">HTTP/2 dans Apache httpd</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#building">Compilation de httpd avec le support de HTTP/2</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#basic-config">Configuration de base</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#mpm-config">Configuration du MPM</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#clients">Clients</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#tools">Outils efficaces pour d�boguer HTTP/2</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#push">Push serveur</a></li>
+</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_http2.html">mod_http2</a></li><li><a href="#comments_section">Commentaires</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="protocol" id="protocol">Le protocole HTTP/2</a></h2>
+
+ <p>HTTP/2 est une �volution du protocole de la couche application le plus
+ utilis� au monde, HTTP. Cette �volution permet en particulier une utilisation
+ plus efficace des ressources r�seau. Il ne modifie pas les aspects
+ fondamentaux de HTTP (sa s�mantique). Entre autres, il y a toujours des
+ requ�tes, des r�ponses et des en-t�tes. Par cons�quent, si vous connaissez
+ HTTP/1, vous connaissez d�j� 95% de HTTP/2.</p>
+ <p>Beaucoup a d�j� �t� �crit � propos de HTTP/2 et de son fonctionnement. La
+ documentation la plus officielle est bien entendu sa <a href="https://tools.ietf.org/html/rfc7540">RFC 7540</a> (ou <a href="http://httpwg.org/specs/rfc7540.html">cette version au format plus
+ lisible</a>). Vous trouverez ici une description des rouages de HTTP/2 dans
+ leurs moindres d�tails.</p>
+ <p>Le premier document � lire lorsqu'on ne conna�t pas un m�canisme n'est
+ cependant pas sa RFC. Il est pr�f�rable de comprendre tout d'abord <em>ce
+ que</em> ce m�canisme est cens� faire, et seulement ensuite de lire sa RFC
+ pour comprendre <em>comment</em> il fonctionne. <a href="https://daniel.haxx.se/http2/">http2 explained</a> de Daniel Stenberg
+ (l'auteur de <a href="https://curl.haxx.se">curl</a>)
+ est un bien meilleur document pour d�marrer l'�tude de HTTP/2. En outre, de
+ nouveaux langages s'ajoutent r�guli�rement � sa liste de traductions
+ disponibles !</p>
+ <p>Si vous n'avez pas envie de le lire parce que vous le trouvez trop long,
+ voici certains pi�ges � �viter et nouveaux termes � conna�tre avant de lire
+ ce document :</p>
+ <ul>
+ <li>A la diff�rence de HTTP/1 qui est en texte pur, HTTP/2 est un
+ <strong>protocole binaire</strong>, et alors que le premier est lisible par
+ un humain (par exemple pour sniffer le trafic r�seau), le second ne
+ l'est pas. Voir la <a href="https://http2.github.io/faq/#why-is-http2-binary">FAQ
+ officielle</a> pour plus de d�tails.</li>
+ <li><strong>h2</strong> correspond � HTTP/2 sur TLS (n�gociation de
+ protocole via ALPN).</li>
+ <li><strong>h2c</strong> correspond � HTTP/2 sur TCP.</li>
+ <li>Une <strong>frame</strong> ou trame est la plus petite unit� de
+ communication au sein d'une connexion HTTP/2 et comporte une en-t�te et
+ une s�quence d'octets de longueur variable dont la structure correspond
+ au type de trame. Voir la <a href="http://httpwg.org/specs/rfc7540.html#FramingLayer">section
+ correspondante</a> de la documentation officielle pour plus de
+ d�tails.</li>
+ <li>Un <strong>stream</strong> est un flux bidirectionnel de frames au
+ sein d'une connexion HTTP/2. La notion correspondante dans HTTP/1 est un
+ �change de messages de type requ�te et r�ponse. Voir la <a href="http://httpwg.org/specs/rfc7540.html#StreamsLayer">section
+ correspondante</a> de la documentation officielle pour plus de d�tails.</li>
+ <li>HTTP/2 peut g�rer <strong>plusieurs streams</strong> de donn�es sur
+ la m�me connexion TCP, ce qui permet d'�viter le point de blocage
+ classique de HTTP/1 pour les requ�tes lentes, et de ne pas avoir �
+ ouvrir de nouvelles connexions TCP pour chaque requ�te/r�ponse (les
+ connexions persistantes ou KeepAlive avaient contourn� le probl�me dans
+ HTTP/1 mais ne l'avaient pas enti�rement r�solu)</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="implementation" id="implementation">HTTP/2 dans Apache httpd</a></h2>
+
+ <p>Le protocole HTTP/2 est impl�ment� dans Apache httpd via un module
+ propre, pertinemment nomm� <a href="../mod/mod_http2.html">mod_http2</a>. Ce
+ module impl�mente toutes les fonctionnalit�s d�crites par la RFC 7540 et
+ supporte les connexions en texte pur (http:), ou s�curis�es (https:).
+ La variante texte pur se nomme '<code>h2c</code>', et la variante s�curis�e
+ '<code>h2</code>'. <code>h2c</code> peut �tre en mode <em>direct</em> ou
+ <code>Upgrade:</code> via une requ�te initiale en HTTP/1.</p>
+ <p><a href="#push">Server Push</a> est une nouvelle fonctionnalit� offerte
+ aux d�veloppeurs web par HTTP/2. La section correspondante de ce document
+ vous indiquera comment votre application peut en tirer parti.</p>
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="building" id="building">Compilation de httpd avec le support de HTTP/2</a></h2>
+
+ <p><a href="../mod/mod_http2.html">mod_http2</a> se base sur la biblioth�que
+ de <a href="https://nghttp2.org">nghttp2</a> pour son impl�mentation. Pour
+ pouvoir compiler <code>mod_http2</code>, <code>libnghttp2</code> version
+ 1.2.1. ou sup�rieure doit �tre install�e dans votre syst�me.</p>
+ <p>Pour d�clencher la compilation de <code>mod_http2</code>, vous devez
+ ajouter l'argument '<code>--enable-http2</code>' au script
+ <code>./configure</code> que vous ex�cutez � la racine de l'arborescence des
+ sources de httpd. Si <code>libnghttp2</code> est install�e dans un
+ r�pertoire non connu du chemin de vos biblioth�ques, vous devez indiquer ce
+ r�pertoire au script <code>./configure</code> via l'argument
+ '<code>--with-nghttp2=<path></code>'.</p>
+ <p>Alors que cette m�thode de compilation conviendra � la plupart, certains
+ pr�f�reront lier statiquement <code>nghttp2</code> � ce module. Pour ce
+ faire, utilisez l'argument <code>--enable-nghttp2-staticlib-deps</code>.
+ Cette m�thode est pratiquement la m�me que celle utilis�e pour lier
+ statiquement openssl � mod_ssl.</p>
+ <p>En parlant de SSL, vous devez savoir que la plupart des navigateurs ne
+ communiqueront en HTTP/2 que sur des URLs s�curis�es de type
+ <code>https:</code> ; votre serveur doit donc supporter SSL. Mais de plus,
+ votre biblioth�que SSL devra supporter l'extension <code>ALPN</code>. Enfin,
+ si la biblioth�que que vous utilisez est OpenSSL, sa version devra �tre
+ 1.0.2. ou sup�rieure.</p>
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="basic-config" id="basic-config">Configuration de base</a></h2>
+
+
+ <p>Maintenant que vous disposez d'un binaire <code>httpd</code> compil� avec le
+ module <code>mod_http2</code>, l'activation de ce dernier n�cessite un
+ minimum de configuration suppl�mentaire. En premier lieu, comme pour tout
+ module Apache, vous devez le charger :</p>
+ <pre class="prettyprint lang-config">LoadModule http2_module modules/mod_http2.so</pre>
+
+
+ <p>La seconde directive que vous devez ajouter � votre fichier de
+ configuration est</p>
+ <pre class="prettyprint lang-config">Protocols h2 http/1.1</pre>
+
+ <p>Ceci permet de d�finir h2, la variante s�curis�e, comme le protocole
+ pr�f�r� pour les connexions � votre serveur. Si vous souhaitez que toutes les
+ variantes soient disponibles, utilisez la directive suivante :</p>
+ <pre class="prettyprint lang-config">Protocols h2 h2c http/1.1</pre>
+
+ <p>Selon l'endroit o� vous placez cette directive, elle affectera l'ensemble
+ de votre serveur, ou seulement un ou plusieurs serveurs virtuels. Vous
+ pouvez aussi l'imbriquer comme dans l'exemple suivant :</p>
+ <pre class="prettyprint lang-config">Protocols http/1.1
+<VirtualHost ...>
+ ServerName test.example.org
+ Protocols h2 http/1.1
+</VirtualHost></pre>
+
+
+ <p>Seules les connexions en HTTP/1 seront alors permises, sauf pour le serveur
+ virtuel <code>test.example.org</code> qui acceptera aussi les connexions SSL
+ en HTTP/2.</p>
+ <div class="note"><h3>Utilisez une cha�ne d'algorithmes de chiffrement forte</h3>
+ <p>La directive <code class="directive"><a href="../mod/mod_ssl.html#sslciphersuite">SSLCipherSuite</a></code> doit
+ �tre d�finie avec une cha�ne d'algorithmes de chiffrement TLS forte. M�me si
+ la version actuelle de mod_http2 n'impose pas d'algorithmes de chiffrement
+ particuliers, la plupart des clients le font. Faire pointer un navigateur
+ vers un serveur o� <code>h2</code> est activ� avec une cha�ne d'algorithmes
+ de chiffrement inappropri�e entra�nera un rejet et une retrogradation vers
+ HTTP 1.1. C'est une erreur que l'on fait couramment lorsqu'on configure
+ httpd pour HTTP/2 pour la premi�re fois ; donc gardez la � l'esprit si vous
+ voulez �viter de longues sessions de d�bogage ! Si vous voulez �tre s�r de
+ d�finir une cha�ne d'algorithmes de chiffrement appropri�e, �vitez ceux qui
+ sont list�s dans la <a href="http://httpwg.org/specs/rfc7540.html#BadCipherSuites">blacklist TLS HTTP/2
+ </a>.</p>
+ </div>
+ <p>L'ordre des protocoles indiqu�s est aussi important. Par d�faut, le
+ premier sera le protocole pr�f�r�. Lorsqu'un client offre plusieurs choix,
+ c'est le plus � gauche qui sera s�lectionn�. Dans</p>
+ <pre class="prettyprint lang-config">Protocols http/1.1 h2</pre>
+
+ <p>le protocole pr�f�r� sera HTTP/1 et il sera toujours s�lectionn� sauf si
+ un client ne supporte <em>que</em> h2. Comme nous souhaitons communiquer en
+ HTTP/2 avec les clients qui le supportent, la meilleure d�finition de la
+ directive est</p>
+ <pre class="prettyprint lang-config">Protocols h2 h2c http/1.1</pre>
+
+
+ <p>Toujours � propos de l'ordre des protocoles, le client a lui aussi ses
+ propres pr�f�rences en la mati�re. � ce titre, si vous le souhaitez, vous
+ pouvez configurer votre serveur pour qu'il s�lectionne non plus son
+ protocole pr�f�r�, mais au contraire le protocole pr�f�r�
+ du client :</p>
+ <pre class="prettyprint lang-config">ProtocolsHonorOrder Off</pre>
+
+ <p>Avec cette directive, l'ordre des protocoles que <em>vous</em> avez
+ d�fini devient caduque et seul l'ordre d�fini par le client sera pris en
+ compte.</p>
+ <p>Une derni�re chose : les protocoles que vous d�finissez ne sont pas v�rifi�s
+ quant � leurs validit� ou orthographe. Vous pouvez tr�s bien d�finir des
+ protocoles qui n'existent pas, et il n'est donc pas n�cessaire de filtrer
+ les <code>Protocoles</code> avec des v�rifications de type
+ <code>IfModule</code>.</p>
+ <p>Pour des conseils plus avanc�s � propos de la configuration, voir la <a href="../mod/mod_http2.html">Documentation de mod_http2</a>, et en particulier
+ la section � propos de la <a href="../mod/mod_http2.html#dimensioning">consommation suppl�mentaire de
+ ressources</a>, ainsi que la section expliquant comment g�rer les <a href="../mod/mod_http2.html#misdirected">serveurs multiples avec certificat
+ commun</a>.</p>
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="mpm-config" id="mpm-config">Configuration du MPM</a></h2>
+
+
+ <p>Tous les modules multiprocessus (MPM) fournis avec httpd supportent
+ HTTP/2. Cependant, si vous utilisez le MPM <code>prefork</code>, vous allez
+ faire face � de s�v�res restrictions.</p>
+ <p>Avec le MPM <code>prefork</code>, <code>mod_http2</code> ne traitera
+ qu'une requ�te � la fois par connexion alors que les clients tels que les
+ navigateurs internet envoient de nombreuses requ�tes au m�me moment. Si
+ l'une d'entre elles est longue � traiter (ou implique une longue
+ interrogation), les autres requ�tes seront mises en attente.</p>
+ <p>Par d�faut, <code>mod_http2</code> ne passe pas outre cette limitation pour
+ la simple et bonne raison que le MPM <code>prefork</code> n'est aujourd'hui
+ choisi que si vous ex�cutez des moteurs de traitement qui ne sont pas pr�par�s
+ pour le multithreading (par exemple qui se crashent lorsque plusieurs
+ requ�tes arrivent).</p>
+ <p>Si votre plateforme et votre installation de httpd le supportent, la
+ meilleur solution consiste actuellement � utiliser le MPM
+ <code>event</code>.
+ </p>
+ <p>Si vous n'avez pas d'autre choix que d'utiliser le MPM
+ <code>prefork</code>, mais souhaitez tout de m�me traiter plusieurs requ�tes
+ simultan�ment, vous pouvez jouer avec la directive <code class="directive"><a href="../mod/mod_http2.html#h2minworkers">H2MinWorkers</a></code>, sans garantie que cela
+ fonctionne.</p>
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="clients" id="clients">Clients</a></h2>
+
+ <p>La plupart des navigateurs modernes supportent HTTP/2, mais seulement sur
+ des connexions SSL : Firefox v43, Chrome v45, Safari v9, iOS Safari v9,
+ Opera v35, Chrome pour Android v49 et
+ Internet Explorer v11 sous Windows10 (selon cette <a href="http://caniuse.com/#search=http2">source</a>).</p>
+ <p>D'autres clients et serveurs sont list�s dans le <a href="https://github.com/http2/http2-spec/wiki/Implementations">wiki des
+ impl�mentations</a> ; entre autres des impl�mentations pour c, c++, common
+ lisp, dart, erlang, haskell, java, nodejs, php, python, perl, ruby, rust,
+ scala et swift.</p>
+ <p>De nombreuses impl�mentations clientes autres que les navigateurs
+ supportent HTTP/2 en texte pur, h2c. L'une des plus efficaces d'entre elles
+ est <a href="https://curl.haxx.se">curl</a>.</p>
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="tools" id="tools">Outils efficaces pour d�boguer HTTP/2</a></h2>
+
+ <p>Le premier d'entre eux est bien entendu <a href="https://curl.haxx.se">curl</a>. Assurez-vous au pr�alable que votre
+ version supporte HTTP/2 en v�rifiant ses <code>Fonctionnalit�s</code> :</p>
+ <pre class="prettyprint lang-config"> $ curl -V
+ curl 7.45.0 (x86_64-apple-darwin15.0.0) libcurl/7.45.0 OpenSSL/1.0.2d zlib/1.2.8 nghttp2/1.3.4
+ Protocols: dict file ftp ftps gopher http https imap imaps ldap ldaps pop3 [...]
+ Features: IPv6 Largefile NTLM NTLM_WB SSL libz TLS-SRP <strong>HTTP2</strong>
+ </pre>
+
+ <div class="note"><h3>homebrew sous Mac OS :</h3>
+ brew install curl --with-openssl --with-nghttp2
+ </div>
+ <p>Pour une inspection en profondeur : <a href="https://wiki.wireshark.org/HTTP2">wireshark</a>.</p>
+ <p>Le paquet <a href="https://nghttp2.org">nghttp2</a> inclut aussi des
+ outils comme :</p>
+ <ul>
+ <li><a href="https://nghttp2.org/documentation/nghttp.1.html">nghttp</a>
+ - permet de visualiser les trames HTTP/2 et ainsi de se faire une meilleure
+ id�e du protocole.</li>
+ <li><a href="https://nghttp2.org/documentation/h2load-howto.html">h2load</a> -
+ permet de tester votre serveur dans des conditions extremes.</li>
+ </ul>
+ <p>Chrome fournit des journaux d�taill�s des connexions HTTP/2 via la page
+ <a href="chrome://net-internals/#http2">special net-internals page</a>. Il y
+ a aussi cette extension int�ressante pour <a href="https://chrome.google.com/webstore/detail/http2-and-spdy-indicator/mpbpobfflnpcgagjijhmgnchggcjblin?hl=en">Chrome</a>
+ et <a href="https://addons.mozilla.org/en-us/firefox/addon/spdy-indicator/">Firefox</a>
+ qui permet d'indiquer que votre navigateur utilise HTTP/2.</p>
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="push" id="push">Push serveur</a></h2>
+
+ <p>Le protocole HTTP/2 permet au serveur de proposer (PUSH) des r�ponses
+ pour lesquelles le client n'a rien demand�. La communication autour de ces
+ r�ponses est du style : "voici une requ�te que vous n'avez jamais
+ envoy�e, et la r�ponse vous parviendra bient�t tout de m�me ..."</p>
+ <p>Il y a cependant des conditions : le client peut d�sactiver cette
+ fonctionnalit� et le serveur ne pourra alors lui proposer des r�ponses que
+ pour les requ�tes qu'il a effectivement envoy�es.</p>
+ <p>Cette fonctionnalit� a pour but de permettre au serveur d'envoyer au
+ client des ressources dont il va probablement avoir besoin : par exemple une
+ ressource css ou javascript appartenant � une page html que le client a
+ demand�e, un jeu d'images r�f�renc� par un css, etc...</p>
+ <p>Cette anticipation a pour avantage de permettre au client d'�conomiser le
+ temps qu'il lui aurait fallu pour envoyer une requ�te, quelques
+ millisecondes � une demi-seconde en fonction de l'�loignement du serveur.
+ Elle a cependant pour inconv�nient d'imposer au client le t�l�chargement de
+ ressources qu'il poss�de peut-�tre d�j� dans son cache. Bien entendu, HTTP/2
+ permet d'annuler pr�matur�ment de telles requ�tes, mais des ressources sont
+ tout de m�me gaspill�es.</p>
+ <p>En r�sum� : il n'existe pas encore de strat�gie efficace pour faire le
+ meilleur usage de cette fonctionnalit� de HTTP/2 et tout le monde en est
+ encore au stade de l'exp�rimentation. � ce titre, voici des conseils pour
+ proc�der vous-m�me � ces exp�rimentations :</p>
+ <p><code>mod_http2</code> inspecte l'en-t�te de la r�ponse et recherche les
+ en-t�tes <code>Link</code> sous un certain format :</p>
+ <pre class="prettyprint lang-config">Link </xxx.css>;rel=preload, </xxx.js>; rel=preload</pre>
+
+ <p>Si la connexion supporte PUSH, ces deux ressources seront envoy�es au
+ client. En tant que d�veloppeur web vous pouvez d�finir ces en-t�tes soit
+ directement au niveau de la r�ponse de votre application, soit en
+ configurant votre serveur via</p>
+ <pre class="prettyprint lang-config"><Location /xxx.html>
+ Header add Link "</xxx.css>;rel=preload"
+ Header add Link "</xxx.js>;rel=preload"
+</Location></pre>
+
+ <p>Si vous souhaitez utiliser des liens <code>preload</code> sans d�clencher
+ de PUSH, vous pouvez utiliser le param�tre <code>nopush</code> comme suit :</p>
+ <pre class="prettyprint lang-config">Link </xxx.css>;rel=preload;nopush</pre>
+
+ <p>Vous pouvez aussi d�sactiver les PUSHes pour l'ensemble de votre
+ serveur via la directive</p>
+ <pre class="prettyprint lang-config">H2Push Off</pre>
+
+ <p>� savoir aussi :</p>
+ <p>Le module maintient un journal des ressources ayant fait l'objet d'un
+ PUSH pour chaque connexion (en g�n�ral des condens�s hash des URLs), et
+ n'effectuera pas deux fois un PUSH pour la m�me ressource. Cependant,
+ lorsque la connexion est ferm�e, le journal de ses PUSHes est supprim�.</p>
+ <p>Certains d�veloppeurs planchent sur la mani�re de permettre au client
+ d'informer le serveur des ressources qu'il poss�de d�j� dans son cache afin
+ d'�viter les PUSHes pour ces derni�res, mais ceci n'en est actuellement qu'�
+ un stade tr�s exp�rimental.</p>
+ <p>L'<a href="https://tools.ietf.org/html/draft-ruellan-http-accept-push-policy-00">
+ en-t�te Accept-Push-Policy</a> est un autre dispositif exp�rimental
+ impl�ment� dans <code>mod_http2</code> ; il permet au client de d�finir pour
+ chaque requ�te quels genres de PUSHes il accepte.</p>
+ </div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/howto/public_html.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/howto/public_html.html" title="Fran�ais"> fr </a> |
+<a href="../ja/howto/public_html.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
+<a href="../ko/howto/public_html.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
+<a href="../tr/howto/public_html.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>
+<script type="text/javascript"><!--//--><![CDATA[//><!--
+var comments_shortname = 'httpd';
+var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/public_html.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 2017 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="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>
\ No newline at end of file
Added: httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.fr?rev=1781647&view=auto
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.fr (added)
+++ httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.fr [utf-8] Sat Feb 4 09:19:04 2017
@@ -0,0 +1,368 @@
+<?xml version='1.0' encoding='UTF-8' ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision: 1765974:1780813 (outdated) -->
+<!-- French translation : Lucien GENTIS -->
+<!-- Reviewed by : Vincent Deffontaines -->
+
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<manualpage metafile="public_html.xml.meta">
+<parentdocument href="./">How-To / Tutoriels</parentdocument>
+
+ <title>Guide HTTP/2</title>
+
+ <summary>
+ <p>Ce document est le guide de l'utilisateur de l'impl�mentation de HTTP/2
+ dans Apache httpd. Cette fonctionnalit� en est au stade
+ <em>exp�rimental</em>, et des modifications sont � pr�voir dans
+ les interfaces et les directives avec les changements de versions.
+ </p>
+ </summary>
+ <seealso><a href="../mod/mod_http2.html">mod_http2</a></seealso>
+
+ <section id="protocol">
+ <title>Le protocole HTTP/2</title>
+ <p>HTTP/2 est une �volution du protocole de la couche application le plus
+ utilis� au monde, HTTP. Cette �volution permet en particulier une utilisation
+ plus efficace des ressources r�seau. Il ne modifie pas les aspects
+ fondamentaux de HTTP (sa s�mantique). Entre autres, il y a toujours des
+ requ�tes, des r�ponses et des en-t�tes. Par cons�quent, si vous connaissez
+ HTTP/1, vous connaissez d�j� 95% de HTTP/2.</p>
+ <p>Beaucoup a d�j� �t� �crit � propos de HTTP/2 et de son fonctionnement. La
+ documentation la plus officielle est bien entendu sa <a
+ href="https://tools.ietf.org/html/rfc7540">RFC 7540</a> (ou <a
+ href="http://httpwg.org/specs/rfc7540.html">cette version au format plus
+ lisible</a>). Vous trouverez ici une description des rouages de HTTP/2 dans
+ leurs moindres d�tails.</p>
+ <p>Le premier document � lire lorsqu'on ne conna�t pas un m�canisme n'est
+ cependant pas sa RFC. Il est pr�f�rable de comprendre tout d'abord <em>ce
+ que</em> ce m�canisme est cens� faire, et seulement ensuite de lire sa RFC
+ pour comprendre <em>comment</em> il fonctionne. <a
+ href="https://daniel.haxx.se/http2/">http2 explained</a> de Daniel Stenberg
+ (l'auteur de <a href="https://curl.haxx.se">curl</a>)
+ est un bien meilleur document pour d�marrer l'�tude de HTTP/2. En outre, de
+ nouveaux langages s'ajoutent r�guli�rement � sa liste de traductions
+ disponibles !</p>
+ <p>Si vous n'avez pas envie de le lire parce que vous le trouvez trop long,
+ voici certains pi�ges � �viter et nouveaux termes � conna�tre avant de lire
+ ce document :</p>
+ <ul>
+ <li>A la diff�rence de HTTP/1 qui est en texte pur, HTTP/2 est un
+ <strong>protocole binaire</strong>, et alors que le premier est lisible par
+ un humain (par exemple pour sniffer le trafic r�seau), le second ne
+ l'est pas. Voir la <a
+ href="https://http2.github.io/faq/#why-is-http2-binary">FAQ
+ officielle</a> pour plus de d�tails.</li>
+ <li><strong>h2</strong> correspond � HTTP/2 sur TLS (n�gociation de
+ protocole via ALPN).</li>
+ <li><strong>h2c</strong> correspond � HTTP/2 sur TCP.</li>
+ <li>Une <strong>frame</strong> ou trame est la plus petite unit� de
+ communication au sein d'une connexion HTTP/2 et comporte une en-t�te et
+ une s�quence d'octets de longueur variable dont la structure correspond
+ au type de trame. Voir la <a
+ href="http://httpwg.org/specs/rfc7540.html#FramingLayer">section
+ correspondante</a> de la documentation officielle pour plus de
+ d�tails.</li>
+ <li>Un <strong>stream</strong> est un flux bidirectionnel de frames au
+ sein d'une connexion HTTP/2. La notion correspondante dans HTTP/1 est un
+ �change de messages de type requ�te et r�ponse. Voir la <a
+ href="http://httpwg.org/specs/rfc7540.html#StreamsLayer">section
+ correspondante</a> de la documentation officielle pour plus de d�tails.</li>
+ <li>HTTP/2 peut g�rer <strong>plusieurs streams</strong> de donn�es sur
+ la m�me connexion TCP, ce qui permet d'�viter le point de blocage
+ classique de HTTP/1 pour les requ�tes lentes, et de ne pas avoir �
+ ouvrir de nouvelles connexions TCP pour chaque requ�te/r�ponse (les
+ connexions persistantes ou KeepAlive avaient contourn� le probl�me dans
+ HTTP/1 mais ne l'avaient pas enti�rement r�solu)</li>
+ </ul>
+ </section>
+
+ <section id="implementation">
+ <title>HTTP/2 dans Apache httpd</title>
+ <p>Le protocole HTTP/2 est impl�ment� dans Apache httpd via un module
+ propre, pertinemment nomm� <a href="../mod/mod_http2.html">mod_http2</a>. Ce
+ module impl�mente toutes les fonctionnalit�s d�crites par la RFC 7540 et
+ supporte les connexions en texte pur (http:), ou s�curis�es (https:).
+ La variante texte pur se nomme '<code>h2c</code>', et la variante s�curis�e
+ '<code>h2</code>'. <code>h2c</code> peut �tre en mode <em>direct</em> ou
+ <code>Upgrade:</code> via une requ�te initiale en HTTP/1.</p>
+ <p><a href="#push">Server Push</a> est une nouvelle fonctionnalit� offerte
+ aux d�veloppeurs web par HTTP/2. La section correspondante de ce document
+ vous indiquera comment votre application peut en tirer parti.</p>
+ </section>
+
+ <section id="building">
+ <title>Compilation de httpd avec le support de HTTP/2</title>
+ <p><a href="../mod/mod_http2.html">mod_http2</a> se base sur la biblioth�que
+ de <a href="https://nghttp2.org">nghttp2</a> pour son impl�mentation. Pour
+ pouvoir compiler <code>mod_http2</code>, <code>libnghttp2</code> version
+ 1.2.1. ou sup�rieure doit �tre install�e dans votre syst�me.</p>
+ <p>Pour d�clencher la compilation de <code>mod_http2</code>, vous devez
+ ajouter l'argument '<code>--enable-http2</code>' au script
+ <code>./configure</code> que vous ex�cutez � la racine de l'arborescence des
+ sources de httpd. Si <code>libnghttp2</code> est install�e dans un
+ r�pertoire non connu du chemin de vos biblioth�ques, vous devez indiquer ce
+ r�pertoire au script <code>./configure</code> via l'argument
+ '<code>--with-nghttp2=<path></code>'.</p>
+ <p>Alors que cette m�thode de compilation conviendra � la plupart, certains
+ pr�f�reront lier statiquement <code>nghttp2</code> � ce module. Pour ce
+ faire, utilisez l'argument <code>--enable-nghttp2-staticlib-deps</code>.
+ Cette m�thode est pratiquement la m�me que celle utilis�e pour lier
+ statiquement openssl � mod_ssl.</p>
+ <p>En parlant de SSL, vous devez savoir que la plupart des navigateurs ne
+ communiqueront en HTTP/2 que sur des URLs s�curis�es de type
+ <code>https:</code> ; votre serveur doit donc supporter SSL. Mais de plus,
+ votre biblioth�que SSL devra supporter l'extension <code>ALPN</code>. Enfin,
+ si la biblioth�que que vous utilisez est OpenSSL, sa version devra �tre
+ 1.0.2. ou sup�rieure.</p>
+ </section>
+
+ <section id="basic-config">
+ <title>Configuration de base</title>
+
+ <p>Maintenant que vous disposez d'un binaire <code>httpd</code> compil� avec le
+ module <code>mod_http2</code>, l'activation de ce dernier n�cessite un
+ minimum de configuration suppl�mentaire. En premier lieu, comme pour tout
+ module Apache, vous devez le charger :</p>
+ <highlight language="config">
+LoadModule http2_module modules/mod_http2.so
+ </highlight>
+
+ <p>La seconde directive que vous devez ajouter � votre fichier de
+ configuration est</p>
+ <highlight language="config">
+Protocols h2 http/1.1
+</highlight>
+ <p>Ceci permet de d�finir h2, la variante s�curis�e, comme le protocole
+ pr�f�r� pour les connexions � votre serveur. Si vous souhaitez que toutes les
+ variantes soient disponibles, utilisez la directive suivante :</p>
+ <highlight language="config">
+Protocols h2 h2c http/1.1
+</highlight>
+ <p>Selon l'endroit o� vous placez cette directive, elle affectera l'ensemble
+ de votre serveur, ou seulement un ou plusieurs serveurs virtuels. Vous
+ pouvez aussi l'imbriquer comme dans l'exemple suivant :</p>
+ <highlight language="config">
+Protocols http/1.1
+<VirtualHost ...>
+ ServerName test.example.org
+ Protocols h2 http/1.1
+</VirtualHost>
+</highlight>
+
+ <p>Seules les connexions en HTTP/1 seront alors permises, sauf pour le serveur
+ virtuel <code>test.example.org</code> qui acceptera aussi les connexions SSL
+ en HTTP/2.</p>
+ <note><title>Utilisez une cha�ne d'algorithmes de chiffrement forte</title>
+ <p>La directive <directive module="mod_ssl">SSLCipherSuite</directive> doit
+ �tre d�finie avec une cha�ne d'algorithmes de chiffrement TLS forte. M�me si
+ la version actuelle de mod_http2 n'impose pas d'algorithmes de chiffrement
+ particuliers, la plupart des clients le font. Faire pointer un navigateur
+ vers un serveur o� <code>h2</code> est activ� avec une cha�ne d'algorithmes
+ de chiffrement inappropri�e entra�nera un rejet et une retrogradation vers
+ HTTP 1.1. C'est une erreur que l'on fait couramment lorsqu'on configure
+ httpd pour HTTP/2 pour la premi�re fois ; donc gardez la � l'esprit si vous
+ voulez �viter de longues sessions de d�bogage ! Si vous voulez �tre s�r de
+ d�finir une cha�ne d'algorithmes de chiffrement appropri�e, �vitez ceux qui
+ sont list�s dans la <a
+ href="http://httpwg.org/specs/rfc7540.html#BadCipherSuites">blacklist TLS HTTP/2
+ </a>.</p>
+ </note>
+ <p>L'ordre des protocoles indiqu�s est aussi important. Par d�faut, le
+ premier sera le protocole pr�f�r�. Lorsqu'un client offre plusieurs choix,
+ c'est le plus � gauche qui sera s�lectionn�. Dans</p>
+ <highlight language="config">
+Protocols http/1.1 h2
+</highlight>
+ <p>le protocole pr�f�r� sera HTTP/1 et il sera toujours s�lectionn� sauf si
+ un client ne supporte <em>que</em> h2. Comme nous souhaitons communiquer en
+ HTTP/2 avec les clients qui le supportent, la meilleure d�finition de la
+ directive est</p>
+ <highlight language="config">
+Protocols h2 h2c http/1.1
+</highlight>
+
+ <p>Toujours � propos de l'ordre des protocoles, le client a lui aussi ses
+ propres pr�f�rences en la mati�re. � ce titre, si vous le souhaitez, vous
+ pouvez configurer votre serveur pour qu'il s�lectionne non plus son
+ protocole pr�f�r�, mais au contraire le protocole pr�f�r�
+ du client :</p>
+ <highlight language="config">
+ProtocolsHonorOrder Off
+ </highlight>
+ <p>Avec cette directive, l'ordre des protocoles que <em>vous</em> avez
+ d�fini devient caduque et seul l'ordre d�fini par le client sera pris en
+ compte.</p>
+ <p>Une derni�re chose : les protocoles que vous d�finissez ne sont pas v�rifi�s
+ quant � leurs validit� ou orthographe. Vous pouvez tr�s bien d�finir des
+ protocoles qui n'existent pas, et il n'est donc pas n�cessaire de filtrer
+ les <code>Protocoles</code> avec des v�rifications de type
+ <code>IfModule</code>.</p>
+ <p>Pour des conseils plus avanc�s � propos de la configuration, voir la <a
+ href="../mod/mod_http2.html">Documentation de mod_http2</a>, et en particulier
+ la section � propos de la <a
+ href="../mod/mod_http2.html#dimensioning">consommation suppl�mentaire de
+ ressources</a>, ainsi que la section expliquant comment g�rer les <a
+ href="../mod/mod_http2.html#misdirected">serveurs multiples avec certificat
+ commun</a>.</p>
+ </section>
+
+ <section id="mpm-config">
+ <title>Configuration du MPM</title>
+
+ <p>Tous les modules multiprocessus (MPM) fournis avec httpd supportent
+ HTTP/2. Cependant, si vous utilisez le MPM <code>prefork</code>, vous allez
+ faire face � de s�v�res restrictions.</p>
+ <p>Avec le MPM <code>prefork</code>, <code>mod_http2</code> ne traitera
+ qu'une requ�te � la fois par connexion alors que les clients tels que les
+ navigateurs internet envoient de nombreuses requ�tes au m�me moment. Si
+ l'une d'entre elles est longue � traiter (ou implique une longue
+ interrogation), les autres requ�tes seront mises en attente.</p>
+ <p>Par d�faut, <code>mod_http2</code> ne passe pas outre cette limitation pour
+ la simple et bonne raison que le MPM <code>prefork</code> n'est aujourd'hui
+ choisi que si vous ex�cutez des moteurs de traitement qui ne sont pas pr�par�s
+ pour le multithreading (par exemple qui se crashent lorsque plusieurs
+ requ�tes arrivent).</p>
+ <p>Si votre plateforme et votre installation de httpd le supportent, la
+ meilleur solution consiste actuellement � utiliser le MPM
+ <code>event</code>.
+ </p>
+ <p>Si vous n'avez pas d'autre choix que d'utiliser le MPM
+ <code>prefork</code>, mais souhaitez tout de m�me traiter plusieurs requ�tes
+ simultan�ment, vous pouvez jouer avec la directive <directive
+ module="mod_http2">H2MinWorkers</directive>, sans garantie que cela
+ fonctionne.</p>
+ </section>
+
+ <section id="clients">
+ <title>Clients</title>
+ <p>La plupart des navigateurs modernes supportent HTTP/2, mais seulement sur
+ des connexions SSL : Firefox v43, Chrome v45, Safari v9, iOS Safari v9,
+ Opera v35, Chrome pour Android v49 et
+ Internet Explorer v11 sous Windows10 (selon cette <a
+ href="http://caniuse.com/#search=http2">source</a>).</p>
+ <p>D'autres clients et serveurs sont list�s dans le <a
+ href="https://github.com/http2/http2-spec/wiki/Implementations">wiki des
+ impl�mentations</a> ; entre autres des impl�mentations pour c, c++, common
+ lisp, dart, erlang, haskell, java, nodejs, php, python, perl, ruby, rust,
+ scala et swift.</p>
+ <p>De nombreuses impl�mentations clientes autres que les navigateurs
+ supportent HTTP/2 en texte pur, h2c. L'une des plus efficaces d'entre elles
+ est <a href="https://curl.haxx.se">curl</a>.</p>
+ </section>
+
+ <section id="tools">
+ <title>Outils efficaces pour d�boguer HTTP/2</title>
+ <p>Le premier d'entre eux est bien entendu <a
+ href="https://curl.haxx.se">curl</a>. Assurez-vous au pr�alable que votre
+ version supporte HTTP/2 en v�rifiant ses <code>Fonctionnalit�s</code> :</p>
+ <highlight language="config">
+ $ curl -V
+ curl 7.45.0 (x86_64-apple-darwin15.0.0) libcurl/7.45.0 OpenSSL/1.0.2d zlib/1.2.8 nghttp2/1.3.4
+ Protocols: dict file ftp ftps gopher http https imap imaps ldap ldaps pop3 [...]
+ Features: IPv6 Largefile NTLM NTLM_WB SSL libz TLS-SRP <strong>HTTP2</strong>
+ </highlight>
+ <note><title>homebrew sous Mac OS :</title>
+ brew install curl --with-openssl --with-nghttp2
+ </note>
+ <p>Pour une inspection en profondeur : <a href="https://wiki.wireshark.org/HTTP2">wireshark</a>.</p>
+ <p>Le paquet <a href="https://nghttp2.org">nghttp2</a> inclut aussi des
+ outils comme :</p>
+ <ul>
+ <li><a href="https://nghttp2.org/documentation/nghttp.1.html">nghttp</a>
+ - permet de visualiser les trames HTTP/2 et ainsi de se faire une meilleure
+ id�e du protocole.</li>
+ <li><a
+ href="https://nghttp2.org/documentation/h2load-howto.html">h2load</a> -
+ permet de tester votre serveur dans des conditions extremes.</li>
+ </ul>
+ <p>Chrome fournit des journaux d�taill�s des connexions HTTP/2 via la page
+ <a href="chrome://net-internals/#http2">special net-internals page</a>. Il y
+ a aussi cette extension int�ressante pour <a
+ href="https://chrome.google.com/webstore/detail/http2-and-spdy-indicator/mpbpobfflnpcgagjijhmgnchggcjblin?hl=en">Chrome</a>
+ et <a
+ href="https://addons.mozilla.org/en-us/firefox/addon/spdy-indicator/">Firefox</a>
+ qui permet d'indiquer que votre navigateur utilise HTTP/2.</p>
+ </section>
+
+ <section id="push">
+ <title>Push serveur</title>
+ <p>Le protocole HTTP/2 permet au serveur de proposer (PUSH) des r�ponses
+ pour lesquelles le client n'a rien demand�. La communication autour de ces
+ r�ponses est du style : "voici une requ�te que vous n'avez jamais
+ envoy�e, et la r�ponse vous parviendra bient�t tout de m�me ..."</p>
+ <p>Il y a cependant des conditions : le client peut d�sactiver cette
+ fonctionnalit� et le serveur ne pourra alors lui proposer des r�ponses que
+ pour les requ�tes qu'il a effectivement envoy�es.</p>
+ <p>Cette fonctionnalit� a pour but de permettre au serveur d'envoyer au
+ client des ressources dont il va probablement avoir besoin : par exemple une
+ ressource css ou javascript appartenant � une page html que le client a
+ demand�e, un jeu d'images r�f�renc� par un css, etc...</p>
+ <p>Cette anticipation a pour avantage de permettre au client d'�conomiser le
+ temps qu'il lui aurait fallu pour envoyer une requ�te, quelques
+ millisecondes � une demi-seconde en fonction de l'�loignement du serveur.
+ Elle a cependant pour inconv�nient d'imposer au client le t�l�chargement de
+ ressources qu'il poss�de peut-�tre d�j� dans son cache. Bien entendu, HTTP/2
+ permet d'annuler pr�matur�ment de telles requ�tes, mais des ressources sont
+ tout de m�me gaspill�es.</p>
+ <p>En r�sum� : il n'existe pas encore de strat�gie efficace pour faire le
+ meilleur usage de cette fonctionnalit� de HTTP/2 et tout le monde en est
+ encore au stade de l'exp�rimentation. � ce titre, voici des conseils pour
+ proc�der vous-m�me � ces exp�rimentations :</p>
+ <p><code>mod_http2</code> inspecte l'en-t�te de la r�ponse et recherche les
+ en-t�tes <code>Link</code> sous un certain format :</p>
+ <highlight language="config">
+Link </xxx.css>;rel=preload, </xxx.js>; rel=preload
+ </highlight>
+ <p>Si la connexion supporte PUSH, ces deux ressources seront envoy�es au
+ client. En tant que d�veloppeur web vous pouvez d�finir ces en-t�tes soit
+ directement au niveau de la r�ponse de votre application, soit en
+ configurant votre serveur via</p>
+ <highlight language="config">
+<Location /xxx.html>
+ Header add Link "</xxx.css>;rel=preload"
+ Header add Link "</xxx.js>;rel=preload"
+</Location>
+ </highlight>
+ <p>Si vous souhaitez utiliser des liens <code>preload</code> sans d�clencher
+ de PUSH, vous pouvez utiliser le param�tre <code>nopush</code> comme suit :</p>
+ <highlight language="config">
+Link </xxx.css>;rel=preload;nopush
+ </highlight>
+ <p>Vous pouvez aussi d�sactiver les PUSHes pour l'ensemble de votre
+ serveur via la directive</p>
+ <highlight language="config">
+H2Push Off
+ </highlight>
+ <p>� savoir aussi :</p>
+ <p>Le module maintient un journal des ressources ayant fait l'objet d'un
+ PUSH pour chaque connexion (en g�n�ral des condens�s hash des URLs), et
+ n'effectuera pas deux fois un PUSH pour la m�me ressource. Cependant,
+ lorsque la connexion est ferm�e, le journal de ses PUSHes est supprim�.</p>
+ <p>Certains d�veloppeurs planchent sur la mani�re de permettre au client
+ d'informer le serveur des ressources qu'il poss�de d�j� dans son cache afin
+ d'�viter les PUSHes pour ces derni�res, mais ceci n'en est actuellement qu'�
+ un stade tr�s exp�rimental.</p>
+ <p>L'<a href="https://tools.ietf.org/html/draft-ruellan-http-accept-push-policy-00">
+ en-t�te Accept-Push-Policy</a> est un autre dispositif exp�rimental
+ impl�ment� dans <code>mod_http2</code> ; il permet au client de d�finir pour
+ chaque requ�te quels genres de PUSHes il accepte.</p>
+ </section>
+
+</manualpage>
Modified: httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.meta?rev=1781647&r1=1781646&r2=1781647&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.meta (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.meta Sat Feb 4 09:19:04 2017
@@ -8,5 +8,6 @@
<variants>
<variant>en</variant>
+ <variant outdated="yes">fr</variant>
</variants>
</metafile>