granicus.if.org Git - apache/blob - 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.3</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.3</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: le jeu de modules "most" est compilé par défaut</li>
  87     </ul>
  88
  89   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  90 <div class="section">
  91 <h2><a name="run-time" id="run-time">Modifications de la configuration à l'exécution</a></h2>
  92
  93 <p>Des changements significatifs dans la configuration de
  94 l'autorisation, ainsi que quelques changements mineurs, peuvent
  95 nécessiter une mise à jour des fichiers de configuration de la version
  96 2.2 avant de les utiliser sous la version 2.4.</p>
  97
  98     <h3><a name="authz" id="authz">Autorisation</a></h3>
  99
 100
 101       <p>Tout fichier de configuration qui gère des autorisations devra
 102       probablement être mis à jour.</p>
 103
 104     <p>Vous devez vous reporter au document <a href="howto/auth.html">Authentification, autorisation et contrôle
 105     d'accès</a>, et plus particulièrement à la section <a href="howto/auth.html#beyond">Plus loin qu'une simple
 106     autorisation</a> qui explique les nouveaux mécanismes permettant de
 107     contrôler l'ordre dans lequel les directives d'autorisation sont
 108     appliquées.</p>
 109
 110     <h4><a name="access" id="access">Contrôle d'accès</a></h4>
 111
 112
 113       <p>Dans la version 2.2, le contrôle d'accès basé sur le nom d'hôte
 114       du client, son adresse IP, ou d'autres caractéristiques de la
 115       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>
 116
 117       <p>Dans la version 2.4, ce contrôle d'accès est assuré, comme tout
 118       contrôle d'autorisation, via le nouveau module
 119       <code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code>. Bien que le module
 120       <code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code> soit fourni à des fins de
 121       compatibilité avec les anciennes configurations, les anciennes
 122       directives de contrôle d'accès devront être remplacées par les
 123       nouveaux mécanismes d'authentification.</p>
 124
 125       <p>Voici quelques exemples de contrôle d'accès avec l'ancienne et
 126       la nouvelle méthode :</p>
 127
 128       <p>Dans cet exemple, toutes les requêtes sont rejetées :</p>
 129       <div class="example"><h3>version 2.2 :</h3><p><code>
 130
 131         Order deny,allow<br />
 132         Deny from all
 133       </code></p></div>
 134       <div class="example"><h3>version 2.4 :</h3><p><code>
 135
 136         Require all denied
 137       </code></p></div>
 138
 139       <p>Dans cet exemple, toutes les requêtes sont acceptées :</p>
 140       <div class="example"><h3>version 2.2 :</h3><p><code>
 141
 142         Order allow,deny<br />
 143         Allow from all
 144       </code></p></div>
 145       <div class="example"><h3>version 2.4 :</h3><p><code>
 146
 147         Require all granted
 148       </code></p></div>
 149
 150       <p>Dans l'exemple suivant, tous les hôtes du domaine example.org
 151       ont l'autorisation d'accès, tous les autres sont rejetés :</p>
 152
 153       <div class="example"><h3>version 2.2 :</h3><p><code>
 154
 155         Order Deny,Allow<br />
 156         Deny from all<br />
 157         Allow from example.org
 158       </code></p></div>
 159       <div class="example"><h3>version 2.4 :</h3><p><code>
 160
 161         Require host example.org
 162       </code></p></div>
 163
 164
 165
 166
 167     <h3><a name="config" id="config">Autres changements dans la configuration</a></h3>
 168
 169
 170       <p>D'autres ajustements mineurs peuvent s'avérer nécessaires pour
 171       certaines configurations particulières, comme décrit ci-dessous.</p>
 172
 173       <ul>
 174         <li><code class="directive">MaxRequestsPerChild</code> a été renommée en
 175         <code class="directive"><a href="./mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code>;
 176         ce nouveau nom reflète mieux l'usage de cette directive.
 177         L'ancien nom est encore supporté.</li>
 178
 179         <li>La directive <code class="directive">MaxClients</code> a
 180         été renommée en <code class="directive"><a href="./mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code>; ce nouveau
 181         nom reflète mieux l'usage de cette directive. Pour les
 182         modules multiprocessus asynchrones, comme <code class="module"><a href="./mod/event.html">event</a></code>, le nombre
 183         maximal de clients n'est pas équivalent au nombre de threads du
 184         worker. L'ancien nom est encore supporté.</li>
 185
 186         <li>La directive <code class="directive"><a href="./mod/core.html#defaulttype">DefaultType</a></code> ne produit plus aucun
 187         effet, si ce n'est d'émettre un avertissement si elle est
 188         définie à une valeur autre que <code>none</code>. D'autres
 189         directives de configuration la remplacent dans la version 2.4.
 190         </li>
 191
 192         <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>
 193
 194         <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>
 195         correspond au nom du cookie dans son ensemble, alors qu'avant,
 196         toute sous-chaîne pouvait correspondre.</li>
 197
 198         <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
 199         avec inodes. L'ancien fichier <code class="directive"><a href="./mod/mod_dav_fs.html#davlockdb">DavLockDB</a></code> doit être supprimé dans le
 200         cadre de la mise à jour.
 201         </li>
 202
 203         <li>La directive <code class="directive"><a href="./mod/core.html#keepalive">KeepAlive</a></code>
 204         n'accepte que les valeurs <code>On</code> ou <code>Off</code>.
 205         Avant, toute valeur autre que "Off" ou "0" était traitée comme
 206         "On".</li>
 207
 208         <li>Les directives AcceptMutex, LockFile, RewriteLock, SSLMutex,
 209         SSLStaplingMutex et WatchdogMutexPath ont été remplacées par la
 210         directive unique <code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code>.
 211         Vous devez évaluer l'impact de ces directives obsolètes dans
 212         votre configuration version 2.2 afin de déterminer si elles
 213         peuvent être simplement supprimées, ou si elles doivent être
 214         remplacées par la directive <code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code>.</li>
 215
 216         <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>
 217         effectue maintenant une correspondance exacte dans la chaîne de
 218         paramètres au lieu d'une correspondance partielle. Si votre
 219         configuration mettait en jeu des sous-chaînes comme
 220         <code>sessionid</code> pour correspondre à
 221         <code>/une-application/image.gif;jsessionid=123456789</code>,
 222         vous devez maintenant utiliser la chaîne de correspondance
 223         complète <code>jsessionid</code>.
 224         </li>
 225
 226         <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
 227         maintenant exclusivement au sein d'une configuration de niveau
 228         répertoire. Si vous utilisez cette directive, passez en revue
 229         votre configuration pour vous assurer qu'elle est bien présente
 230         dans tous les contextes de répertoire nécessaires.</li>
 231
 232         <li><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code>: la syntaxe de la directive
 233         <code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code> utilise
 234         maintenant une expression booléenne pour déterminer si un filtre
 235         s'applique.
 236         </li>
 237
 238         <li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code>:
 239             <ul>
 240             <li>L'élément <code>#if expr</code> utilise maintenant le
 241             nouvel <a href="expr.html">interpréteur d'expressions</a>.
 242             L'ancienne syntaxe peut être réactivée via la directive
 243             <code class="directive"><a href="./mod/mod_include.html#ssilegacyexprparser">SSILegacyExprParser</a></code>.
 244             </li>
 245             <li>Dans la portée du répertoire, une directive de
 246             configuration SSI* ne provoque plus la réinitialisation à
 247             leur valeur par défaut de toutes les directives SSI* de
 248             niveau répertoire.</li>
 249             </ul>
 250         </li>
 251
 252         <li><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code> : l'option
 253         <code>DebugLevel</code> a été supprimée en faveur d'une
 254         configuration de la directive <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> au niveau répertoire.
 255         </li>
 256
 257         <li><code class="module"><a href="./mod/mod_ext-filter.html">mod_ext-filter</a></code> : l'option
 258         <code>DebugLevel</code> a été supprimée en faveur d'une
 259         configuration de la directive <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> au niveau répertoire.
 260         </li>
 261
 262     </ul>
 263
 264   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 265 <div class="section">
 266 <h2><a name="misc" id="misc">Changements divers</a></h2>
 267
 268
 269     <ul>
 270       <li><code class="module"><a href="./mod/mod_auto_index.html">mod_auto_index</a></code>: extrait maintenant les titres
 271       et affiche la description pour les fichiers .xhtml qui étaient
 272       jusqu'alors ignorés.</li>
 273
 274       <li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> : le format par défaut des variables
 275       <code>*_DN</code> a changé. Il est cependant encore possible
 276       d'utiliser l'ancien format via la nouvelle option
 277       <code>LegacyDNStringFormat</code> de la directive <code class="directive"><a href="./mod/mod_ssl.html#ssloptions">SSLOptions</a></code>.</li>
 278
 279       <li><code class="program"><a href="./programs/htpasswd.html">htpasswd</a></code> utilise maintenant par défaut les
 280       condensés MD5 sur toutes les plates-formes.</li>
 281
 282       <li>La directive <code class="directive"><a href="./mod/core.html#namevirtualhost">NameVirtualHost</a></code> n'a plus aucun effet, si
 283       ce n'est l'émission d'un avertissement. Toute combinaison
 284       adresse/port apparaissant dans plusieurs serveurs virtuels est
 285       traitée implicitement comme un serveur virtuel basé sur le nom.
 286       </li>
 287
 288       <li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> n'effectue plus de compression
 289       s'il s'aperçoit que la quantité de données ajoutée par la
 290       compression est supérieure à la quantité de données à compresser.
 291       </li>
 292     </ul>
 293
 294     </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 295 <div class="section">
 296 <h2><a name="third-party" id="third-party">Modules tiers</a></h2>
 297
 298
 299         <p>Tous les modules tiers doivent être recompilés pour la
 300         version 2.4 avant d'être chargés.</p>
 301
 302     <p>De nombreux modules tiers conçus pour la version 2.2
 303     fonctionneront sans changement avec le serveur HTTP Apache
 304     version 2.4. Certains nécessiterons cependant des modifications ; se
 305     reporter à la vue d'ensemble <a href="developer/new_api_2_4.html">Mise à jour de l'API</a>.</p>
 306   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 307 <div class="section">
 308 <h2><a name="commonproblems" id="commonproblems">Problèmes de mise à jour courants</a></h2>
 309
 310     <ul><li>Erreurs au démarrage :
 311     <ul>
 312       <li><code>Invalid command 'User', perhaps misspelled or defined by
 313       a module not included in the server configuration</code> - chargez
 314       le module <code class="module"><a href="./mod/mod_unixd.html">mod_unixd</a></code></li>
 315
 316       <li><code>Invalid command 'Require', perhaps misspelled or defined
 317       by a module not included in the server configuration</code>, ou
 318       <code>Invalid command 'Order', perhaps misspelled or defined by a
 319       module not included in the server configuration</code> - chargez
 320       le module <code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code>, ou mettez à jour
 321       vers la version 2.4 les directives d'autorisation.</li>
 322       <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>
 323
 324       <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>
 325
 326       <li><code>Ignoring deprecated use of DefaultType in line NN of
 327       /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
 328       directives de configuration appropriées.</li>
 329       <li><code>mixing * ports and non-* ports with a NameVirtualHost
 330       address is not supported</code>, <code>Either NameVirtualHost
 331       w.x.y.z:n has no VirtualHosts, or there is more than one identical
 332       NameVirtualHost line, or your VirtualHost declarations do not
 333       match the NameVirtualHost line</code> -
 334       ce ne sont pas des nouveaux messages, mais ils empêchent
 335       maintenant le serveur de démarrer</li>
 336       <li><code>_default_ is not allowed in NameVirtualHost
 337       directive</code> - l'explication est dans le message ; cette
 338       définition n'a jamais été valide, mais elle empêche maintenant le
 339       serveur de démarrer.</li>
 340     </ul></li>
 341     <li>Erreurs de traitement des requêtes :
 342     <ul>
 343       <li><code>configuration error:  couldn't check user: /path</code> -
 344       chargez le module <code class="module"><a href="./mod/mod_authn_core.html">mod_authn_core</a></code>.</li>
 345     </ul>
 346     </li>
 347 </ul>
 348
 349   </div></div>
 350 <div class="bottomlang">
 351 <p><span>Langues Disponibles: </span><a href="./en/upgrading.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 352 <a href="./fr/upgrading.html" title="Français">&nbsp;fr&nbsp;</a></p>
 353 </div><div id="footer">
 354 <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>
 355 <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>
 356 </body></html>