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 vers 2.4 depuis 2.2 - 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" />
12 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
13 <body id="manual-page"><div id="page-header">
14 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
15 <p class="apache">Serveur Apache HTTP Version 2.3</p>
16 <img alt="" src="./images/feather.gif" /></div>
17 <div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
19 <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.3</a></div><div id="page-content"><div id="preamble"><h1>Mise à jour vers 2.4 depuis 2.2</h1>
21 <p><span>Langues Disponibles: </span><a href="./en/upgrading.html" hreflang="en" rel="alternate" title="English"> en </a> |
22 <a href="./fr/upgrading.html" title="Français"> fr </a></p>
24 <div class="outofdate">Cette traduction peut être périmée. Vérifiez la version
25 anglaise pour les changements récents.</div>
27 <p>Afin d'assister les utilisateurs lors de leurs opérations de mise à
28 jour, nous maintenons un document
29 qui comporte des informations critiques à l'attention des personnes qui
30 utilisent déjà le serveur HTTP Apache. Ces informations
31 ne sont que de brèves notes, et vous
32 trouverez plus d'informations dans le document <a href="new_features_2_4.html">Nouvelles fonctionnalités</a>, ou dans
33 le fichier <code>src/CHANGES</code>. Les développeurs d'applications
34 et de modules trouveront un résumé des modifications de l'API dans la
35 vue d'ensemble <a href="developer/new_api_2_4.html">Mises à jour de
38 <p>Ce document présente les changements de comportement du serveur qui
39 peuvent nécessiter une modification de la configuration, et la manière
40 d'utiliser la version 2.4 du serveur en continuant d'utiliser la
41 version 2.2. Pour tirer parti des nouvelles fonctionnalités de la
42 version 2.4, reportez-vous au document "Nouvelles fonctionnalités".</p>
44 <p>Ce document ne décrit que les modifications intervenues entre les versions
45 2.2 et 2.4. Si vous effectuez une mise à jour depuis la version 2.0, vous
46 devez aussi consulter le
47 <a href="http://httpd.apache.org/docs/2.2/upgrading.html">document de mise
48 à jour de 2.0 vers 2.2.</a></p>
51 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#compile-time">Modifications de la configuration au moment de la compilation</a></li>
52 <li><img alt="" src="./images/down.gif" /> <a href="#run-time">Modifications de la configuration à l'exécution</a></li>
53 <li><img alt="" src="./images/down.gif" /> <a href="#misc">Changements divers</a></li>
54 <li><img alt="" src="./images/down.gif" /> <a href="#third-party">Modules tiers</a></li>
55 <li><img alt="" src="./images/down.gif" /> <a href="#commonproblems">Problèmes de mise à jour courants</a></li>
56 </ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="new_features_2_4.html">Vue d'ensemble des nouvelles
57 fonctionnalités du serveur HTTP Apache 2.4</a></li></ul></div>
58 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
60 <h2><a name="compile-time" id="compile-time">Modifications de la configuration au moment de la compilation</a></h2>
62 <p>Le processus de compilation est très similaire à celui de la
63 version 2.2. Dans la plupart des cas, vous pourrez utiliser votre
64 ancienne ligne de commande <code>configure</code> (telle qu'elle
65 est enregistrée dans le fichier <code>build/config.nice</code>
66 situé dans le répertoire de compilation du serveur). Voici certains
67 changements intervenus dans la configuration par défaut :</p>
70 <li>Les modules suivants ont été supprimés : mod_authn_default,
71 mod_authz_default et mod_mem_cache. Si vous utilisiez
72 mod_mem_cache sous la version 2.2, reportez-vous à
73 <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> dans la version 2.4.</li>
75 <li>Toutes les implémentations de répartition de charge ont été
76 déplacées vers des sous-modules spécifiques de mod_proxy, comme
77 <code class="module"><a href="./mod/mod_lbmethod_bybusyness.html">mod_lbmethod_bybusyness</a></code>. Vous devrez compiler et
78 chargés tous les modules correspondants que votre configuration
81 <li>Le support de BeOS, TPF, et des anciennes plates-formes telles
82 que A/UX, Next, et Tandem a été supprimé, car il a été supposé
83 qu'elles n'étaient plus maintenues.</li>
85 <li>configure: les modules dynamiques (DSO) sont compilés par
88 <li>configure: le jeu de modules "most" est compilé par défaut</li>
91 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
93 <h2><a name="run-time" id="run-time">Modifications de la configuration à l'exécution</a></h2>
95 <p>Des changements significatifs dans la configuration de
96 l'autorisation, ainsi que quelques changements mineurs, peuvent
97 nécessiter une modification des fichiers de configuration de la version
98 2.2 avant de les utiliser sous la version 2.4.</p>
100 <h3><a name="authz" id="authz">Autorisation</a></h3>
103 <p>Tout fichier de configuration qui gère des autorisations devra
104 probablement être modifié.</p>
106 <p>Vous devez vous reporter au document <a href="howto/auth.html">Authentification, autorisation et contrôle
107 d'accès</a>, et plus particulièrement à la section <a href="howto/auth.html#beyond">Plus loin qu'une simple
108 autorisation</a> qui explique les nouveaux mécanismes permettant de
109 contrôler l'ordre dans lequel les directives d'autorisation sont
112 <h4><a name="access" id="access">Contrôle d'accès</a></h4>
115 <p>Dans la version 2.2, le contrôle d'accès basé sur le nom d'hôte
116 du client, son adresse IP, ou d'autres caractéristiques de la
117 requête du client é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>
119 <p>Dans la version 2.4, ce contrôle d'accès est assuré, comme tout
120 contrôle d'autorisation, via le nouveau module
121 <code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code>. Bien que le module
122 <code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code> soit fourni à des fins de
123 compatibilité avec les anciennes configurations, les anciennes
124 directives de contrôle d'accès devront être remplacées par les
125 nouveaux mécanismes d'authentification.</p>
127 <p>Voici quelques exemples de contrôle d'accès avec l'ancienne et
128 la nouvelle méthode :</p>
130 <p>Dans cet exemple, toutes les requêtes sont rejetées :</p>
131 <div class="example"><h3>version 2.2 :</h3><p><code>
133 Order deny,allow<br />
136 <div class="example"><h3>version 2.4 :</h3><p><code>
141 <p>Dans cet exemple, toutes les requêtes sont acceptées :</p>
142 <div class="example"><h3>version 2.2 :</h3><p><code>
144 Order allow,deny<br />
147 <div class="example"><h3>version 2.4 :</h3><p><code>
152 <p>Dans l'exemple suivant, tous les hôtes du domaine example.org
153 ont l'autorisation d'accès, tous les autres sont rejetés :</p>
155 <div class="example"><h3>version 2.2 :</h3><p><code>
157 Order Deny,Allow<br />
159 Allow from example.org
161 <div class="example"><h3>version 2.4 :</h3><p><code>
163 Require host example.org
169 <h3><a name="config" id="config">Autres changements de configuration</a></h3>
172 <p>D'autres ajustements mineurs peuvent s'avérer nécessaires pour
173 certaines configurations particulières, comme décrit ci-dessous.</p>
176 <li><code class="directive">MaxRequestsPerChild</code> a été renommée en
177 <code class="directive"><a href="./mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code>;
178 ce nouveau nom reflète mieux l'usage de cette directive.</li>
180 <li>La directive <code class="directive"><a href="./mod/core.html#defaulttype">DefaultType</a></code> ne produit plus aucun
181 effet, si ce n'est d'émettre un avertissement si elle est
182 définie à une valeur autre que <code>none</code>. D'autres
183 directives de configuration la remplacent dans la version 2.4.
186 <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>
188 <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>
189 correspond au nom du cookie dans son ensemble, alors qu'avant,
190 toute sous-chaîne pouvait correspondre.</li>
192 <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/dav_fs.html#davlockdb">DavLockDB</a></code> a changé pour les systèmes
193 avec inodes. L'ancien fichier <code class="directive"><a href="./mod/dav_fs.html#davlockdb">DavLockDB</a></code> doit être supprimé dans le
194 cadre de la mise à jour.
197 <li>La directive <code class="directive"><a href="./mod/core.html#keepalive">KeepAlive</a></code>
198 n'accepte que les valeurs <code>On</code> ou <code>Off</code>.
199 Avant, toute valeur autre que "Off" ou "0" était traitée comme
202 <li>Les directives AcceptMutex, LockFile, RewriteLock, SSLMutex,
203 SSLStaplingMutex et WatchdogMutexPath ont été remplacées par la
204 directive unique <code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code>.
205 Vous devez évaluer l'impact de ces directives obsolètes dans
206 votre configuration version 2.2 afin de déterminer si elles
207 peuvent être simplement supprimées, ou si elles doivent être
208 remplacées par la directive <code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code>.</li>
210 <li><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>: la directive <code class="directive"><a href="./mod/cache.html#cacheignoreurlsessionidentifiers">CacheIgnoreURLSessionIdentifiers</a></code>
211 effectue maintenent une correspondance exacte dans la chaîne de
212 paramètres au lieu d'une correspondance partielle. Si votre
213 configuration mettait en jeu des sous-chaînes comme
214 <code>sessionid</code> pour correspondre à
215 <code>/une-application/image.gif;jsessionid=123456789</code>,
216 vous devez maintenant utiliser la chaîne de correspondance
217 complète <code>jsessionid</code>.
220 <li><code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code>: la directive <code class="directive"><a href="./mod/ldap.html#ldaptrustedclientcert">LDAPTrustedClientCert</a></code> s'utilise
221 maintenant exclusivement au sein d'une configuration de niveau
222 répertoire. Si vous utilisez cette directive, passez en revue
223 votre configuration pour vous assurer qu'elle est bien présente
224 dans tous les contextes de répertoire nécessaires.</li>
226 <li><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code>: la syntaxe de la directive
227 <code class="directive"><a href="./mod/filter.html#filterprovider">FilterProvider</a></code> utilise
228 maintenant une expression booléenne pour déterminer si un filtre
234 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
235 <div class="section">
236 <h2><a name="misc" id="misc">Changements divers</a></h2>
240 <li><code class="module"><a href="./mod/mod_auto_index.html">mod_auto_index</a></code>: extrait maintenant les titres
241 et affiche la description pour les fichiers .xhtml qui étaient
242 jusqu'alors ignorés.</li>
243 <li><code class="program"><a href="./programs/htpasswd.html">htpasswd</a></code> utilise maintenant par défaut les
244 condensés MD5 sur toutes les plates-formes.</li>
247 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
248 <div class="section">
249 <h2><a name="third-party" id="third-party">Modules tiers</a></h2>
252 <p>Tous les modules tiers doivent être recompilés pour la
253 version 2.4 avant d'être chargés.</p>
255 <p>De nombreux modules tiers conçus pour la version 2.2
256 fonctionneront sans changement avec le serveur HTTP Apache
257 version 2.4. Certains nécessiterons cependant des modifications ; se
258 reporter à la vue d'ensemble <a href="developer/new_api_2_4.html">Mise à jour de l'API</a>.</p>
259 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
260 <div class="section">
261 <h2><a name="commonproblems" id="commonproblems">Problèmes de mise à jour courants</a></h2>
263 <ul><li>Erreurs au démarrage :
265 <li><code>Invalid command 'User', perhaps misspelled or defined by
266 a module not included in the server configuration</code> - chargez
267 le module <code class="module"><a href="./mod/mod_unixd.html">mod_unixd</a></code></li>
269 <li><code>Invalid command 'Require', perhaps misspelled or defined
270 by a module not included in the server configuration</code>, ou
271 <code>Invalid command 'Order', perhaps misspelled or defined by a
272 module not included in the server configuration</code> - chargez
273 le module <code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code>, ou mettez à jour
274 vers la version 2.4 les directives d'autorisation.</li>
275 <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>
277 <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>
279 <li><code>Ignoring deprecated use of DefaultType in line NN of
280 /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
281 directives de configuration appropriées.</li>
282 <li><code>mixing * ports and non-* ports with a NameVirtualHost
283 address is not supported</code>, <code>Either NameVirtualHost
284 w.x.y.z:n has no VirtualHosts, or there is more than one identical
285 NameVirtualHost line, or your VirtualHost declarations do not
286 match the NameVirtualHost line</code> -
287 ce ne sont pas des nouveaux messages, mais ils empêchent
288 maintenant le serveur de démarrer</li>
289 <li><code>_default_ is not allowed in NameVirtualHost
290 directive</code> - l'explication est dans le message ; cette
291 définition n'a jamais été valide, mais elle empêche maintenant le
292 serveur de démarrer.</li>
294 <li>Erreurs de traitement des requêtes :
296 <li><code>configuration error: couldn't check user: /path</code> -
297 chargez le module <code class="module"><a href="./mod/mod_authn_core.html">mod_authn_core</a></code>.</li>
303 <div class="bottomlang">
304 <p><span>Langues Disponibles: </span><a href="./en/upgrading.html" hreflang="en" rel="alternate" title="English"> en </a> |
305 <a href="./fr/upgrading.html" title="Français"> fr </a></p>
306 </div><div id="footer">
307 <p class="apache">Copyright 2011 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
308 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div>