| Quellcodebibliothek Statistik Leitseite products/Sources/formale Sprachen/C/Apache/docs/manual/mod/ (Apache Software Stiftung Version 2.4.65©) Datei vom 7.5.2025 mit Größe 77 kB |
|
Quellcode-Bibliothek mod_http2.html.fr.utf8 Sprache: unbekannt |
|
|
Columbo aufrufen.utf8 Download desUnknown {[0] [0] [0]}Datei anzeigen <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DT <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> <meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX --> <title>mod_http2 - Serveur HTTP Apache Version 2.4</title> <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" titl <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="al <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/ <script src="../style/scripts/prettify.min.js" type="text/javascript"> </script> <link href="../images/favicon.ico" rel="shortcut icon" /></head> <body> <div id="page-header"> <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> <p class="apache">Serveur HTTP Apache 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 HTT <div id="page-content"> <div id="preamble"><h1>Module Apache mod_http2</h1> <div class="toplang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_http2.html" hreflang="en" rel="a <a href="../fr/mod/mod_http2.html" title="Français"> fr </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Su <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>http2 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_http2.c</td></tr> <tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de HTTP Apache</td></tr></table> <h3>Sommaire</h3> <p>Ce module ajoute le support de HTTP/2 (<a href="https://tools.ietf.org/html/rfc7540">RFC 7 Apache.</p> <p>Il s'appuie sur la bibliothèque <a href="http://nghttp2.org/">libnghttp2</a> pour implémenter moteur de base http/2.</p> <p>Pour mettre en oeuvre les fonctionnalités décrites dans ce document, vous devez activer HTTP/2 en utilisant la directive <code class="directive"><a href="../mod/core.html#protocols">Protocols</a></code>. HTTP/2 <a h pas</a> de chiffrement, deux protocoles sont disponibles : <code>h2</code> (HTTP/2 avec TLS) at <code>h2c</code> (HTTP/2 avec TCP).</p> <p>Voici deux types de configuration courant :</p> <div class="note"><h3>HTTP/2 dans un contexte de serveur virtuel (TLS seulement)</h3> <pre class="prettyprint lang-config">Protocols h2 http/1.1</pre> <p>Permet une négociation HTTP/2 (h2) via TLS ALPN au sein d'un <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> sécurisé. La vérification du préambule HTTP/2 (mode direct, voir <code class="directive"><a href="#h2direct">H2Direct</a></code>) est désactivée par défaut pour <code>h2</code>.</p> </div> <div class="note"><h3>HTTP/2 dans un contexte de serveur (TLS et texte pur)</h3> <pre class="prettyprint lang-config">Protocols h2 h2c http/1.1</pre> <p>Permet une négociation HTTP/2 (h2) via TLS ALPN au sein d'un <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> sécurisé. Permet aussi une négociation HTTP/2 en texte pur (h2c) en effectuant une mise à jour depuis une connexion initiale HTTP/1.1 ou via une vérification du préambule HTTP/2 (mode direct, voir <code class="directive"><a href="#h2direct">H2Direct</a></code>).</p> </div> <p>Si vous avez besoin d'informations supplémentaires à propos du protocole, veuillez vous reporter à la <a href="https://http2.github.io/faq">HTTP/2 FAQ</a>.</ </div> <div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" clas <ul id="topics"> <li><img alt="" src="../images/down.gif" /> <a href="#how-it-works">Comment ça marche ?</a></li> </ul><h3 class="directives">Directives</h3> <ul id="toc"> <li><img alt="" src="../images/down.gif" /> <a href="#h2copyfiles">H2CopyFiles</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#h2direct">H2Direct</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#h2earlyhint">H2EarlyHint</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#h2earlyhints">H2EarlyHints</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#h2maxdataframelen">H2MaxDataFrameLen</ <li><img alt="" src="../images/down.gif" /> <a href="#h2maxheaderblocklen">H2MaxHeaderBlock <li><img alt="" src="../images/down.gif" /> <a href="#h2maxsessionstreams">H2MaxSessionStre <li><img alt="" src="../images/down.gif" /> <a href="#h2maxworkeridleseconds">H2MaxWorkerId <li><img alt="" src="../images/down.gif" /> <a href="#h2maxworkers">H2MaxWorkers</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#h2minworkers">H2MinWorkers</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#h2moderntlsonly">H2ModernTLSOnly</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#h2outputbuffering">H2OutputBuffering</ <li><img alt="" src="../images/down.gif" /> <a href="#h2padding">H2Padding</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#h2proxyrequests">H2ProxyRequests</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#h2push">H2Push</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#h2pushdiarysize">H2PushDiarySize</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#h2pushpriority">H2PushPriority</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#h2pushresource">H2PushResource</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#h2serializeheaders">H2SerializeHeader <li><img alt="" src="../images/down.gif" /> <a href="#h2streammaxmemsize">H2StreamMaxMemSiz <li><img alt="" src="../images/down.gif" /> <a href="#h2streamtimeout">H2StreamTimeout</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#h2tlscooldownsecs">H2TLSCoolDownSecs</ <li><img alt="" src="../images/down.gif" /> <a href="#h2tlswarmupsize">H2TLSWarmUpSize</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#h2upgrade">H2Upgrade</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#h2websockets">H2WebSockets</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#h2windowsize">H2WindowSize</a></li> </ul> <h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/http <ul class="seealso"> <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="how-it-works" id="how-it-works">Comment ça marche ?</a></h2> <h3><a name="dimensioning" id="dimensioning">Quantification des ressources supplémentaires nécessaires à HTTP/2</a></h3> <p> Activer HTTP/2 sur votre serveur Apache a un impact sur la consommation de ressources, et si votre site est très actif, il est conseillé d'en prendre sérieusement en compte les implications. </p> <p> HTTP/2 attribue à chaque requête qu'il reçoit son propre <em>thread de travail</em> pour son traitement, la collecte des résultats et l'envoie de ces derniers au client. Pour y parvenir, il lui faut lancer des threads supplémentaires, et ceci constituera le premier effet notable de l'activation de HTTP/2. </p> <p> Dans l'implémentation actuelle, ces threads de travail font partie d'un jeu de threads distinct de celui des threads de travail du MPM avec lequel vous êtes familié. Il s'agit simplement du mode de fonctionnement actuel, et il n'en sera pas obligatoirement toujours ainsi (il est cependant probable que la situation restera inchangée avec la version 2.4.x). De par ce mode de fonctionnement, les threads de travail HTTP/2, ou plus simplement H2 ne seront pas affichés par <code class="module"><a href="../mod/mod_status.html">mod_status</a></code>. De mêm pris en compte par les directives du style <code class="directive"><a href="../mod/mpm_common utilisent par défaut la valeur de <code class="directive"><a href="../mod/mpm_common.html#th spécifié d'autres valeurs via <code class="directive"><a href="#h2minworkers">H2MinWorkers</a>< </p> <p> Autre changement à surveiller : la consommation de mémoire. En effet, comme HTTP/2 conserve plus d'informations sur le serveur pour gérer toutes les requêtes en cours, leurs priorités et interdépendances, il aura toujours besoin de plus de mémoire que pour un traitement en HTTP/1.1. Trois directives permettent de limiter l'empreinte mémoire d'une connexion HTTP/2 : <code class="directive"><a href="#h2maxs </p> <p> La directive <code class="directive"><a href="#h2maxsessionstreams">H2MaxSessionStreams</ le nombre de requêtes simultanées qu'un client peut envoyer sur une connexion HTTP/2. La valeur que vous allez définir dépend de votre site. La valeur par défaut qui est de 100 est largement suffisante, et à moins que vous ne soyez un peu juste en mémoire, je vous conseille de ne pas la modifier. La plupart des requêtes qu'envoie un client sont des requêtes de type GET sans corps qui n'utilisent que très peu de mémoire en attendant le démarrage du traitement. </p> <p> La directive <code class="directive"><a href="#h2windowsize">H2WindowSize</a></code> permet de définir la taille maximale que peut avoir le corps d'une requête que le client envoie avant d'attendre que le serveur en demande d'avantage. En d'autres termes, il s'agit de la quantité de données que le serveur peut stocker dans son tampon, valable pour une requête. </p> <p> En outre, la directive <code class="directive"><a href="#h2streammaxmemsize">H2StreamMaxMe la quantité de données de la réponse qui doit être mise en tampon. Chaque requête étant prise en charge par un thread H2Worker et produisant des données que le serveur tente de transmettre au client via une connexion HTTP/2, si le client n'est pas en mesure de lire ces données assez rapidement, la connexion les mettra en tampon et interrompra l'exécution du thread H2Worker correspondant. </p> <h3><a name="misdirected" id="misdirected">Serveurs virtuels et requêtes mal redirigées</a></h3> <p> De nombreux site utilisent le même certificat TLS pour plusieurs serveurs virtuels. Ce certificat référence un nom de serveur générique comme '*.example.org' ou plusieurs noms de serveur différents. Les navigateurs qui utilisent HTTP/2 détectent ce comportement et réutilisent une connexion déjà ouverte pour ces serveurs. </p> <p> Ceci améliore considérablement les performances, mais il y a un prix à payer : il faut accorder un soin tout particulier à la configuration de tels serveurs virtuels. Le problème réside dans le fait que plusieurs requêtes pour plusieurs serveurs virtuels vont se partager la même connexion TLS, et ceci empêche toute renégociation car le standard HTTP/2 l'interdit. </p> <p> Ainsi, lorsque plusieurs de vos serveurs virtuels utilisent le même certificat et si vous souhaitez utiliser HTTP/2 pour y accéder, vous devez vous assurer que tous vos serveurs virtuels possèdent exactement la même configuration SSL. En particulier, ils doivent utiliser les mêmes protocole, algorithme de chiffrement et configuration pour la vérification du client. </p> <p> Dans le cas contraire, Apache httpd le détectera et renverra au client un code de réponse spécial, 421 Misdirected Request. </p> <h3><a name="envvars" id="envvars">Variables d'environnement</a></h3> <p>Ce module peut être configuré pour fournir des informations en rapport avec HTTP/2 sous la forme de variables d'environnement supplémentaires dans l'espace de nommage SSI et CGI, ainsi que dans les configurations personnalisées de le journalisation (voir <code>%{VAR_NAME}e</code>). </p> <table class="bordered"> <tr> <th><a name="table3">Nom variable :</a></th> <th>Type :</th> <th>Description :</th> </tr> <tr><td><code>HTTPe</code></td><td>drapeau</td><td>HTTP/2 est utilisé.</td></tr> <tr><td><code>H2PUSH</code></td><td>drapeau</td><td>La fonctionnalité HTTP/2 Server Push est activée pour cette requête et supportée par le client.</td></tr> <tr><td><code>H2_PUSH</code></td><td>drapeau</td><td>autre nom pour <code>H2PUSH</code></td></tr> <tr><td><code>H2_PUSHED</code></td><td>chaîne</td><td>vide ou <code>PUSHED</code> pour une requête pushée par le serveur.</td></tr> <tr><td><code>H2_PUSHED_ON</code></td><td>nombre</td><td>numéro du flux HTTP/2 qui a déclenché le push de cette requête.</td></tr> <tr><td><code>H2_STREAM_ID</code></td><td>nombre</td><td>numéro du flux HTTP/2 de cette requête.</td></tr> <tr><td><code>H2_STREAM_TAG</code></td><td>chaîne</td><td>identifiant de flux unique du processus HTTP/2 composé de l'identifiant de la connexion et de l'identifiant du flux séparés par <code>-</code>.</td></tr> </table> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2copyfiles" id="h2copyfiles">Directive</a> <a nam <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contrôle la gestion de <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2CopyFiles on|off</code></ <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>H2CopyFiles off</code></td></t <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à parti Apache.</td></tr> </table> <p> Cette directive permet de définir la manière de gérer les contenus de fichiers dans les réponses. Lorsqu'elle est à <code>off</code> (sa valeur par défaut), les descripteurs de fichiers sont transmis par le processus de traitement de la requête vers la connexion principale en utilisant le système habituel de mise en réserve d'Apache pour gérer le durée de vie du fichier. </p> <p> Lorsqu'elle est à <code>on</code>, le contenu du fichier est recopier pendant le traitement de la requête et ces données mises en tampon sont transmises vers la connexion principale, ce qui s'avère avantageux lorsqu'un module tiers injecte dans la réponse des fichiers possédant des durées de vie différentes. </p> <p> Un exemple de ces modules tiers : <code>mod_wsgi</code> qui peut injecter des descripteurs de fichiers dans la réponse. Ces fichiers sont fermés lorsque Python estime que le traitement est terminé, alors que <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> es encore loin d'en avoir fini avec eux. </p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2direct" id="h2direct">Directive</a> <a name="H2D <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Activation du protoc <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2Direct on|off</code></td></ <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>H2Direct on pour h2c, off pou <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> </table> <p> Cette directive permet d'activer/désactiver l'utilisation du mode HTTP/2 Direct. Elle doit être située dans une section <code class="directive"><a href="../mod/core.html#virtualhost"><Virt communication directe HTTP/2 pour le serveur virtuel considéré. </p> <p> La notion de communication directe signifie que si les premiers octets reçus par le serveur correspondent à un en-tête HTTP/2, le protocole HTTP/2 est utilisé sans négociation supplémentaire. Ce mode est défini pour les transmissions en clair (h2c) dans la RFC 7540. Son utilisation avec les connexions TLS n'est pas officiellement supportée. </p> <p> Lorsque le protocole h2 ou h2c n'est pas activé via la directive <code class="directive"><a href="../mod/core.html#protocols">Protocols</a></code> jamais effectuée au sein d'une connexion. La directive <code class="directive">H2Direct</code> ne produit alors aucun effet. Ceci est important pour les connexions qui utilisent un protocole pour lequel une lecture initiale peut entraîner un blocage définitif comme NNTP. </p> <p> Pour un client qui sait qu'un serveur supporte h2c, la communication directe HTTP/2 dispense le client d'une mise à jour HTTP/1.1, ce qui entraîne une amélioration des performances et évite les restrictions sur les corps de requête suite à une mise à jour. </p> <p> Cette directive rend aussi h2c plus attractif pour les communications de serveur à serveur lorsque la connexion est sure ou peut être sécurisée d'une manière ou d'une autre. </p> <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">H2Direct on</pre> </div> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2earlyhint" id="h2earlyhint">Directive</a> <a nam <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute un en-tête de rép retour 103 Early Hints</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2EarlyHint <em>name</em> <em>v <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à parti Apache.</td></tr> </table> <p> La directive <code class="directive">H2EarlyHint</code> permet d'ajouter un en-tête de réponse avant le démarrage du traitement proprement dit de la requête. Les en-têtes de ce style sont consultables dans les réponses intermédiaires "103 Early Hints" et ils ont pour but principal d'envoyer des informations de "préchargement" aux navigateurs clients. </p><p> <em>name</em> et <em>value</em> doivent être des champs d'en-tête HTTP valables sous peine de provoquer des échecs de réponse. La directive <code class="directive">H2EarlyHints</code> doit encore être activée pour permettre l'envoi de réponses intermédiaires de code 103. Elle peut être répétée plusieurs fois et les champs d'en-tête de même nom s'ajoutent. </p> <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">H2EarlyHint Link "</ </div> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2earlyhints" id="h2earlyhints">Directive</a> <a n <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contrôle l'envoi de co <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2EarlyHints on|off</code>< <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>H2EarlyHints off</code></td></ <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à parti Apache.</td></tr> </table> <p> Cette directive permet de définir si les réponses intermédiaires contenant un code d'état HTTP 103 doivent être envoyées au client ou non. Par défaut ce n'est actuellement pas le cas car certains clients ont encore des problèmes avec les réponses intermédiaires inattendues. </p> <p> Lorsque cette directive est définie à <code>on</code>, les ressources PUSHées définie par la directive <code class="directive"><a href="#h2pushresource"> réponse intermédiaire 103 avant la réponse finale. Cette réponse 103 comporte des en-têtes <code>Link</code> qui provoquent le <code>préchargement</code> des ressources considérées. </p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2maxdataframelen" id="h2maxdataframelen">Dir <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximal d'oct <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2MaxDataFrameLen <em>n</em>< <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>H2MaxDataFrameLen 0</code></ <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à parti Apache.</td></tr> </table> <p> La directive <code class="directive">H2MaxDataFrameLen</code> permet de définir le nombre maximal d'octets du corps de réponse que l'on peut placer dans une seule trame HTTP/2 DATA. La valeur 0 signifie aucune limite (mais la taille maximale permise par le protocole est respectée). </p><p> Par défaut, le module essaie d'utiliser la taille maximale possible qui est d'environ 16 Ko. Il s'agit cependant de la taille maximale, et lorsque la taille des données de la réponse est inférieure, les trames envoyées sont plus courtes. </p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2maxheaderblocklen" id="h2maxheaderblocklen <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille maximale des e <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2MaxHeaderBlockLen <em>n</ <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>H2MaxHeaderBlockLen 0</cod <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à parti Apache.</td></tr> </table> <p> La directive <code class="directive">H2MaxHeaderBlockLen</code> permet de définir la taille maximale globale des en-têtes d’une réponse. Définir cette directive à 0 implique une taille maximale de 64 ko dans nghttp2, ce qui correspond à la valeur par défaut. </p> <p> Les réponses dont la somme des tailles de tous les en-têtes est supérieure à la valeur de cette directive ne seront pas traitées et provoqueront une réinitialisation du flux. </p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2maxsessionstreams" id="h2maxsessionstreams <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximal de flu <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2MaxSessionStreams <em>n</ <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>H2MaxSessionStreams 100</c <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> </table> <p> Cette directive permet de définir le nombre maximal de flux actifs par session (connexion) HTTP/2 accepté par le serveur. Selon la RFC 7540, un flux est considéré comme actif s'il n'est ni <code>en attente</code> ni <code>fermé</code>. </p> <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">H2MaxSessionStrea </div> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2maxworkeridleseconds" id="h2maxworkeridles <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximal de sec traitement h2 pourra rester inactive sans être arrêtée.</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2MaxWorkerIdleSeconds <e <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>H2MaxWorkerIdleSeconds 60 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></t <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> </table> <p> Cette directive permet de définir le nombre maximal de secondes pendant lequel une unité de traitement h2 pourra rester inactive avant de s'arrêter elle-même. Cet arrêt ne peut cependant se produire que si le nombre d'unités de traitement h2 dépasse <code class="directive"><a href="#h2minworkers">H2MinWorkers</a></code>. </p> <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">H2MaxWorkerIdleSe </div> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2maxworkers" id="h2maxworkers">Directive</a> <a n <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximal de thr enfant.</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2MaxWorkers <em>n</em></code>< <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></t <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> </table> <p> Cette directive permet de définir le nombre maximal de threads à lancer pour le traitement HTTP/2 de chaque processus enfant. Si cette directive n'est pas définie, <code class="module"><a href="../mod/mod_http2.html">mod_ choisira une valeur appropriée en fonction du module <code>mpm</code> utilisé. This directive sets the maximum number of worker threads to spawn per child process for HTTP/2 processing. If this directive is not used, <code>mod_http2</code> will chose a value suitable for the <code>mpm</code> module loaded. </p> <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">H2MaxWorkers 20</pr </div> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2minworkers" id="h2minworkers">Directive</a> <a n <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre minimal de thr enfant.</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2MinWorkers <em>n</em></code>< <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></t <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> </table> <p> Cette directive permet de définir le nombre minimal de threads à lancer pour le traitement HTTP/2 de chaque processus enfant. Si cette directive n'est pas définie, <code class="module"><a href="../mod/mod_http2.html">mod_ choisira une valeur appropriée en fonction du module <code>mpm</code> utilisé. </p> <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">H2MinWorkers 10</pr </div> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2moderntlsonly" id="h2moderntlsonly">Directi <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Impose les connexion seulement</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2ModernTLSOnly on|off</c <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>H2ModernTLSOnly on</code></t <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à parti Apache.</td></tr> </table> <p> Cette directive permet de définir si les vérifications de sécurité sur les connexions HTTP/2 doivent être exclusivement en mode TLS (https:). Elle peut être placée au niveau du serveur principal ou dans une section <code class="directive"><a href="../mod/core.html#virtualhos </p> <p> Les vérifications de sécurité nécessitent TLSv1.2 au minimum et l'absence de tout algorithme de chiffrement listé dans la RFC 7540, Appendix A. Ces vérifications seront étendues lorsque de nouveaux prérequis en matière de sécurité seront mis en place. </p> <p> Le nom provient des définitions Mozilla <a href="https://wiki.mozilla.org/Security/Server Side TLS</a> où il est question de "modern compatibility". Mozilla Firefox et d'autres navigateurs imposent la "modern compatibility" pour les connexions HTTP/2. Comme toute chose en matière de sécurité opérationnelle, c'est une cible mouvante susceptible d'évoluer dans le futur. </p> <p> Un des buts de ces vérifications dans <code class="module"><a href="../mod/mod_http2.html">mod ce niveau de sécurité pour toutes les connexions, et non seulement celles en provenance des navigateurs web. Un autre but est l'interdiction d'utiliser HTTP/2 en tant que protocole dans les négociations si les prérequis ne sont pas respectés. </p> <p> En fin de compte, la sécurité de la connexion TLS est déterminée par les directives de configuration du serveur pour <code class="module"><a href="../mod/mod_ </p> <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">H2ModernTLSOnly of </div> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2outputbuffering" id="h2outputbuffering">Dir <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contrôle la mise en tam <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2OutputBuffering on|off< <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>H2OutputBuffering on</code>< <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à parti Apache.</td></tr> </table> <p> La directive <code class="directive">H2OutputBuffering</code> permet de contrôler la mise en tampon du flux de sortie. La valeur par défaut est on, ce qui correspond au comportement des versions précédentes. Lorsqu'elle est à off, chaque octet est immédiatement disponible pour envoi au client via la connexion principale. Ceci permet de résoudre les problèmes d'inter-opérations avec certaines versions de gRPC. </p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2padding" id="h2padding">Directive</a> <a name="H <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie un intervall ajouter aux trames utiles</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2Padding <em>numbits</em></c <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>H2Padding 0</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à parti Apache.</td></tr> </table> <p> La valeur par défaut 0 indique qu'aucun octet de bourrage ne sera ajouté aux trames utiles comme HEADERS, DATA et PUSH_PROMISE. Ceci correspond au comportement des versions précédentes. Dans ce cas et sous certaines conditions, un observateur du trafic réseau pourra alors déterminer la longueur de ces trames dans le flux TLS. </p> <p> Si on attribue à numbits la valeur 1-8, un nombre aléatoire d'octets entre 0 et 2^numbits sont ajoutés à chaque trame. Une valeur aléatoire d'octets de bourrage est attribué indépendamment à chaque trame que le module renvoie au client. </p> <p> Pour améliorer la dissimulation de la longueur des trames, on peut augmenter le nombre moyen d'octets de bourrage, mais cela augmente d'autant le trafic réseau. Le nombre optimal d'octets de bourrage dépend donc du type de trafic web que le serveur engendre. </p> <p> La valeur par défaut de 0 (aucun octet de bourrage) a été choisie dans un but de compatibilité ascendante. Il peut en effet exister des installations où les octets de bourrage ne sont pas souhaités ou sont néfastes. La cause principale peut provenir d'un client dont l'implémentation comporte des erreurs. </p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2proxyrequests" id="h2proxyrequests">Directi <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active/Désactive les <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2ProxyRequests on|off</c <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>H2ProxyRequests off</code></ <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à parti Apache</td></tr> </table> <p> La directive <code class="directive">H2ProxyRequests</code> permet d'activer ou de désactiver la gestion des requêtes HTTP/2 dans un contexte de mandat direct. </p><p> Similaire à <code class="directive"><a href="../mod/proxy.html#proxyrequests">ProxyReques cette directive déclenche le traitement nécessaire des requêtes lorsque HTTP/2 est activé dans un contexte de mandat direct. </p><p> </p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2push" id="h2push">Directive</a> <a name="H2Push" <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Activation/désactiv <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2Push on|off</code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>H2Push on</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à parti Apache.</td></tr> </table> <p> Cette directive permet d'activer/désactiver l'utilisation de la fonctionnalité server push du protocole HTTP/2. </p> <p> Lorsqu'un client demande une ressource particulière, le protocole HTTP/2 permet au serveur de lui fournir des ressources supplémentaires. Ceci s'avère utile lorsque ces ressources sont reliées entre elles, ce qui peut laisser supposer que le client va probablement les demander dans un délai plus ou moins long. Le mécanisme de pushing permet alors au client d'économiser le temps qu'il lui aurait fallu pour demander ces ressources supplémentaires lui-même. Par contre, fournir au client des ressources dont il n'a pas besoin ou qu'il possède déjà constitue une perte de bande passante. </p> <p> Les server pushes sont détectés en inspectant les en-têtes <code>Link</code> des réponses (voir https://tools.ietf.org/html/rfc5988 pour la spécification). Lorsqu'un lien spécifié de cette manière possède l'attribut <code>rel=preload</code>, il est considéré comme devant faire l'objet d'un push. </p> <p> Les en-têtes link des réponses sont soit définis par l'application, soit configurés via <code class="directive"><a href="#h2pushresource">H2PushResource</a></code> ou <code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code> comme suit : </p> <div class="example"><h3>Exemple de configuration d'en-tête link via mod_headers</h3><pre class= Header add Link "</css/site.css>;rel=preload" Header add Link "</images/logo.jpg>;rel=preload" </Location></pre> </div> <p> Comme le montre l'exemple, il est possible d'ajouter autant d'en-têtes link que l'on souhaite à une réponse, ce qui déclenchera autant de pushes. Cette fonctionnalité doit donc être utilisée avec prudence car le module ne vérifie pas si une ressource n'a pas déjà été "pushée" vers un client. </p> <p> Les PUSH HTTP/2 sont activés par défaut. Vous pouvez activer/désactiver cette fonctionnalité pour toute connexion au serveur au niveau global ou serveur virtuel. Vous pouvez en outre désactiver PUSH pour un jeu de ressources dans une section Directory/Location. Notez que ceci permet de contrôler quelles ressources peuvent déclencher un PUSH, mais pas les ressources qui peuvent être envoyées via PUSH. </p> <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">H2Push off</pre> </div> <p> Enfin, il est important de savoir que les pushes ne se produisent que si le client en manifeste le désir ; la plupart des navigateurs le font, mais certains, comme Safari 9, ne le font pas. En outre, les pushes ne se produisent que pour les ressources de la même <em>autorité</em> que celle de la réponse originale. </p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2pushdiarysize" id="h2pushdiarysize">Directi <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille du journal des <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2PushDiarySize n</code></t <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>H2PushDiarySize 256</code></ <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à parti Apache.</td></tr> </table> <p> Cette directive permet de définir le nombre maximum de pushes qui seront enregistrés pour une connexion HTTP/2. Elle peut être placée dans une section <code class="directive"><a href="../mod/core.html#virtualhost"><Virt de pushes pour le serveur virtuel considéré. </p> <p> Le journal des pushes enregistre un condensé des ressources préchargées (leurs URLs) afin d'éviter les duplications de pushes pour une même connexion. Cependant, ces données ne sont pas conservées, et les clients qui ouvrent une nouvelle connexion se verront à nouveau affecter les mêmes pushes. </p> <p> Si la taille maximale est atteinte, les nouvelles entrées remplacent les plus anciennes. Une entrée du journal nécessitant 8 octets, un journal de 256 entrées consomme 2 Ko de mémoire. </p> <p> Si cette directive est définie à 0, le journal des pushes est désactivé. </p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2pushpriority" id="h2pushpriority">Directive< <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Priorité des pushes H2< <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2PushPriority <em>mime-ty <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>H2PushPriority * After 16</c <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à parti Apache. Nécessite la bibliothèque nghttp2 version 1.5.0 ou supérieure.</td></tr> </table> <p> Cette directive permet de définir une gestion de priorité des pushes en fonction du type de contenu de la réponse. Elle est en général définie au niveau du serveur principal, mais peut aussi l'être au niveau d'un serveur virtuel. </p> <p> Les pushes HTTP/2 sont toujours liés à une requête client. Chaque paire requête/réponse de cette sorte, ou <em>flux</em>, possède une dépendance et un poids qui définissent la <em>priorité</em> du flux. </p> <p> Lorsqu'un flux <em>dépend</em> d'un autre, disons X dépend de Y, alors Y reçoit toute la bande passante avant que X n'en reçoive ne serait-ce qu'une partie. Notez que cela ne signifie en rien que Y bloque X ; en effet, si Y n'a aucune donnée à envoyer, toute la bande passante qui lui est allouée peut être utilisée par X. </p> <p> Lorsque plusieurs flux dépendent d'un même autre flux, disons X1 et X2 dépendent tous deux de Y, le <em>poids</em> détermine la bande passante allouée. Ainsi, si X1 et X2 possèdent le même poids, ils recevront tous deux la moitié de la bande passante disponible. Si le poids de X1 est égal au double de celui de X2, X1 recevra une bande passante double de celle de X2. </p> <p> En fin de compte, tout flux dépend du flux <em>racine</em> qui reçoit toute la bande passante disponible mais n'envoie jamais de données. Cette bande passante est ainsi répartie entre les flux enfants selon leur poids. Ces derniers l'utilisent alors pour envoyer leurs données ou pour la répartir entre leurs propres flux enfants, et ainsi de suite. Si aucun des flux enfants n'a de données à envoyer, la bande passante est attribuée à d'autres flux selon les mêmes règles. </p> <p> Ce système de priorités a été conçu de façon a toujours pouvoir utiliser la bande passante disponible tout en définissant des priorités et en attribuant des poids aux différents flux. Ainsi, tous les flux sont en général initialisés par le client qui lui-même définit les priorités. </p> <p> Seul le fait de savoir qu'un flux implique un PUSH permet au serveur de décider quelle est la priorité <em>initiale</em> d'un tel flux. Dans les exemples ci-dessous, X est le flux client. Il dépend de Y et le serveur décide de "PUSHer" les flux P1 et P2 sur X. </p> <p> La règle de priorité par défaut est : </p> <div class="example"><h3>Règle de priorité par défaut</h3><pre class="prettyprint lang-config">H2P </div> <p> Elle peut se traduire par "Envoyer un flux PUSH avec tout type de contenu et dépendant du flux client avec le poids 16". P1 et P2 seront alors envoyés après X, et comme leurs poids sont identiques, il se verront allouer la même quantité de bande passante. </p> <div class="example"><h3>Règle de priorité entrelacée</h3><pre class="prettyprint lang-config">H2 </div> <p> Ce qui peut se traduire par "Envoyer toute ressource CSS dans la même dépendance et avec le même poids que le flux client". Si le type de contenu de P1 est "text/css", il dépendra de Y (comme X) et son poids effectif sera calculé selon la formule : <code>P1ew = Xw * (P1w / 256)</code>. Si P1w est de 256, Le poids effectif de P1 sera le même que celui de X. Si X et P1 ont des données à envoyer, il se verront allouer la même quantité de bande passante. </p> <p> Avec un Pw de 512, un flux entrelacé et PUSHé aura un poids double de celui de X. Avec un poids de 128, son poids ne sera que la moitié de celui de X. Notez que les poids effectifs sont toujours plafonnés à 256. </p> <div class="example"><h3>Règle de priorité Before</h3><pre class="prettyprint lang-config">H2Pus </div> <p> Dans cet exemple, tout flux PUSHé dont le contenu est de type 'application/json' sera envoyé <em>avant</em> X, ce qui rend P1 dépendant de Y et X dépendant de P1. Ainsi, X sera mis en attente aussi longtemps que P1 aura des données à envoyer. Le poids effectif est hérité du flux client, et l'attribution d'un poids spécifique n'est pas autorisée. </p> <p> Vous devez garder à l'esprit que les spécifications en matière de priorités sont limitées par les ressources disponibles du serveur. Si un serveur ne dispose d'aucun processus/thread de travail pour les flux PUSHés, les données du flux considéré ne seront envoyées que lorsque les autres flux auront terminé l'envoi des leurs. </p> <p> Enfin et surtout, il convient de tenir compte de certaines particularités de la syntaxe de cette directive : </p> <ol> <li>'*' est la seule expression permettant de remplacer tout type de contenu. 'image/*' ne fonctionnera pas.</li> <li>La dépendance par défaut est 'After'.</li> <li>Il existe aussi des poids par défaut : pour 'After' le poids est de 16, alors que pour 'interleaved' il est de 256. </li> </ol> <div class="example"><h3>Exemples de règles</h3><pre class="prettyprint lang-config">H2PushPri H2PushPriority image/jpeg before # poid hérité H2PushPriority text/css interleaved # poids de 256 par défaut</pre> </div> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2pushresource" id="h2pushresource">Directive< <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare des ressource <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2PushResource [add] <em>pa <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à parti Apache.</td></tr> </table> <p> Lorsqu'il sont activés pour un répertoire, les PUSHes HTTP/2 seront tentés pour tous les chemins ajoutés via cette directive. Cette dernière peut être utilisée plusieurs fois pour le même répertoire. </p> <p> Cette directive propose des ressources beaucoup plus tôt que les en-têtes <code>Link</code> de <code class="module"><a href="../mod/mod_headers.html">mod_heade <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> présente ces ressour une réponse intermédiaire <code>103 Early Hints</code>. Ceci implique que les clients qui ne supportent pas PUSH recevront quand-même rapidement des propositions de préchargement. </p> <p> A la différence de la définition d'en-têtes de réponse <code>Link</code> via <code class="module"><a href="../mod/mod_headers.html">mod_headers</a></c directive n'aura d'effet que pour les connexions HTTP/2. </p> <p> En ajoutant l'option <code>critical</code> à une telle ressource, le serveur la traitera prioritairement, et une fois les données disponibles, ces dernières seront envoyées avant les données de la requête principale. </p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2serializeheaders" id="h2serializeheaders">D <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active/désactive la sé requêtes/réponses</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2SerializeHeaders on|of <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>H2SerializeHeaders off</co <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> </table> <p> Cette directive permet de définir si les requêtes HTTP/2 doivent être sérialisées au format HTTP/1.1 pour être traitées par le noyau de <code>httpd</code>, ou si les données binaires reçues doivent être passées directement aux <code>request_rec</code>s. </p> <p> La sérialisation dégrade les performances, mais garantit une meilleure compatibilité ascendante lorsque des filtres ou programmes accroche personnalisés en ont besoin. </p> <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">H2SerializeHeader </div> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2streammaxmemsize" id="h2streammaxmemsize">D <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Quantité maximale de d flux.</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2StreamMaxMemSize <em>byt <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>H2StreamMaxMemSize 65536</ <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> </table> <p> Cette directive permet de définir la quantité maximale de données en sortie mises en tampon mémoire pour un flux actif. Ce tampon mémoire n'est pas alloué pour chaque flux en tant que tel. Les quantités de mémoire sont définies en fonction de cette limite lorsqu'elles sont sur le point d'être allouées. Le flux s'arrête lorsque la limite a été atteinte, et ne reprendra que lorsque les données du tampon auront été transmises au client. </p> <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">H2StreamMaxMemSiz </div> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2streamtimeout" id="h2streamtimeout">Directi <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Temps d'attente maxi données pour le traitement d'un flux</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2StreamTimeout <var>time- <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>La valeur de la directive <cod <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à parti Apache.</td></tr> </table> <p> <code class="directive">H2StreamTimeout</code> permet de spécifier le temps maximum pendant lequel un flux en cours de traitement attendra pour l'envoi/réception de ses données. </p> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="h2tlscooldownsecs" id="h2tlscooldownsecs">Dir <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Durée d'inactivité d'u la taille des paquets</td></tr> <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2TLSCoolDownSecs <em>seco <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>H2TLSCoolDownSecs 1</code></ <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serv <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_http2</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à parti Apache.</td></tr> </table> <p> Cette directive permet de spécifier le nombre de secondes avant lequel une connexion TLS inactive va diminuer la taille des paquets de données à une valeur inférieure (~1300 octets). Elle peut être définie au niveau du serveur principal ou pour un <code class="directive"><a href="../mod/core.html#serveur virtuel"><serveur virtuel></a></code> spécifique. </p> <p> Voir la directive <code class="directive"><a href="#h2tlswarmupsize">H2TLSWarmUpSize</a></co du "préchauffage" de TLS. La directive <code class="directive">H2TLSCoolDownSecs</code> met en lumière le fait que les connexions peuvent se détériorer au bout d'un certain temps (et au fur et à mesure des corrections du flux TCP), et cela même si elle sont inactives. Pour ne pas --> -------------------- --> maximum size reached --> -------------------- [ 0.106Quellennavigators ] |
2026-04-02