1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5 This file is generated from xml source: DO NOT EDIT
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
8 <title>Mise à jour de la version 2.2 vers la version 2.4 - Serveur Apache HTTP</title>
9 <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
10 <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
11 <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" />
12 <script src="./style/scripts/prettify.js" type="text/javascript">
15 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
16 <body id="manual-page"><div id="page-header">
17 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
18 <p class="apache">Serveur Apache HTTP Version 2.5</p>
19 <img alt="" src="./images/feather.gif" /></div>
20 <div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
22 <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></div><div id="page-content"><div id="preamble"><h1>Mise à jour de la version 2.2 vers la version 2.4</h1>
24 <p><span>Langues Disponibles: </span><a href="./en/upgrading.html" hreflang="en" rel="alternate" title="English"> en </a> |
25 <a href="./fr/upgrading.html" title="Français"> fr </a></p>
27 <div class="outofdate">Cette traduction peut être périmée. Vérifiez la version
28 anglaise pour les changements récents.</div>
30 <p>Afin d'assister les utilisateurs lors de leurs opérations de mise à
31 jour, nous maintenons un document
32 qui comporte des informations critiques à l'attention des personnes qui
33 utilisent déjà le serveur HTTP Apache. Ces informations
34 ne sont que de brèves notes, et vous
35 trouverez plus d'informations dans le document <a href="new_features_2_4.html">Nouvelles fonctionnalités</a>, ou dans
36 le fichier <code>src/CHANGES</code>. Les développeurs d'applications
37 et de modules trouveront un résumé des modifications de l'API dans la
38 vue d'ensemble <a href="developer/new_api_2_4.html">Mises à jour de
41 <p>Ce document présente les changements de comportement du serveur qui
42 peuvent nécessiter une modification de la configuration, et la manière
43 d'utiliser la version 2.4 du serveur en parallèle avec la
44 version 2.2. Pour tirer parti des nouvelles fonctionnalités de la
45 version 2.4, reportez-vous au document "Nouvelles fonctionnalités".</p>
47 <p>Ce document ne décrit que les modifications intervenues entre les versions
48 2.2 et 2.4. Si vous effectuez une mise à jour depuis la version 2.0, vous
49 devez aussi consulter le
50 <a href="http://httpd.apache.org/docs/2.2/upgrading.html">document de mise
51 à jour de 2.0 vers 2.2.</a></p>
54 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#compile-time">Modifications des paramètres de compilation</a></li>
55 <li><img alt="" src="./images/down.gif" /> <a href="#run-time">Modifications de la configuration à l'exécution</a></li>
56 <li><img alt="" src="./images/down.gif" /> <a href="#misc">Changements divers</a></li>
57 <li><img alt="" src="./images/down.gif" /> <a href="#third-party">Modules tiers</a></li>
58 <li><img alt="" src="./images/down.gif" /> <a href="#commonproblems">Problèmes de mise à jour courants</a></li>
59 </ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="new_features_2_4.html">Vue d'ensemble des nouvelles
60 fonctionnalités du serveur HTTP Apache 2.4</a></li></ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
61 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
63 <h2><a name="compile-time" id="compile-time">Modifications des paramètres de compilation</a></h2>
65 <p>Le processus de compilation est très similaire à celui de la
66 version 2.2. Dans la plupart des cas, vous pourrez utiliser votre
67 ancienne ligne de commande <code>configure</code> (telle qu'elle
68 est enregistrée dans le fichier <code>build/config.nice</code>
69 situé dans le répertoire de compilation du serveur). Voici certains
70 changements intervenus dans la configuration par défaut :</p>
73 <li>Les modules suivants ont été supprimés : mod_authn_default,
74 mod_authz_default et mod_mem_cache. Si vous utilisiez
75 mod_mem_cache sous la version 2.2, vous devez maintenant utiliser
76 <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> dans la version 2.4.</li>
78 <li>Toutes les implémentations de répartition de charge ont été
79 déplacées vers des sous-modules spécifiques de mod_proxy, comme
80 <code class="module"><a href="./mod/mod_lbmethod_bybusyness.html">mod_lbmethod_bybusyness</a></code>. Vous devrez compiler et
81 chargés tous les modules correspondants que votre configuration
84 <li>Le support de BeOS, TPF, et des anciennes plates-formes telles
85 que A/UX, Next, et Tandem a été supprimé, car
86 elles ne sont plus considérées comme maintenues.</li>
88 <li>configure: les modules dynamiques (DSO) sont compilés par
91 <li>configure: par défaut, seul un jeu de modules de base est
92 chargé. Les autres directives <code class="directive">LoadModule</code>
93 sont mises en commentaires.</li>
95 <li>configure: le jeu de modules "most" est compilé par défaut</li>
97 <li>configure: le jeu de modules "reallyall" ajoute les modules de
98 développeur au jeu "all".</li>
101 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
102 <div class="section">
103 <h2><a name="run-time" id="run-time">Modifications de la configuration à l'exécution</a></h2>
105 <p>Des changements significatifs dans la configuration de
106 l'autorisation, ainsi que quelques changements mineurs, peuvent
107 nécessiter une mise à jour des fichiers de configuration de la version
108 2.2 avant de les utiliser sous la version 2.4.</p>
110 <h3><a name="authz" id="authz">Autorisation</a></h3>
113 <p>Tout fichier de configuration qui gère des autorisations devra
114 probablement être mis à jour.</p>
116 <p>Vous devez vous reporter au document <a href="howto/auth.html">Authentification, autorisation et contrôle
117 d'accès</a>, et plus particulièrement à la section <a href="howto/auth.html#beyond">Plus loin qu'une simple
118 autorisation</a> qui explique les nouveaux mécanismes permettant de
119 contrôler l'ordre dans lequel les directives d'autorisation sont
122 <h4><a name="access" id="access">Contrôle d'accès</a></h4>
125 <p>Dans la version 2.2, le contrôle d'accès basé sur le nom d'hôte
126 du client, son adresse IP, ou d'autres caractéristiques de la
127 requête était assuré via les directives <code class="directive"><a href="./mod/mod_access_compat.html#order">Order</a></code>, <code class="directive"><a href="./mod/mod_access_compat.html#allow">Allow</a></code>, <code class="directive"><a href="./mod/mod_access_compat.html#deny">Deny</a></code>, et <code class="directive"><a href="./mod/mod_access_compat.html#satisfy">Satisfy</a></code>.</p>
129 <p>Dans la version 2.4, ce contrôle d'accès est assuré, comme tout
130 contrôle d'autorisation, via le nouveau module
131 <code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code>. Bien que le module
132 <code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code> soit fourni à des fins de
133 compatibilité avec les anciennes configurations, les anciennes
134 directives de contrôle d'accès devront être remplacées par les
135 nouveaux mécanismes d'authentification.</p>
137 <p>Voici quelques exemples de contrôle d'accès avec l'ancienne et
138 la nouvelle méthode :</p>
140 <p>Dans cet exemple, toutes les requêtes sont rejetées :</p>
141 <div class="example"><h3>version 2.2 :</h3><p><code>
143 Order deny,allow<br />
146 <div class="example"><h3>version 2.4 :</h3><p><code>
151 <p>Dans cet exemple, toutes les requêtes sont acceptées :</p>
152 <div class="example"><h3>version 2.2 :</h3><p><code>
154 Order allow,deny<br />
157 <div class="example"><h3>version 2.4 :</h3><p><code>
162 <p>Dans l'exemple suivant, tous les hôtes du domaine example.org
163 ont l'autorisation d'accès, tous les autres sont rejetés :</p>
165 <div class="example"><h3>version 2.2 :</h3><p><code>
167 Order Deny,Allow<br />
169 Allow from example.org
171 <div class="example"><h3>version 2.4 :</h3><p><code>
173 Require host example.org
179 <h3><a name="config" id="config">Autres changements dans la configuration</a></h3>
182 <p>D'autres ajustements mineurs peuvent s'avérer nécessaires pour
183 certaines configurations particulières, comme décrit ci-dessous.</p>
186 <li><code class="directive">MaxRequestsPerChild</code> a été renommée en
187 <code class="directive"><a href="./mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code>;
188 ce nouveau nom reflète mieux l'usage de cette directive.
189 L'ancien nom est encore supporté.</li>
191 <li>La directive <code class="directive">MaxClients</code> a
192 été renommée en <code class="directive"><a href="./mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code>; ce nouveau
193 nom reflète mieux l'usage de cette directive. Pour les
194 modules multiprocessus asynchrones, comme <code class="module"><a href="./mod/event.html">event</a></code>, le nombre
195 maximal de clients n'est pas équivalent au nombre de threads du
196 worker. L'ancien nom est encore supporté.</li>
198 <li>La directive <code class="directive"><a href="./mod/core.html#defaulttype">DefaultType</a></code> ne produit plus aucun
199 effet, si ce n'est d'émettre un avertissement si elle est
200 définie à une valeur autre que <code>none</code>. D'autres
201 directives de configuration la remplacent dans la version 2.4.
204 <li>La valeur par défaut de la directive <code class="directive"><a href="./mod/core.html#enablesendfile">EnableSendfile</a></code> est maintenant Off.</li>
206 <li>La valeur par défaut de la directive <code class="directive"><a href="./mod/core.html#fileetag">FileETag</a></code> est maintenant "MTime Size"
209 <li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code>: <a href="modules/mod_log_config.html#formats">${cookie}C</a>
210 correspond au nom du cookie dans son ensemble, alors qu'avant,
211 toute sous-chaîne pouvait correspondre.</li>
213 <li><code class="module"><a href="./mod/mod_dav_fs.html">mod_dav_fs</a></code>: le format du fichier <code class="directive"><a href="./mod/mod_dav_fs.html#davlockdb">DavLockDB</a></code> a changé pour les systèmes
214 avec inodes. L'ancien fichier <code class="directive"><a href="./mod/mod_dav_fs.html#davlockdb">DavLockDB</a></code> doit être supprimé dans le
215 cadre de la mise à jour.
218 <li>La directive <code class="directive"><a href="./mod/core.html#keepalive">KeepAlive</a></code>
219 n'accepte que les valeurs <code>On</code> ou <code>Off</code>.
220 Avant, toute valeur autre que "Off" ou "0" était traitée comme
223 <li>Les directives AcceptMutex, LockFile, RewriteLock, SSLMutex,
224 SSLStaplingMutex et WatchdogMutexPath ont été remplacées par la
225 directive unique <code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code>.
226 Vous devez évaluer l'impact de ces directives obsolètes dans
227 votre configuration version 2.2 afin de déterminer si elles
228 peuvent être simplement supprimées, ou si elles doivent être
229 remplacées par la directive <code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code>.</li>
231 <li><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>: la directive <code class="directive"><a href="./mod/mod_cache.html#cacheignoreurlsessionidentifiers">CacheIgnoreURLSessionIdentifiers</a></code>
232 effectue maintenant une correspondance exacte dans la chaîne de
233 paramètres au lieu d'une correspondance partielle. Si votre
234 configuration mettait en jeu des sous-chaînes comme
235 <code>sessionid</code> pour correspondre à
236 <code>/une-application/image.gif;jsessionid=123456789</code>,
237 vous devez maintenant utiliser la chaîne de correspondance
238 complète <code>jsessionid</code>.
241 <li><code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code>: la directive <code class="directive"><a href="./mod/mod_ldap.html#ldaptrustedclientcert">LDAPTrustedClientCert</a></code> s'utilise
242 maintenant exclusivement au sein d'une configuration de niveau
243 répertoire. Si vous utilisez cette directive, passez en revue
244 votre configuration pour vous assurer qu'elle est bien présente
245 dans tous les contextes de répertoire nécessaires.</li>
247 <li><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code>: la syntaxe de la directive
248 <code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code> utilise
249 maintenant une expression booléenne pour déterminer si un filtre
253 <li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code>:
255 <li>L'élément <code>#if expr</code> utilise maintenant le
256 nouvel <a href="expr.html">interpréteur d'expressions</a>.
257 L'ancienne syntaxe peut être réactivée via la directive
258 <code class="directive"><a href="./mod/mod_include.html#ssilegacyexprparser">SSILegacyExprParser</a></code>.
260 <li>Dans la portée du répertoire, une directive de
261 configuration SSI* ne provoque plus la réinitialisation à
262 leur valeur par défaut de toutes les directives SSI* de
263 niveau répertoire.</li>
267 <li><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code> : l'option
268 <code>DebugLevel</code> a été supprimée en faveur d'une
269 configuration de la directive <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> au niveau répertoire.
272 <li><code class="module"><a href="./mod/mod_ext-filter.html">mod_ext-filter</a></code> : l'option
273 <code>DebugLevel</code> a été supprimée en faveur d'une
274 configuration de la directive <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> au niveau répertoire.
277 <li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>: le contrôle de révocation des
278 certificats basé sur les CRL doit être maintenant explicitement
279 configuré via la directive <code class="directive"><a href="./mod/mod_ssl.html#sslcarevocationcheck">SSLCARevocationCheck</a></code>.
282 <li><code class="module"><a href="./mod/mod_substitute.html">mod_substitute</a></code>: la taille maximale d'une
283 ligne est maintenant 1Mo.
286 <li><code class="module"><a href="./mod/mod_reqtimeout.html">mod_reqtimeout</a></code>: si ce module est chargé, il
287 définit maintenant certains temps d'attente par défaut.</li>
291 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
292 <div class="section">
293 <h2><a name="misc" id="misc">Changements divers</a></h2>
297 <li><code class="module"><a href="./mod/mod_auto_index.html">mod_auto_index</a></code>: extrait maintenant les titres
298 et affiche la description pour les fichiers .xhtml qui étaient
299 jusqu'alors ignorés.</li>
301 <li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> : le format par défaut des variables
302 <code>*_DN</code> a changé. Il est cependant encore possible
303 d'utiliser l'ancien format via la nouvelle option
304 <code>LegacyDNStringFormat</code> de la directive <code class="directive"><a href="./mod/mod_ssl.html#ssloptions">SSLOptions</a></code>. Le protocole SSLv2 n'est
305 plus supporté. Les directives <code class="directive"><a href="./mod/mod_ssl.html#sslproxycheckpeercn">SSLProxyCheckPeerCN</a></code> et
306 <code class="directive"><a href="./mod/mod_ssl.html#sslproxycheckpeerexpire">SSLProxyCheckPeerExpire</a></code>
307 sont maintenant définies par défaut à On, et les requêtes mandatées
308 vers des serveurs HTTPS possèdant des certificats non conformes ou
309 périmés échoueront donc avec un code d'erreur 502 (Bad gateway).</li>
311 <li><code class="program"><a href="./programs/htpasswd.html">htpasswd</a></code> utilise maintenant par défaut les
312 condensés MD5 sur toutes les plates-formes.</li>
314 <li>La directive <code class="directive"><a href="./mod/core.html#namevirtualhost">NameVirtualHost</a></code> n'a plus aucun effet, si
315 ce n'est l'émission d'un avertissement. Toute combinaison
316 adresse/port apparaissant dans plusieurs serveurs virtuels est
317 traitée implicitement comme un serveur virtuel basé sur le nom.
320 <li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> n'effectue plus de compression
321 s'il s'aperçoit que la quantité de données ajoutée par la
322 compression est supérieure à la quantité de données à compresser.
325 <li>Les pages d'erreur multilingues de la version 2.2.x ne
326 fonctionneront qu'après avoir été corrigées pour
327 respecter la nouvelle syntaxe de l'élément <code>#if expr=</code>
328 du module <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>, ou si la directive
329 <code class="directive"><a href="./mod/mod_include.html#ssilegacyexprparser">SSILegacyExprParser</a></code> a
330 été activée pour le répertoire contenant les pages d'erreur.
334 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
335 <div class="section">
336 <h2><a name="third-party" id="third-party">Modules tiers</a></h2>
339 <p>Tous les modules tiers doivent être recompilés pour la
340 version 2.4 avant d'être chargés.</p>
342 <p>De nombreux modules tiers conçus pour la version 2.2
343 fonctionneront sans changement avec le serveur HTTP Apache
344 version 2.4. Certains nécessiterons cependant des modifications ; se
345 reporter à la vue d'ensemble <a href="developer/new_api_2_4.html">Mise à jour de l'API</a>.</p>
346 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
347 <div class="section">
348 <h2><a name="commonproblems" id="commonproblems">Problèmes de mise à jour courants</a></h2>
350 <ul><li>Erreurs au démarrage :
352 <li><code>Invalid command 'User', perhaps misspelled or defined by
353 a module not included in the server configuration</code> - chargez
354 le module <code class="module"><a href="./mod/mod_unixd.html">mod_unixd</a></code></li>
356 <li><code>Invalid command 'Require', perhaps misspelled or defined
357 by a module not included in the server configuration</code>, ou
358 <code>Invalid command 'Order', perhaps misspelled or defined by a
359 module not included in the server configuration</code> - chargez
360 le module <code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code>, ou mettez à jour
361 vers la version 2.4 les directives d'autorisation.</li>
362 <li><code>mixing * ports and non-* ports with a NameVirtualHost address is not supported</code>, <code>Either NameVirtualHost w.x.y.z:n has no VirtualHosts, or there is more than one identical NameVirtualHost line, or your VirtualHost declarations do not match the NameVirtualHost line</code> - ces messages ne sont pas nouveaux, mais ils bloquent désormais le démarrage en générant une erreur</li>
364 <li><code>_default_ is not allowed in NameVirtualHost directive</code> - ceci a toujours été le cas, mais à présent cette erreur bloque le démarrage du serveur.</li>
366 <li><code>Ignoring deprecated use of DefaultType in line NN of
367 /path/to/httpd.conf</code> - supprimez la directive <code class="directive"><a href="./mod/core.html#defaulttype">DefaultType</a></code> et remplacez-la par les
368 directives de configuration appropriées.</li>
369 <li><code>mixing * ports and non-* ports with a NameVirtualHost
370 address is not supported</code>, <code>Either NameVirtualHost
371 w.x.y.z:n has no VirtualHosts, or there is more than one identical
372 NameVirtualHost line, or your VirtualHost declarations do not
373 match the NameVirtualHost line</code> -
374 ce ne sont pas des nouveaux messages, mais ils empêchent
375 maintenant le serveur de démarrer</li>
376 <li><code>_default_ is not allowed in NameVirtualHost
377 directive</code> - l'explication est dans le message ; cette
378 définition n'a jamais été valide, mais elle empêche maintenant le
379 serveur de démarrer.</li>
381 <li>Erreurs de traitement des requêtes :
383 <li><code>configuration error: couldn't check user: /path</code> -
384 chargez le module <code class="module"><a href="./mod/mod_authn_core.html">mod_authn_core</a></code>.</li>
390 <div class="bottomlang">
391 <p><span>Langues Disponibles: </span><a href="./en/upgrading.html" hreflang="en" rel="alternate" title="English"> en </a> |
392 <a href="./fr/upgrading.html" title="Français"> fr </a></p>
393 </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>This section is experimental!</strong><br />Comments placed here should not be expected
394 to last beyond the testing phase of this system, nor do we in any way guarantee that we'll read them.</div>
395 <script type="text/javascript"><!--//--><![CDATA[//><!--
396 var disqus_shortname = 'httpd';
397 var disqus_identifier = 'http://httpd.apache.org/docs/2.4/upgrading.html.fr';
399 if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
400 d.write('<div id="disqus_thread"><\/div>');
401 var s = d.createElement('script');
402 s.type = 'text/javascript';
404 s.src = 'http' + '://' + disqus_shortname + '.disqus.com/embed.js';
405 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
408 d.write('<div id="disqus_thread">Comments have been disabled for offline viewing.<\/div>');
410 })(window, document);
411 //--><!]]></script></div><div id="footer">
412 <p class="apache">Copyright 2012 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
413 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
414 if (typeof(prettyPrint) !== 'undefined') {