github.com/krum110487/go-htaccess@v0.0.0-20240316004156-60641c8e7598/tests/data/apache_2_2_34/manual/upgrading.html.en (about) 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="en" xml:lang="en"><head> 4 <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" /> 5 <!-- 6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 7 This file is generated from xml source: DO NOT EDIT 8 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 9 --> 10 <title>Upgrading to 2.2 from 2.0 - Apache HTTP Server Version 2.2</title> 11 <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> 12 <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> 13 <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" /> 14 <script src="./style/scripts/prettify.min.js" type="text/javascript"> 15 </script> 16 17 <link href="./images/favicon.ico" rel="shortcut icon" /><link href="http://httpd.apache.org/docs/current/upgrading.html" rel="canonical" /></head> 18 <body id="manual-page"><div id="page-header"> 19 <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">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p> 20 <p class="apache">Apache HTTP Server Version 2.2</p> 21 <img alt="" src="./images/feather.gif" /></div> 22 <div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div> 23 <div id="path"> 24 <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.2</a></div><div id="page-content"><div class="retired"><h4>Please note</h4> 25 <p> This document refers to a legacy release (<strong>2.2</strong>) of Apache httpd. The active release (<strong>2.4</strong>) is documented <a href="http://httpd.apache.org/docs/current">here</a>. If you have not already upgraded, please follow <a href="http://httpd.apache.org/docs/current/upgrading.html">this link</a> for more information.</p> 26 <p>You may follow <a href="http://httpd.apache.org/docs/current/upgrading.html">this link</a> to go to the current version of this document.</p></div><div id="preamble"><h1>Upgrading to 2.2 from 2.0</h1> 27 <div class="toplang"> 28 <p><span>Available Languages: </span><a href="./de/upgrading.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | 29 <a href="./en/upgrading.html" title="English"> en </a> | 30 <a href="./fr/upgrading.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | 31 <a href="./ja/upgrading.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> 32 </div> 33 34 <p>In order to assist folks upgrading, we maintain a document 35 describing information critical to existing Apache users. These 36 are intended to be brief notes, and you should be able to find 37 more information in either the <a href="new_features_2_2.html">New Features</a> document, or in 38 the <code>src/CHANGES</code> file.</p> 39 40 <p>This document describes only the changes from 2.0 to 2.2. If you 41 are upgrading from version 1.3, you should also consult the <a href="http://httpd.apache.org/docs/2.0/upgrading.html">1.3 to 2.0 42 upgrading document.</a></p> 43 44 </div> 45 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#compile-time">Compile-Time Configuration Changes</a></li> 46 <li><img alt="" src="./images/down.gif" /> <a href="#run-time">Run-Time Configuration Changes</a></li> 47 <li><img alt="" src="./images/down.gif" /> <a href="#misc">Misc Changes</a></li> 48 <li><img alt="" src="./images/down.gif" /> <a href="#third-party">Third Party Modules</a></li> 49 </ul><h3>See also</h3><ul class="seealso"><li><a href="new_features_2_2.html">Overview of new features in 50 Apache 2.2</a></li></ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> 51 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> 52 <div class="section"> 53 <h2><a name="compile-time" id="compile-time">Compile-Time Configuration Changes</a></h2> 54 55 56 <p>The compilation process is very similar to the one used in 57 version 2.0. Your old <code>configure</code> command line (as 58 found in <code>build/config.nice</code> in the installed server 59 directory) can be used in some cases. The most significant change 60 required will be to account for changes in module names, in 61 particular for the authentication and authorization modules. 62 Some details of changes:</p> 63 64 <ul> 65 <li>mod_imap has been renamed to <code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code></li> 66 <li>mod_auth has been split up into <code class="module"><a href="./mod/mod_auth_basic.html">mod_auth_basic</a></code>, 67 <code class="module"><a href="./mod/mod_authn_file.html">mod_authn_file</a></code>, <code class="module"><a href="./mod/mod_authz_user.html">mod_authz_user</a></code>, and 68 <code class="module"><a href="./mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code></li> 69 <li>mod_access has been renamed to <code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code></li> 70 <li>mod_auth_ldap has been renamed to <code class="module"><a href="./mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code></li> 71 <li>Upgraded to require the APR 1.0 API.</li> 72 <li>Updated bundled PCRE version to 5.0</li> 73 </ul> 74 75 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> 76 <div class="section"> 77 <h2><a name="run-time" id="run-time">Run-Time Configuration Changes</a></h2> 78 79 80 <p>Your existing version 2.0 config files and startup scripts can 81 usually be used unchanged in version 2.2. Some small 82 adjustments may be necessary for particular configurations as 83 discussed below. In addition, if you dynamically load the 84 standard modules using the <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> directive, then you will 85 need to account for the module name changes mentioned above.</p> 86 87 <p>If you choose to use the new default 88 configuration file for version 2.2, you will find that it has 89 been greatly simplified by removing all but the most essential 90 configuration settings. A set of example configuration settings 91 for more advanced features is present in the 92 <code>conf/extra/</code> directory of the installed server. Default 93 configuration files are installed in the <code>conf/original</code> 94 directory.</p> 95 96 <p>Some runtime configuration changes that you may notice:</p> 97 98 <ul> 99 <li>The <code class="program"><a href="./programs/apachectl.html">apachectl</a></code> option 100 <code>startssl</code> is no longer available. To enable SSL 101 support, you should edit <code>httpd.conf</code> to include the 102 relevant <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> directives and then use 103 <code>apachectl start</code> to start the server. An example 104 configuration to activate <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> has been 105 included in <code>conf/extra/httpd-ssl.conf</code>.</li> 106 107 <li>The default setting of <code class="directive"><a href="./mod/core.html#usecanonicalname">UseCanonicalName</a></code> is now 108 <code>Off</code>. If you did not have this directive in your 109 config file, you can add <code>UseCanonicalName On</code> to 110 retain the old behavior.</li> 111 112 <li>The module <code class="module"><a href="./mod/mod_userdir.html">mod_userdir</a></code> will no longer act 113 on requests unless a <code class="directive"><a href="./mod/mod_userdir.html#userdir">UserDir</a></code> directive specifying a 114 directory name is present in the config file. To restore the 115 old default behavior, place the directive <code>UserDir 116 public_html</code> in your config file.</li> 117 118 <li>The directive <code class="directive">AuthDigestFile</code> 119 from <code class="module"><a href="./mod/mod_auth_digest.html">mod_auth_digest</a></code> has been merged with 120 <code class="directive"><a href="./mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code> 121 and is now part of <code class="module"><a href="./mod/mod_authn_file.html">mod_authn_file</a></code>.</li> 122 123 <li><code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> directives 124 are evaluated before <code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code> ones.</li> 125 </ul> 126 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> 127 <div class="section"> 128 <h2><a name="misc" id="misc">Misc Changes</a></h2> 129 130 131 <ul> 132 <li>The module <code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>, which was 133 experimental in Apache 2.0, is now a standard module.</li> 134 135 <li>The module <code class="module"><a href="./mod/mod_disk_cache.html">mod_disk_cache</a></code>, which was 136 experimental in Apache 2.0, is now a standard module.</li> 137 138 <li>The module <code class="module"><a href="./mod/mod_mem_cache.html">mod_mem_cache</a></code>, which was 139 experimental in Apache 2.0, is now a standard module.</li> 140 141 <li>The module <code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code>, which was 142 experimental in Apache 2.0, is now a standard module.</li> 143 144 <li>The module <code class="module"><a href="./mod/mod_dumpio.html">mod_dumpio</a></code>, which was 145 experimental in Apache 2.0, is now a standard module.</li> 146 147 </ul> 148 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div> 149 <div class="section"> 150 <h2><a name="third-party" id="third-party">Third Party Modules</a></h2> 151 152 153 <p>Many third-party modules designed for version 2.0 will work 154 unchanged with the Apache HTTP Server version 2.2. But all 155 modules must be recompiled before being loaded.</p> 156 157 </div></div> 158 <div class="bottomlang"> 159 <p><span>Available Languages: </span><a href="./de/upgrading.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | 160 <a href="./en/upgrading.html" title="English"> en </a> | 161 <a href="./fr/upgrading.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | 162 <a href="./ja/upgrading.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> 163 </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">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> 164 <script type="text/javascript"><!--//--><![CDATA[//><!-- 165 var comments_shortname = 'httpd'; 166 var comments_identifier = 'http://httpd.apache.org/docs/2.2/upgrading.html'; 167 (function(w, d) { 168 if (w.location.hostname.toLowerCase() == "httpd.apache.org") { 169 d.write('<div id="comments_thread"><\/div>'); 170 var s = d.createElement('script'); 171 s.type = 'text/javascript'; 172 s.async = true; 173 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; 174 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); 175 } 176 else { 177 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); 178 } 179 })(window, document); 180 //--><!]]></script></div><div id="footer"> 181 <p class="apache">Copyright 2017 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> 182 <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">Glossary</a> | <a href="./sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- 183 if (typeof(prettyPrint) !== 'undefined') { 184 prettyPrint(); 185 } 186 //--><!]]></script> 187 </body></html>