1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
|
<?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>mod_http2 - Serveur Apache HTTP Version 2.5</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script 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/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur Apache HTTP Version 2.5</p>
<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.5</a> > <a href="./">Modules</a></div>
<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="alternate" title="English"> en </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>Support de la couche transport HTTP/2</td></tr>
<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_module</td></tr>
<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 la version 2.4.17 du serveur
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 7540</a>) au serveur HTTP
Apache.</p>
<p>Il s'appuie sur la biblioth�que <a href="http://nghttp2.org/">libnghttp2</a> pour impl�menter le
moteur de base http/2.</p>
<div class="warning"><h3>Avertissement</h3>
<p>Ce module en est au stade exp�rimental. Ses comportements,
directives et valeurs par d�faut sont susceptibles d'�voluer
au fur et � mesure de la parution de ses futures diff�rentes
versions en relation avec les autres modules standards. Les
utilisateurs sont fortement encourag�s � consulter le fichier
"CHANGES" pour les �ventuelles mises � jour.</p>
</div>
<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 href="https://http2.github.io/faq/#does-http2-require-encryption">n'imposant
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>.</p>
</div>
<div id="quickview"><h3>Sujets</h3>
<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="#h2earlyhints">H2EarlyHints</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#h2maxsessionstreams">H2MaxSessionStreams</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#h2maxworkeridleseconds">H2MaxWorkerIdleSeconds</a></li>
<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="#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">H2SerializeHeaders</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#h2streammaxmemsize">H2StreamMaxMemSize</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#h2tlscooldownsecs">H2TLSCoolDownSecs</a></li>
<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="#h2windowsize">H2WindowSize</a></li>
</ul>
<h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_http2">Probl�mes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_http2">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
<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><a title="Lien permanent" href="#how-it-works" class="permalink">¶</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�me, ils ne seront pas
pris en compte par les directives du style <code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code>. Par contre, ils
utilisent par d�faut la valeur de <code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code> si vous n'avez pas
sp�cifi� d'autres valeurs via <code class="directive"><a href="#h2minworkers">H2MinWorkers</a></code> et <code class="directive"><a href="#h2maxworkers">H2MaxWorkers</a></code>.
</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="#h2maxsessionstreams">H2MaxSessionStreams</a></code>, <code class="directive"><a href="#h2windowsize">H2WindowSize</a></code> et <code class="directive"><a href="#h2streammaxmemsize">H2StreamMaxMemSize</a></code>.
</p>
<p>
La directive <code class="directive"><a href="#h2maxsessionstreams">H2MaxSessionStreams</a></code> permet de limiter
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">H2StreamMaxMemSize</a></code> permet de d�finir
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 name="H2CopyFiles" id="H2CopyFiles">H2CopyFiles</a><a title="Lien permanent" href="#h2copyfiles" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contr�le la gestion des fichiers dans les r�ponses</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2CopyFiles on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>H2CopyFiles off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<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 � partir de la version 2.4.24 du serveur HTTP
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> est probablement
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="H2Direct" id="H2Direct">H2Direct</a><a title="Lien permanent" href="#h2direct" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Activation du protocole H2 Direct</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2Direct on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>H2Direct on pour h2c, off pour le protocole h2</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>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"><VirtualHost></a></code> afin d'activer la
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>, la recherche d'un en-t�te HTTP/2 n'est
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="h2earlyhints" id="h2earlyhints">Directive</a> <a name="H2EarlyHints" id="H2EarlyHints">H2EarlyHints</a><a title="Lien permanent" href="#h2earlyhints" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contr�le l'envoi de codes d'�tat 103</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2EarlyHints on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>H2EarlyHints off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>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 � partir de la version 2.4.24 du serveur HTTP
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>H2PushResource</code> d�clenchent une 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="h2maxsessionstreams" id="h2maxsessionstreams">Directive</a> <a name="H2MaxSessionStreams" id="H2MaxSessionStreams">H2MaxSessionStreams</a><a title="Lien permanent" href="#h2maxsessionstreams" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximal de flux actifs par session HTTP/2.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2MaxSessionStreams <em>n</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>H2MaxSessionStreams 100</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>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">H2MaxSessionStreams 20</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="h2maxworkeridleseconds" id="h2maxworkeridleseconds">Directive</a> <a name="H2MaxWorkerIdleSeconds" id="H2MaxWorkerIdleSeconds">H2MaxWorkerIdleSeconds</a><a title="Lien permanent" href="#h2maxworkeridleseconds" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximal de secondes pendant lequel une unit� de
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 <em>n</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>H2MaxWorkerIdleSeconds 600</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
<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">H2MaxWorkerIdleSeconds 20</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="h2maxworkers" id="h2maxworkers">Directive</a> <a name="H2MaxWorkers" id="H2MaxWorkers">H2MaxWorkers</a><a title="Lien permanent" href="#h2maxworkers" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximal de threads � utiliser pour chaque processus
enfant.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2MaxWorkers <em>n</em></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
<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_http2</a></code>
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</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="h2minworkers" id="h2minworkers">Directive</a> <a name="H2MinWorkers" id="H2MinWorkers">H2MinWorkers</a><a title="Lien permanent" href="#h2minworkers" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre minimal de threads � utiliser pour chaque processus
enfant.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2MinWorkers <em>n</em></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
<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_http2</a></code>
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</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="h2moderntlsonly" id="h2moderntlsonly">Directive</a> <a name="H2ModernTLSOnly" id="H2ModernTLSOnly">H2ModernTLSOnly</a><a title="Lien permanent" href="#h2moderntlsonly" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Impose les connexions HTTP/2 en mode "TLS moderne"
seulement</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2ModernTLSOnly on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>H2ModernTLSOnly on</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>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 � partir de la version 2.4.18 du serveur HTTP
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#virtualhost"><VirtualHost></a></code>.
</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">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_http2</a></code> tend � imposer
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_ssl.html">mod_ssl</a></code>.
</p>
<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">H2ModernTLSOnly off</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="h2push" id="h2push">Directive</a> <a name="H2Push" id="H2Push">H2Push</a><a title="Lien permanent" href="#h2push" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Activation/d�sactivation du server push H2</td></tr>
<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 du serveur, serveur virtuel</td></tr>
<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 � partir de la version 2.4.18 du serveur HTTP
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="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="prettyprint lang-config"><Location /index.html>
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 server pushes HTTP/2 sont activ�s par d�faut. Cette
directive permet de d�sactiver cette fonctionnalit� pour
le serveur virtuel ou non consid�r�.
</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">Directive</a> <a name="H2PushDiarySize" id="H2PushDiarySize">H2PushDiarySize</a><a title="Lien permanent" href="#h2pushdiarysize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille du journal des Pushes H2</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2PushDiarySize n</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>H2PushDiarySize 256</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>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 � partir de la version 2.4.19 du serveur HTTP
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"><VirtualHost></a></code> afin de d�finir le nombre
de pushes pour le serveur virtuel consid�r�.
</p>
<p>
Le journal des pushes enregistre un condens� (sous la forme d'un
nombre de 64 bits) 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. A ce titre, une �tude est en cours pour permettre
au client de supprimer le condens� des ressources qu'il poss�de
d�j�, et par l�-m�me de r�initialiser le journal des pushes �
chaque nouvelle connexion.
</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</a> <a name="H2PushPriority" id="H2PushPriority">H2PushPriority</a><a title="Lien permanent" href="#h2pushpriority" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Priorit� des pushes H2</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2PushPriority mime-type [after|before|interleaved] [weight]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>H2PushPriority * After 16</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>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 � partir de la version 2.4.18 du serveur HTTP
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">H2PushPriority * After 16</pre>
</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">H2PushPriority text/css Interleaved 256</pre>
</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">H2PushPriority application/json Before</pre>
</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">H2PushPriority application/json 32 # une r�gle de priorit� 'After'
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</a> <a name="H2PushResource" id="H2PushResource">H2PushResource</a><a title="Lien permanent" href="#h2pushresource" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�clare des ressources � proposer ("pusher") au client</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2PushResource [add] path [critical]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<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 � partir de la version 2.4.24 du serveur HTTP
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_headers</a></code>.
<code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> pr�sente ces ressources au client via
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></code>, cette
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">Directive</a> <a name="H2SerializeHeaders" id="H2SerializeHeaders">H2SerializeHeaders</a><a title="Lien permanent" href="#h2serializeheaders" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active/d�sactive la s�rialisation du traitement des
requ�tes/r�ponses</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2SerializeHeaders on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>H2SerializeHeaders off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>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">H2SerializeHeaders 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="h2streammaxmemsize" id="h2streammaxmemsize">Directive</a> <a name="H2StreamMaxMemSize" id="H2StreamMaxMemSize">H2StreamMaxMemSize</a><a title="Lien permanent" href="#h2streammaxmemsize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Quantit� maximale de donn�es en sortie mises en tampon par
flux.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2StreamMaxMemSize <em>bytes</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>H2StreamMaxMemSize 65536</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>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">H2StreamMaxMemSize 128000</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="h2tlscooldownsecs" id="h2tlscooldownsecs">Directive</a> <a name="H2TLSCoolDownSecs" id="H2TLSCoolDownSecs">H2TLSCoolDownSecs</a><a title="Lien permanent" href="#h2tlscooldownsecs" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td /></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2TLSCoolDownSecs <em>seconds</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>H2TLSCoolDownSecs 1</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>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 � partir de la version 2.4.18 du serveur HTTP
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></code> pour une description
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
d�t�riorer les performances d'une mani�re g�n�rale, il est par
cons�quent pr�f�rable de revenir � la phase de pr�chauffage
lorsqu'aucune donn�e n'a �t� transmise pendant un certain nombre
de secondes.
</p>
<p>
Dans les situations o� les connexions peuvent �tre consid�r�es
comme fiables, ce d�lai peut �tre d�sactiv� en d�finissant cette
directive � 0.
</p>
<p>
Dans l'exemple suivant, la directive est d�finie � 0, ce qui
d�sactive tout retour � une phase de pr�chauffage des connexions
TLS. Les connexions TLS d�j� pr�chauff�es conservent donc toujours
leur taille de paquet de donn�es maximale.
</p>
<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">H2TLSCoolDownSecs 0</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="h2tlswarmupsize" id="h2tlswarmupsize">Directive</a> <a name="H2TLSWarmUpSize" id="H2TLSWarmUpSize">H2TLSWarmUpSize</a><a title="Lien permanent" href="#h2tlswarmupsize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td /></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2TLSWarmUpSize <em>amount</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>H2TLSWarmUpSize 1048576</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>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 � partir de la version 2.4.18 du serveur HTTP
Apache.</td></tr>
</table>
<p>
Cette directive permet de d�finir le nombre d'octets � envoyer
dans les petits enregistrements TLS (~1300 octets) avant
d'atteindre leur taille maximale de 16 ko pour les connexions
https: HTTP/2. Elle peut �tre d�finie au niveau du serveur
principal ou pour des <code class="directive"><a href="../mod/core.html#serveurs virtuels"><Serveurs virtuels></a></code> sp�cifiques.
</p>
<p>
Les mesures effectu�es par les <a href="https://www.igvita.com">laboratoires de performances de
Google</a> montrent que les meilleurs performances sont atteintes
pour les connexions TLS si la taille initiale des
enregistrements reste en de�a du niveau du MTU afin de permettre
� la totatlit� d'un enregistrement d'entrer dans un paquet IP.
</p>
<p>
Comme TCP ajuste son contr�le de flux et sa taille de fen�tre,
des enregistrements TLS trop longs peuvent rester en file
d'attente ou m�me �tre perdus et devoir alors �tre r��mis. Ceci
est bien entendu vrai pour tous les paquets ; cependant, TLS a
besoin de la totalit� de l'enregistrement pour pouvoir le
d�chiffrer. Tout octet manquant rendra impossible l'utilisation
de ceux qui ont �t� re�us.
</p>
<p>
Lorqu'un nombre suffisant d'octets a �t� transmis avec succ�s,
la connexion TCP est stable, et la taille maximale (16 ko) des
enregistrements TLS peut �tre utilis�e pour des performances
optimales.
</p>
<p>
Dans les architectures o� les serveurs sont atteints par des
machines locales ou pour les connexions de confiance seulement,
la valeur de cette directive peut �tre d�finie � 0, ce qui a
pour effet de d�sactiver la "phase de chauffage".
</p>
<p>
Dans l'exemple suivant, la phase de chauffage est effectivement
d�sactiv�e en d�finissant la directive � 0.
</p>
<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">H2TLSWarmUpSize 0</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="h2upgrade" id="h2upgrade">Directive</a> <a name="H2Upgrade" id="H2Upgrade">H2Upgrade</a><a title="Lien permanent" href="#h2upgrade" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Activation/D�sactivation du protocole de mise � jour H2</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2Upgrade on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>H2Upgrade on pour h2c, off pour h2</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>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 de la
m�thode de mise � jour pour passer de HTTP/1.1 � HTTP/2. Elle
doit �tre plac�e dans une section <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> afin d'activer la mise �
jour vers HTTP/2 pour le serveur virtuel consid�r�.
</p>
<p>
Cette m�thode de changement de protocole est d�finie dans
HTTP/1.1 et utilise l'en-t�te "Upgrade" (d'o� son nom) pour
indiquer l'intention d'utiliser un autre protocole. Cet en-t�te
peut �tre pr�sent dans toute requ�te sur une connexion HTTP/1.1.
</p>
<p>
Elle activ�e par d�faut pour les transmissions en clair
(h2c), et d�sactiv�e avec TLS (h2), comme pr�conis� par la RFC
7540.
</p>
<p>
Sachez cependant que les mises � jour ne sont accept�es que pour
les requ�tes qui ne poss�dent pas de corps. Le requ�tes de type
POST et PUT avec un contenu ne feront jamais l'objet d'une mise
� jour vers HTTP/2. Se r�f�rer � la documentation de la
directive <code class="directive"><a href="#h2direct">H2Direct</a></code> pour
envisager une alternative � Upgrade.
</p>
<p>
Cette directive n'a d'effet que si h2 ou h2c est activ� via la
directive <code class="directive"><a href="../mod/core.html#protocols">Protocols</a></code>.
</p>
<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">H2Upgrade 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="h2windowsize" id="h2windowsize">Directive</a> <a name="H2WindowSize" id="H2WindowSize">H2WindowSize</a><a title="Lien permanent" href="#h2windowsize" class="permalink">¶</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille maximale des paquets de donn�es pour les transmissions client
vers serveur.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>H2WindowSize <em>bytes</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>H2WindowSize 65535</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>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 taille maximale des paquets
de donn�es envoy�s par le client au serveur, et
limite la quantit� de donn�es que le serveur doit mettre en
tampon. Le client arr�tera d'envoyer des donn�es sur un flux
lorsque cette limite sera atteinte jusqu'� ce que le serveur
indique qu'il dispose d'un espace suffisant (car il aura trait�
une partie des donn�es).
</p><p>
Cette limite n'affecte que les corps de requ�tes, non les
m�tadonn�es comme les en-t�tes. Par contre, elle n'affecte pas
les corps de r�ponses car la taille maximale de ces derniers est
g�r�e au niveau des clients.
</p>
<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">H2WindowSize 128000</pre>
</div>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_http2.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/mod/mod_http2.html" title="Fran�ais"> fr </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/trunk/mod/mod_http2.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 2018 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html>
|
