]> granicus.if.org Git - apache/blob - docs/manual/upgrading.html.fr
930441650f137115ae160233e5400898b5caa89a
[apache] / docs / manual / upgrading.html.fr
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
7       -->
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" />
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.5</p>
16 <img alt="" src="./images/feather.gif" /></div>
17 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
18 <div id="path">
19 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <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>
20 <div class="toplang">
21 <p><span>Langues Disponibles: </span><a href="./en/upgrading.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
22 <a href="./fr/upgrading.html" title="Français">&nbsp;fr&nbsp;</a></p>
23 </div>
24
25   <p>Afin d'assister les utilisateurs lors de leurs opérations de mise à
26   jour, nous maintenons un document
27   qui comporte des informations critiques à l'attention des personnes qui
28   utilisent déjà le serveur HTTP Apache. Ces informations
29   ne sont que de brèves notes, et vous
30   trouverez plus d'informations dans le document <a href="new_features_2_4.html">Nouvelles fonctionnalités</a>, ou dans
31   le fichier <code>src/CHANGES</code>. Les développeurs d'applications
32   et de modules trouveront un résumé des modifications de l'API dans la
33   vue d'ensemble <a href="developer/new_api_2_4.html">Mises à jour de
34   l'API</a>.</p>
35
36   <p>Ce document présente les changements de comportement du serveur qui
37   peuvent nécessiter une modification de la configuration, et la manière
38   d'utiliser la version 2.4 du serveur en parallèle avec la
39   version 2.2. Pour tirer parti des nouvelles fonctionnalités de la
40   version 2.4, reportez-vous au document "Nouvelles fonctionnalités".</p>
41
42   <p>Ce document ne décrit que les modifications intervenues entre les versions
43   2.2 et 2.4. Si vous effectuez une mise à jour depuis la version 2.0, vous
44   devez aussi consulter le
45   <a href="http://httpd.apache.org/docs/2.2/upgrading.html">document de mise
46   à jour de 2.0 vers 2.2.</a></p>
47
48 </div>
49 <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>
50 <li><img alt="" src="./images/down.gif" /> <a href="#run-time">Modifications de la configuration à l'exécution</a></li>
51 <li><img alt="" src="./images/down.gif" /> <a href="#misc">Changements divers</a></li>
52 <li><img alt="" src="./images/down.gif" /> <a href="#third-party">Modules tiers</a></li>
53 <li><img alt="" src="./images/down.gif" /> <a href="#commonproblems">Problèmes de mise à jour courants</a></li>
54 </ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="new_features_2_4.html">Vue d'ensemble des nouvelles
55 fonctionnalités du serveur HTTP Apache 2.4</a></li></ul></div>
56 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
57 <div class="section">
58 <h2><a name="compile-time" id="compile-time">Modifications des paramètres de compilation</a></h2>
59     
60      <p>Le processus de compilation est très similaire à celui de la
61      version 2.2. Dans la plupart des cas, vous pourrez utiliser votre
62      ancienne ligne de commande <code>configure</code> (telle qu'elle
63      est enregistrée dans le fichier <code>build/config.nice</code>
64      situé dans le répertoire de compilation du serveur). Voici certains
65      changements intervenus dans la configuration par défaut :</p>
66
67     <ul>
68       <li>Les modules suivants ont été supprimés : mod_authn_default,
69       mod_authz_default et mod_mem_cache. Si vous utilisiez
70       mod_mem_cache sous la version 2.2, vous devez maintenant utiliser
71       <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code> dans la version 2.4.</li>
72
73       <li>Toutes les implémentations de répartition de charge ont été
74       déplacées vers des sous-modules spécifiques de mod_proxy, comme
75       <code class="module"><a href="./mod/mod_lbmethod_bybusyness.html">mod_lbmethod_bybusyness</a></code>. Vous devrez compiler et
76       chargés tous les modules correspondants que votre configuration
77       utilise.</li>
78
79       <li>Le support de BeOS, TPF, et des anciennes plates-formes telles
80       que A/UX, Next, et Tandem a été supprimé, car
81       elles ne sont plus considérées comme maintenues.</li>
82
83       <li>configure: les modules dynamiques (DSO) sont compilés par
84       défaut</li>
85
86       <li>configure: par défaut, seul un jeu de modules de base est
87       chargé. Les autres directives <code class="directive">LoadModule</code>
88       sont mises en commentaires.</li>
89
90       <li>configure: le jeu de modules "most" est compilé par défaut</li>
91
92       <li>configure: le jeu de modules "reallyall" ajoute les modules de
93       développeur au jeu "all".</li>
94     </ul>
95
96   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
97 <div class="section">
98 <h2><a name="run-time" id="run-time">Modifications de la configuration à l'exécution</a></h2>
99     
100 <p>Des changements significatifs dans la configuration de
101 l'autorisation, ainsi que quelques changements mineurs, peuvent
102 nécessiter une mise à jour des fichiers de configuration de la version
103 2.2 avant de les utiliser sous la version 2.4.</p>
104
105     <h3><a name="authz" id="authz">Autorisation</a></h3>
106       
107
108       <p>Tout fichier de configuration qui gère des autorisations devra
109       probablement être mis à jour.</p>
110
111     <p>Vous devez vous reporter au document <a href="howto/auth.html">Authentification, autorisation et contrôle
112     d'accès</a>, et plus particulièrement à la section <a href="howto/auth.html#beyond">Plus loin qu'une simple
113     autorisation</a> qui explique les nouveaux mécanismes permettant de
114     contrôler l'ordre dans lequel les directives d'autorisation sont
115     appliquées.</p>
116
117     <h4><a name="access" id="access">Contrôle d'accès</a></h4>
118       
119
120       <p>Dans la version 2.2, le contrôle d'accès basé sur le nom d'hôte
121       du client, son adresse IP, ou d'autres caractéristiques de la
122       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>
123
124       <p>Dans la version 2.4, ce contrôle d'accès est assuré, comme tout
125       contrôle d'autorisation, via le nouveau module
126       <code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code>. Bien que le module
127       <code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code> soit fourni à des fins de
128       compatibilité avec les anciennes configurations, les anciennes
129       directives de contrôle d'accès devront être remplacées par les
130       nouveaux mécanismes d'authentification.</p>
131
132       <p>Voici quelques exemples de contrôle d'accès avec l'ancienne et
133       la nouvelle méthode :</p>
134
135       <p>Dans cet exemple, toutes les requêtes sont rejetées :</p>
136       <div class="example"><h3>version 2.2 :</h3><p><code>
137         
138         Order deny,allow<br />
139         Deny from all
140       </code></p></div>
141       <div class="example"><h3>version 2.4 :</h3><p><code>
142         
143         Require all denied
144       </code></p></div>
145
146       <p>Dans cet exemple, toutes les requêtes sont acceptées :</p>
147       <div class="example"><h3>version 2.2 :</h3><p><code>
148         
149         Order allow,deny<br />
150         Allow from all
151       </code></p></div>
152       <div class="example"><h3>version 2.4 :</h3><p><code>
153         
154         Require all granted
155       </code></p></div>
156
157       <p>Dans l'exemple suivant, tous les hôtes du domaine example.org
158       ont l'autorisation d'accès, tous les autres sont rejetés :</p>
159
160       <div class="example"><h3>version 2.2 :</h3><p><code>
161         
162         Order Deny,Allow<br />
163         Deny from all<br />
164         Allow from example.org
165       </code></p></div>
166       <div class="example"><h3>version 2.4 :</h3><p><code>
167         
168         Require host example.org
169       </code></p></div>
170     
171
172     
173
174     <h3><a name="config" id="config">Autres changements dans la configuration</a></h3>
175       
176
177       <p>D'autres ajustements mineurs peuvent s'avérer nécessaires pour
178       certaines configurations particulières, comme décrit ci-dessous.</p>
179
180       <ul>
181         <li><code class="directive">MaxRequestsPerChild</code> a été renommée en
182         <code class="directive"><a href="./mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code>;
183         ce nouveau nom reflète mieux l'usage de cette directive.
184         L'ancien nom est encore supporté.</li>
185
186         <li>La directive <code class="directive">MaxClients</code> a
187         été renommée en <code class="directive"><a href="./mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code>; ce nouveau
188         nom reflète mieux l'usage de cette directive. Pour les
189         modules multiprocessus asynchrones, comme <code class="module"><a href="./mod/event.html">event</a></code>, le nombre
190         maximal de clients n'est pas équivalent au nombre de threads du
191         worker. L'ancien nom est encore supporté.</li>
192
193         <li>La directive <code class="directive"><a href="./mod/core.html#defaulttype">DefaultType</a></code> ne produit plus aucun
194         effet, si ce n'est d'émettre un avertissement si elle est
195         définie à une valeur autre que <code>none</code>. D'autres
196         directives de configuration la remplacent dans la version 2.4.
197         </li>
198
199         <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>
200
201         <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"
202         (sans INode).</li>
203
204         <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>
205         correspond au nom du cookie dans son ensemble, alors qu'avant,
206         toute sous-chaîne pouvait correspondre.</li>
207
208         <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
209         avec inodes. L'ancien fichier <code class="directive"><a href="./mod/mod_dav_fs.html#davlockdb">DavLockDB</a></code> doit être supprimé dans le
210         cadre de la mise à jour.
211         </li>
212
213         <li>La directive <code class="directive"><a href="./mod/core.html#keepalive">KeepAlive</a></code>
214         n'accepte que les valeurs <code>On</code> ou <code>Off</code>.
215         Avant, toute valeur autre que "Off" ou "0" était traitée comme
216         "On".</li>
217
218         <li>Les directives AcceptMutex, LockFile, RewriteLock, SSLMutex,
219         SSLStaplingMutex et WatchdogMutexPath ont été remplacées par la
220         directive unique <code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code>.
221         Vous devez évaluer l'impact de ces directives obsolètes dans
222         votre configuration version 2.2 afin de déterminer si elles
223         peuvent être simplement supprimées, ou si elles doivent être
224         remplacées par la directive <code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code>.</li>
225
226         <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>
227         effectue maintenant une correspondance exacte dans la chaîne de
228         paramètres au lieu d'une correspondance partielle. Si votre
229         configuration mettait en jeu des sous-chaînes comme
230         <code>sessionid</code> pour correspondre à
231         <code>/une-application/image.gif;jsessionid=123456789</code>,
232         vous devez maintenant utiliser la chaîne de correspondance
233         complète <code>jsessionid</code>.
234         </li>
235
236         <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
237         maintenant exclusivement au sein d'une configuration de niveau
238         répertoire. Si vous utilisez cette directive, passez en revue
239         votre configuration pour vous assurer qu'elle est bien présente
240         dans tous les contextes de répertoire nécessaires.</li>
241
242         <li><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code>: la syntaxe de la directive
243         <code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code> utilise
244         maintenant une expression booléenne pour déterminer si un filtre
245         s'applique.
246         </li>
247
248         <li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code>:
249             <ul>
250             <li>L'élément <code>#if expr</code> utilise maintenant le
251             nouvel <a href="expr.html">interpréteur d'expressions</a>.
252             L'ancienne syntaxe peut être réactivée via la directive
253             <code class="directive"><a href="./mod/mod_include.html#ssilegacyexprparser">SSILegacyExprParser</a></code>.
254             </li>
255             <li>Dans la portée du répertoire, une directive de
256             configuration SSI* ne provoque plus la réinitialisation à
257             leur valeur par défaut de toutes les directives SSI* de
258             niveau répertoire.</li>
259             </ul>
260         </li>
261
262         <li><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code> : l'option
263         <code>DebugLevel</code> a été supprimée en faveur d'une
264         configuration de la directive <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> au niveau répertoire.
265         </li>
266
267         <li><code class="module"><a href="./mod/mod_ext-filter.html">mod_ext-filter</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.
270         </li>
271
272         <li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>: le contrôle de révocation des
273         certificats basé sur les CRL doit être maintenant explicitement
274         configuré via la directive <code class="directive"><a href="./mod/mod_ssl.html#sslcarevocationcheck">SSLCARevocationCheck</a></code>.
275         </li>
276
277         <li><code class="module"><a href="./mod/mod_substitute.html">mod_substitute</a></code>: la taille maximale d'une
278         ligne est maintenant 1Mo.
279         </li>
280
281         <li><code class="module"><a href="./mod/mod_reqtimeout.html">mod_reqtimeout</a></code>: si ce module est chargé, il
282         définit maintenant certains temps d'attente par défaut.</li>
283
284     </ul>
285     
286   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
287 <div class="section">
288 <h2><a name="misc" id="misc">Changements divers</a></h2>
289     
290
291     <ul>
292       <li><code class="module"><a href="./mod/mod_auto_index.html">mod_auto_index</a></code>: extrait maintenant les titres
293       et affiche la description pour les fichiers .xhtml qui étaient
294       jusqu'alors ignorés.</li>
295
296       <li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> : le format par défaut des variables
297       <code>*_DN</code> a changé. Il est cependant encore possible
298       d'utiliser l'ancien format via la nouvelle option
299       <code>LegacyDNStringFormat</code> de la directive <code class="directive"><a href="./mod/mod_ssl.html#ssloptions">SSLOptions</a></code>. Le protocole SSLv2 n'est
300       plus supporté.</li>
301
302       <li><code class="program"><a href="./programs/htpasswd.html">htpasswd</a></code> utilise maintenant par défaut les
303       condensés MD5 sur toutes les plates-formes.</li>
304
305       <li>La directive <code class="directive"><a href="./mod/core.html#namevirtualhost">NameVirtualHost</a></code> n'a plus aucun effet, si
306       ce n'est l'émission d'un avertissement. Toute combinaison
307       adresse/port apparaissant dans plusieurs serveurs virtuels est
308       traitée implicitement comme un serveur virtuel basé sur le nom.
309       </li>
310
311       <li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> n'effectue plus de compression
312       s'il s'aperçoit que la quantité de données ajoutée par la
313       compression est supérieure à la quantité de données à compresser.
314       </li>
315
316       <li>Les pages d'erreur multilingues de la version 2.2.x ne
317       fonctionneront qu'après avoir été corrigées pour
318       respecter la nouvelle syntaxe de l'élément <code>#if expr=</code>
319       du module <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>, ou si la directive
320       <code class="directive"><a href="./mod/mod_include.html#ssilegacyexprparser">SSILegacyExprParser</a></code> a
321       été activée pour le répertoire contenant les pages d'erreur.
322       </li>
323     </ul>
324
325     </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
326 <div class="section">
327 <h2><a name="third-party" id="third-party">Modules tiers</a></h2>
328     
329
330         <p>Tous les modules tiers doivent être recompilés pour la
331         version 2.4 avant d'être chargés.</p>
332
333     <p>De nombreux modules tiers conçus pour la version 2.2
334     fonctionneront sans changement avec le serveur HTTP Apache
335     version 2.4. Certains nécessiterons cependant des modifications ; se
336     reporter à la vue d'ensemble <a href="developer/new_api_2_4.html">Mise à jour de l'API</a>.</p>
337   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
338 <div class="section">
339 <h2><a name="commonproblems" id="commonproblems">Problèmes de mise à jour courants</a></h2>
340     
341     <ul><li>Erreurs au démarrage :
342     <ul>
343       <li><code>Invalid command 'User', perhaps misspelled or defined by
344       a module not included in the server configuration</code> - chargez
345       le module <code class="module"><a href="./mod/mod_unixd.html">mod_unixd</a></code></li>
346
347       <li><code>Invalid command 'Require', perhaps misspelled or defined
348       by a module not included in the server configuration</code>, ou
349       <code>Invalid command 'Order', perhaps misspelled or defined by a
350       module not included in the server configuration</code> - chargez
351       le module <code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code>, ou mettez à jour
352       vers la version 2.4 les directives d'autorisation.</li>
353       <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>
354
355       <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>
356
357       <li><code>Ignoring deprecated use of DefaultType in line NN of
358       /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
359       directives de configuration appropriées.</li>
360       <li><code>mixing * ports and non-* ports with a NameVirtualHost
361       address is not supported</code>, <code>Either NameVirtualHost
362       w.x.y.z:n has no VirtualHosts, or there is more than one identical
363       NameVirtualHost line, or your VirtualHost declarations do not
364       match the NameVirtualHost line</code> -
365       ce ne sont pas des nouveaux messages, mais ils empêchent
366       maintenant le serveur de démarrer</li>
367       <li><code>_default_ is not allowed in NameVirtualHost
368       directive</code> - l'explication est dans le message ; cette
369       définition n'a jamais été valide, mais elle empêche maintenant le
370       serveur de démarrer.</li>
371     </ul></li>
372     <li>Erreurs de traitement des requêtes :
373     <ul>
374       <li><code>configuration error:  couldn't check user: /path</code> -
375       chargez le module <code class="module"><a href="./mod/mod_authn_core.html">mod_authn_core</a></code>.</li>
376     </ul>
377     </li>
378 </ul>
379
380   </div></div>
381 <div class="bottomlang">
382 <p><span>Langues Disponibles: </span><a href="./en/upgrading.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
383 <a href="./fr/upgrading.html" title="Français">&nbsp;fr&nbsp;</a></p>
384 </div><div id="footer">
385 <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>
386 <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>
387 </body></html>