1 <?xml version="1.0" encoding="ISO-8859-1" ?>
2 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
3 <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
4 <!-- French translation : Lucien GENTIS -->
5 <!-- Reviewed by : Vincent Deffontaines -->
6 <!-- English Revision: 1708515 -->
9 Licensed to the Apache Software Foundation (ASF) under one or more
10 contributor license agreements. See the NOTICE file distributed with
11 this work for additional information regarding copyright ownership.
12 The ASF licenses this file to You under the Apache License, Version 2.0
13 (the "License"); you may not use this file except in compliance with
14 the License. You may obtain a copy of the License at
16 http://www.apache.org/licenses/LICENSE-2.0
18 Unless required by applicable law or agreed to in writing, software
19 distributed under the License is distributed on an "AS IS" BASIS,
20 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21 See the License for the specific language governing permissions and
22 limitations under the License.
25 <manualpage metafile="new_features_2_4.xml.meta">
27 <title>Vue d'ensemble des nouvelles fonctionnalités de la version 2.4 du
28 serveur HTTP Apache</title>
31 <p>Ce document décrit les modifications majeures apportées par
32 la version 2.4 du serveur HTTP Apache. Pour les nouvelles fonctionnalités
33 ajoutées par la version 2.2, se référer au document
34 <a href="new_features_2_2.html">Nouvelles fonctionnalités
35 de la version 2.2</a>.</p>
39 <title>Améliorations du noyau</title>
41 <dt>Modules multiprocessus (MPMs) chargeables à l'exécution</dt>
42 <dd>Plusieurs MPMs peuvent maintenant être <a
43 href="mpm.html#dynamic">compilés en tant que modules
44 chargeables</a>. Le choix du MPM à utiliser s'effectue
45 à l'exécution via la directive <directive
46 module="mod_so">LoadModule</directive>.</dd>
49 <dd>Le <a href="mod/event.html">MPM Event</a> n'en est plus au stade expérimental et est
50 maintenant pleinement supporté.</dd>
52 <dt>Support du mode asynchrone</dt>
53 <dd>Le support des lectures/écritures asynchrones pour les MPMs et
54 les plateformes qui l'implémentent a été amélioré.</dd>
56 <dt>Configuration du niveau de journalisation (LogLevel) par
57 module et par répertoire</dt>
58 <dd>La directive <directive module="core">LogLevel</directive>
59 peut maintenant être définie par module et par répertoire. Les
60 nouveaux niveaux <code>trace1</code> à <code>trace8</code> ont été
61 ajoutés au dessus du niveau de journalisation <code>debug</code>.</dd>
63 <dt>Sections de configuration au niveau requête</dt>
64 <dd>Les sections <directive module="core">If</directive>,
65 <directive module="core" type="section">ElseIf</directive> et
66 <directive module="core" type="section">Else</directive>
67 permettent de définir une configuration en fonction de critères
68 liés à la requête.</dd>
70 <dt>Interpréteur d'expressions à usage général</dt>
71 <dd>Un nouvel interpréteur d'expressions permet de spécifier des
72 <a href="expr.html">conditions complexes</a> via des directives à
73 syntaxe commune comme <directive
74 module="mod_setenvif">SetEnvIfExpr</directive>, <directive
75 module="mod_rewrite">RewriteCond</directive>, <directive
76 module="mod_headers">Header</directive>,
77 <directive module="core" type="section">If</directive>, etc...
80 <dt>KeepAliveTimeout en millisecondes</dt>
81 <dd>Il est maintenant possible de définir la directive <directive
82 module="core">KeepAliveTimeout</directive> en millisecondes.
85 <dt>Directive NameVirtualHost</dt>
86 <dd>Cette directive n'est plus nécessaire et est maintenant obsolète.</dd>
88 <dt>Directives autorisées dans les fichiers <code>.htaccess</code></dt>
89 <dd>La nouvelle directive <directive
90 module="core">AllowOverrideList</directive> permet de contrôler de
91 manière plus précise la liste des directives autorisées dans les
92 fichiers <code>.htaccess</code>.</dd>
94 <dt>Variables dans les fichiers de configuration</dt>
95 <dd>La directive <directive module="core">Define</directive>
96 permet de définir des variables dans les fichiers de
97 configuration, améliorant ainsi la clareté de la présentation si
98 la même valeur est utilisée en plusieurs points de la
102 <dt>Diminution de la mémoire utilisée</dt>
103 <dd>Bien qu'elle propose de nombreuses nouvelles fonctionnalités,
104 la version 2.4.x tend à utiliser moins de mémoire que la version
110 <section id="newmods">
111 <title>Nouveau modules</title>
114 <dt><module>mod_proxy_fcgi</module></dt>
115 <dd>Mise à disposition du protocole FastCGI pour
116 <module>mod_proxy</module>.</dd>
118 <dt><module>mod_proxy_scgi</module></dt>
119 <dd>Mise à disposition du protocole SCGI pour
120 <module>mod_proxy</module>.</dd>
122 <dt><module>mod_proxy_express</module></dt>
123 <dd>Ajoute à <module>mod_proxy</module> la configuration dynamique
124 de mandataires inverses en masse.</dd>
126 <dt><module>mod_remoteip</module></dt>
127 <dd>Remplace l'adresse IP distante et le nom d'hôte apparents du
128 client pour la requête courante par la liste d'adresses IP
129 présentée par un mandataire ou un répartiteur de charge via les
130 en-têtes de la requête.</dd>
132 <dt><module>mod_heartmonitor</module>,
133 <module>mod_lbmethod_heartbeat</module></dt>
134 <dd>Permet à <module>mod_proxy_balancer</module> de répartir la
135 charge en fonction du nombre de connexions actives sur les
136 serveurs d'arrière-plan.</dd>
138 <dt><module>mod_proxy_html</module></dt>
139 <dd>Anciennement module tiers, il supporte la correction des liens
140 HTML dans une situation de mandat inverse, où le serveur
141 d'arrière-plan génère des URLs qui ne sont pas valides du point de
142 vue des clients du mandataire.</dd>
144 <dt><module>mod_sed</module></dt>
145 <dd>Une amélioration de <module>mod_substitute</module> qui permet
146 d'éditer le corps de la réponse avec toute la puissance de la
149 <dt><module>mod_auth_form</module></dt>
150 <dd>Implémente une authentification à base de formulaire.</dd>
152 <dt><module>mod_session</module></dt>
153 <dd>Permet de conserver les données de sessions des clients sous
154 forme de cookies ou dans une base de données.</dd>
156 <dt><module>mod_allowmethods</module></dt>
157 <dd>Permet de restreindre l'utilisation de
158 certaines méthodes HTTP sans interférer avec l'authentification et
161 <dt><module>mod_lua</module></dt>
162 <dd>Embarque le langage <a href="http://www.lua.org/">Lua</a> dans
163 httpd pour la configuration et les fonctions logiques courantes
164 (Expérimental).</dd>
166 <dt><module>mod_log_debug</module></dt>
167 <dd>Permet d'introduire une journalisation personnalisée à
168 différentes phases du traitement de la requête.</dd>
170 <dt><module>mod_buffer</module></dt>
171 <dd>Fournit un tampon pour les piles des filtres en entrée et en
174 <dt><module>mod_data</module></dt>
175 <dd>Convertit un corps de réponse en URL de type données RFC2397.</dd>
177 <dt><module>mod_ratelimit</module></dt>
178 <dd>Permet de limiter la bande passante pour certains
181 <dt><module>mod_request</module></dt>
182 <dd>Fournit des filtres permettant de gérer et de mettre à
183 disposition les corps des requêtes HTTP.</dd>
185 <dt><module>mod_reflector</module></dt>
186 <dd>Permet de renvoyer comme réponse le corps de la requête via la
187 pile du filtre de sortie.</dd>
189 <dt><module>mod_slotmem_shm</module></dt>
190 <dd>Met à disposition un fournisseur de mémoire partagée à base de
191 slots (du style tableau de bord).</dd>
193 <dt><module>mod_xml2enc</module></dt>
194 <dd>Anciennement module tiers, il supporte l'internationalisation
195 dans les modules de filtrage basés sur libxml2 (support du
198 <dt><module>mod_macro</module> (disponible à partir de la version 2.4.5)</dt>
199 <dd>Permet d'utiliser des macros au sein des fichiers de
202 <dt><module>mod_proxy_wstunnel</module> (disponible à partir de la version 2.4.5)</dt>
203 <dd>Support des tunnels web-socket.</dd>
205 <dt><module>mod_authnz_fcgi</module> (disponible à partir de la version 2.4.10)</dt>
206 <dd>Permet aux applications d'autorisation FastCGI d'authentifier
207 et/ou autoriser les clients.</dd>
209 <dt><module>mod_http2</module> (disponible à partir de la
211 <dd>Support de la couche transport HTTP/2.</dd>
216 <section id="module">
217 <title>Améliorations des modules</title>
219 <dt><module>mod_ssl</module></dt>
221 <dd><module>mod_ssl</module> peut maintenant vérifier la
222 validité des certificats clients en se connectant à
223 un serveur OCSP. Il est possible de définir un
224 répondeur par défaut, et de choisir si l'on
225 préfère le répondeur désigné
226 dans le certificat client.</dd>
228 <dd>En outre, <module>mod_ssl</module> supporte maintenant
229 l'estampillage OCSP (OCSP stapling), qui permet au serveur
230 d'attester la validité de son certificat auprès du client au
231 cours de la phase de négociation de la connexion.</dd>
233 <dd>Enfin, <module>mod_ssl</module> peut maintenant être configuré pour
234 que celui-ci partage les données de session SSL entre les serveurs
237 <dd>Le support des clés EC a été ajouté à celui des clés RSA et
240 <dd>Support de TLS-SRP (disponible à partir de la version 2.4.4).</dd>
242 <dt><module>mod_proxy</module></dt>
244 <dd>La directive <directive
245 module="mod_proxy">ProxyPass</directive> est maintenant configurée
246 de manière optimale dans les sections <directive
247 module="core">Location</directive> ou <directive
248 module="core">LocationMatch</directive>, et offre un gain de
249 performances important par rapport à la syntaxe traditionnelle à
250 deux paramètres lorsqu'elle est présente en grand nombre.</dd>
252 <dd>Il est maintenant possible de configurer l'adresse source dans
253 les requêtes mandatées.</dd>
255 <dd>Support des sockets de type Unix vers le serveur
256 d'arrière-plan (disponible à partir de la version 2.4.7).</dd>
258 <dt><module>mod_proxy_balancer</module></dt>
260 <dd>Le gestionnaire de répartition de charge propose de nouvelles
261 fonctionnalités. Ainsi, les possibilités de configuration des
262 membres du groupe de répartition de charge pendant l'exécution ont
263 été améliorées (possibilité d'ajout d'un membre supplémentaire).</dd>
265 <dd>Configuration à l'exécution d'un sous-ensemble de paramètres
266 de répartition de charge.</dd>
268 <dd>Les membres du groupe de répartition peuvent être définis à
269 'Drain' de façon à ce qu'ils ne répondent qu'aux sessions
270 persistantes existantes, ce qui permet de les mettre hors ligne en
273 <dd>Les règlages du répartiteur de charge peuvent être rendus
274 persistants après redémarrage.</dd>
276 <dt><module>mod_cache</module></dt>
278 <dd>Le filtre CACHE du module <module>mod_cache</module> peut être
279 inséré à un certain point de la chaîne de filtrage pour contrôler
280 plus finement la mise en cache.
283 <dd><module>mod_cache</module> peut maintenant mettre en cache des
284 requêtes HEAD.</dd>
286 <dd>Chaque fois que cela est possible, les directives de
287 <module>mod_cache</module> peuvent maintenant être définies au
288 niveau du répertoire, et non plus seulement au niveau du serveur
291 <dd>L'URL de base des URLs en cache peut être personnalisée de
292 façon à ce qu'un cluster de caches puisse partager le même préfixe
295 <dd><module>mod_cache</module> peut maintenant servir du contenu
296 non mis à jour lorsqu'un serveur d'arrière-plan n'est pas
297 disponible (erreur 5xx).</dd>
299 <dd><module>mod_cache</module> peut maintenant insérer
300 HIT/MISS/REVALIDATE dans un en-tête X-Cache.</dd>
302 <dt><module>mod_include</module></dt>
303 <dd>Support de l'attribut 'onerror' dans un élément 'include',
304 permettant de renvoyer un message d'erreur personnalisé à la place
305 du message d'erreur par défaut.</dd>
307 <dt><module>mod_cgi</module>, <module>mod_include</module>,
308 <module>mod_isapi</module>, ...</dt>
309 <dd>La traduction des en-têtes en variables d'environnement est
310 plus stricte qu'avant, ce qui permet de diminuer l'exposition aux attaques
311 de type cross-site-scripting via injection d'en-têtes. Les
312 en-têtes contenant des caractères invalides (comme les caractères
313 de soulignement) sont maintenant ignorés. Le document <a
314 href="env.html">Les variables d'environnement dans Apache</a>
315 présente quelques pistes pour contourner ce problème avec les
316 clients anciens qui nécessitent de tels en-têtes (Ceci affecte
317 tous les modules qui utilisent ces variables d'environnement).</dd>
319 <dt><module>mod_authz_core</module> Conteneurs de logique d'autorisation</dt>
321 <dd>La directive <directive
322 module="mod_authz_core">Require</directive> et les directives de
323 conteneurs associées, comme <directive module="mod_authz_core"
324 type="section">RequireAll</directive>, permettent de définir une
325 logique d'autorisation avancée.</dd>
329 <dt><module>mod_rewrite</module></dt>
330 <dd>La directive <directive
331 module="mod_rewrite">RewriteRule</directive> dispose maintenant
332 des drapeaux <code>[QSD]</code> (Query String Discard) et
333 <code>[END]</code> qui permettent de simplifier les scénarios de
334 réécriture courants.</dd>
335 <dd>Possibilité d'utiliser des expressions booléennes complexes
336 dans la directive <directive
337 module="mod_rewrite">RewriteCond</directive>.</dd>
338 <dd>Possibilité d'utiliser des requêtes SQL en tant que fonctions
339 dans la directive <directive
340 module="mod_rewrite">RewriteMap</directive>.</dd>
342 <dt><module>mod_ldap</module>, <module>mod_authnz_ldap</module></dt>
343 <dd><module>mod_authnz_ldap</module> ajoute le support des
344 groupes imbriqués.</dd>
345 <dd><module>mod_ldap</module> apporte les directives <directive
346 module="mod_ldap">LDAPConnectionPoolTTL</directive> et <directive
347 module="mod_ldap">LDAPTimeout</directive>, ainsi que d'autres
348 améliorations dans le traitement des délais. Ceci s'avère utile
349 pour les configurations où un pare-feu à mémoire d'état (stateful)
350 rejète les connexions inactives vers le serveur LDAP.</dd>
351 <dd><module>mod_ldap</module> propose la directive <directive
352 module="mod_ldap">LDAPLibraryDebug</directive> qui permet de
353 journaliser les informations de débogage fournies par la boîte à
354 outils LDAP utilisée.</dd>
356 <dt><module>mod_info</module></dt>
357 <dd><module>mod_info</module> est maintenant capable d'afficher la
358 configuration préinterprétée sur stdout au cours du démarrage du
361 <dt><module>mod_auth_basic</module></dt>
362 <dd>Nouveau mécanisme générique permettant d'effectuer une
363 authentification basique (disponible à partir de la version 2.4.5).</dd>
368 <section id="programs">
369 <title>Améliorations des programmes</title>
371 <dt><program>fcgistarter</program></dt>
372 <dd>Nouvel utilitaire pour le démarrage des démons
374 <dt><program>htcacheclean</program></dt>
375 <dd>Les URLs présentes dans le cache peuvent maintenant être
376 affichées, accompagnées éventuellement de leurs métadonnées.</dd>
377 <dd>Possibilité de supprimer explicitement des URLs individuelles
378 présentes dans le cache.</dd>
379 <dd>Les tailles de fichiers peuvent maintenant être arrondies au
380 multiple de la taille de bloc donnée, les limites de taille
381 collant de ce fait d'avantage à la taille réelle sur disque.</dd>
382 <dd>La taille du cache peut maintenant être limitée par le
383 nombre d'inodes, en plus de la possibilité de limitation par la
384 taille des fichiers.</dd>
386 <dt><program>rotatelogs</program></dt>
387 <dd>Possibilité de créer un lien vers le fichier journal
389 <dd>Possibilité d'invoquer un script personnalisé après la
392 <dt><program>htpasswd</program>, <program>htdbm</program></dt>
393 <dd>Support de l'algorithme bcrypt (disponible à partir de la
399 <section id="documentation">
400 <title>Documentation</title>
403 <dd>La documentation du module <module>mod_rewrite</module> a
404 été réorganisée et presque entièrement réécrite en mettant
405 l'accent sur les exemples et l'utilisation courante, ainsi que
406 sur l'incitation à utiliser d'autres solutions lorsque cela
407 s'avère plus approprié. Le document <a href="rewrite/">Rewrite
408 Guide</a> constitue maintenant une section de premier niveau ;
409 il est mieux organisé et contient beaucoup plus de détails.</dd>
412 <dd>La documentation du module <module>mod_ssl</module> a été
413 grandement améliorée, avec plus d'exemples et un niveau "Bien
414 démarrer" qui s'ajoutent aux détails techniques déjà présents
415 dans la précédente documentation.</dd>
417 <dt>Caching Guide</dt>
418 <dd>Le <a href="caching.html">Guide de la mise en cache</a> a
419 été réécrit afin de bien faire la différence entre les
420 fonctionnalités de mise en cache de la RFC2616 HTTP/1.1 fournies
421 par le module <module>mod_cache</module>, et la mise en cache
422 générique de type clé/valeur fournie par l'interface <a
423 href="socache.html">socache</a>, mais aussi pour couvrir la mise
424 en cache spécialisée fournie par des mécanismes tels que ceux du
425 module <module>mod_file_cache</module>.</dd>
429 <section id="developer">
430 <title>Modifications concernant les développeur de modules</title>
432 <dt>Ajout de code pour la vérification de la configuration</dt>
434 <dd>Une nouvelle fonction, <code>check_config</code>, a été ajoutée et
435 s'exécute entre les fonctions <code>pre_config</code> et
436 <code>open_logs</code>. Elle s'exécute aussi avant la fonction
437 <code>test_config</code> si l'option <code>-t</code> est passée au
438 démon <program>httpd</program>. La fonction <code>check_config</code>
439 permet aux modules de vérifier l'interdépendance des valeurs des
440 directives de configuration et d'ajuster ces valeurs, alors que les
441 messages du serveur peuvent encore être affichés sur la console.
442 L'utilisateur est ainsi averti des erreurs de configuration avant que la
443 fonction du noyau <code>open_logs</code> ne redirige les sorties de la
444 console vers le journal des erreurs.</dd>
446 <dt>Ajout d'un analyseur syntaxique d'expressions</dt>
447 <dd>Nous disposons à présent d'un analyseur générique d'expressions, dont l'API
448 est décrite dans <var>ap_expr.h</var>. Il s'agit d'une adaptation de
449 l'analyseur qu'on trouvait auparavant dans <module>mod_ssl</module>.</dd>
451 <dt>Conteneurs de logique d'autorisation</dt>
453 <dd>Afin de fournir une logique d'autorisation avancée via des
454 directives telles que <directive module="mod_authz_core"
455 type="section">RequireAll</directive>, les modules d'autorisation
456 s'enregistrent maintenant en tant
457 que fournisseur par le biais de ap_register_auth_provider().</dd>
459 <dt>Interface de mise en cache des petits objets</dt>
461 <dd>Le fichier d'en-têtes <var>ap_socache.h</var> fournit une
462 interface à base de fournisseur pour la mise en cache des petits
463 objets de données, en s'inspirant de
464 l'implémentation précédente
465 du cache de session par <module>mod_ssl</module>. Sont supportés
466 actuellement : les fournisseurs utilisant un tampon cyclique en
467 mémoire partagée, les fichiers dbm sur disque, et les caches
468 distribués de type memcache.</dd>
470 <dt>Ajout du point d'ancrage Cache Status</dt>
472 <dd>Le module <module>mod_cache</module> inclut maintenant un
473 nouveau point d'ancrage, <code>cache_status</code>, qui est appelé
474 lorsque la décision à propos de la mise en cache est connue. Il en
475 existe une implémentation par défaut qui ajoute les en-têtes
476 optionnels <code>X-Cache</code> et <code>X-Cache-Detail</code> à
477 la réponse.</dd>
481 <p>La documentation du développeur contient une <a
482 href="developer/new_api_2_4.html">liste détaillée des modifications