Apache HTTP Server Documentation Version 2.2 - The Apache Software Foundation

803 Pages·2015·2.5 MB·English

by  Apache Software Foundation

Apache HTTP Server Documentation Version 2.2
ApacheSoftwareFoundation
July19,2015
ii
About The PDF Documentation
Copyright(cid:13)c2015TheApacheSoftwareFoundation
LicensedundertheApacheLicense,Version2.0(the”License”);youmaynotusethisfileexceptincompliancewith
theLicense. YoumayobtainacopyoftheLicenseathttp://www.apache.org/licenses/LICENSE-2.0
This version of the Apache HTTP Server Documentation is converted from XML source files to LATEX using XSLT
withthehelpofApacheAnt,ApacheXMLXalan,andApacheXMLXerces.
Since the HTML version of the documentation is more commonly checked during development, the PDF ver-
sion may contain some errors and inconsistencies, especially in formatting. If you have difficulty reading a
part of this file, please consult the HTML version of the documentation on the Apache HTTP Server website at
http://httpd.apache.org/docs/2.2/
TheApacheHTTPServerDocumentationismaintainedbytheApacheHTTPServerDocumentationProject. More
informationisavailableathttp://httpd.apache.org/docs-project/
Contents
1 ReleaseNotes 1
1.1 Upgradingto2.2from2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2 OverviewofnewfeaturesinApache2.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.3 OverviewofnewfeaturesinApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.4 TheApacheLicense,Version2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2 UsingtheApacheHTTPServer 13
2.1 CompilingandInstalling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.2 StartingApache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.3 StoppingandRestarting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.4 ConfigurationFiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
2.5 ConfigurationSections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
2.6 CachingGuide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
2.7 Server-WideConfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
2.8 LogFiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
2.9 MappingURLstoFilesystemLocations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
2.10 DynamicSharedObject(DSO)Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
2.11 ContentNegotiation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
2.12 CustomErrorResponses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
2.13 Binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
2.14 Multi-ProcessingModules(MPMs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
2.15 EnvironmentVariablesinApache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
2.16 Apache’sHandlerUse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
2.17 Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
2.18 suEXECSupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
2.19 IssuesRegardingDNSandApache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
3 ApacheVirtualHostdocumentation 91
3.1 ApacheVirtualHostdocumentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
iii
iv CONTENTS
3.2 Name-basedVirtualHostSupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
3.3 ApacheIP-basedVirtualHostSupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
3.4 Dynamicallyconfiguredmassvirtualhosting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
3.5 VirtualHostExamples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
3.6 AnIn-DepthDiscussionofVirtualHostMatching . . . . . . . . . . . . . . . . . . . . . . . . . . 111
3.7 FileDescriptorLimits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
4 URLRewritingGuide 117
4.1 Apachemod rewrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
4.2 Apachemod rewriteIntroduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
4.3 RedirectingandRemappingwithmod rewrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
4.4 Usingmod rewritetocontrolaccess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
4.5 Dynamicmassvirtualhostswithmod rewrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
4.6 Usingmod rewriteforProxying . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
4.7 UsingRewriteMap. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
4.8 AdvancedTechniqueswithmod rewrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
4.9 Whennottousemod rewrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
4.10 RewriteRuleFlags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
4.11 Apachemod rewriteTechnicalDetails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
5 ApacheSSL/TLSEncryption 165
5.1 ApacheSSL/TLSEncryption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
5.2 SSL/TLSStrongEncryption: AnIntroduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
5.3 SSL/TLSStrongEncryption: Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
5.4 SSL/TLSStrongEncryption: How-To . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
5.5 SSL/TLSStrongEncryption: FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
6 Guides,Tutorials,andHowTos 201
6.1 How-To/Tutorials. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
6.2 AuthenticationandAuthorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
6.3 AccessControl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
6.4 ApacheTutorial: DynamicContentwithCGI . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
6.5 ApacheTutorial: IntroductiontoServerSideIncludes . . . . . . . . . . . . . . . . . . . . . . . . 217
6.6 ApacheHTTPServerTutorial: .htaccessfiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
6.7 Per-userwebdirectories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
7 Platform-specificNotes 231
7.1 PlatformSpecificNotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
7.2 UsingApacheHTTPServeronMicrosoftWindows . . . . . . . . . . . . . . . . . . . . . . . . . 233
CONTENTS v
7.3 CompilingApacheforMicrosoftWindows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
7.4 UsingApacheWithNovellNetWare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
7.5 RunningaHigh-PerformanceWebServeronHPUX . . . . . . . . . . . . . . . . . . . . . . . . . 256
7.6 TheApacheEBCDICPort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
8 ApacheHTTPServerandSupportingPrograms 261
8.1 ServerandSupportingPrograms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
8.2 httpd-ApacheHypertextTransferProtocolServer . . . . . . . . . . . . . . . . . . . . . . . . . . 263
8.3 ab-ApacheHTTPserverbenchmarkingtool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
8.4 apachectl-ApacheHTTPServerControlInterface. . . . . . . . . . . . . . . . . . . . . . . . . . 268
8.5 apxs-APacheeXtenSiontool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
8.6 configure-Configurethesourcetree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
8.7 dbmmanage-ManageuserauthenticationfilesinDBMformat . . . . . . . . . . . . . . . . . . . 284
8.8 htcacheclean-Cleanupthediskcache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
8.9 htdbm-ManipulateDBMpassworddatabases . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
8.10 htdigest-manageuserfilesfordigestauthentication . . . . . . . . . . . . . . . . . . . . . . . . . 290
8.11 htpasswd-Manageuserfilesforbasicauthentication . . . . . . . . . . . . . . . . . . . . . . . . 291
8.12 httxt2dbm-GeneratedbmfilesforusewithRewriteMap . . . . . . . . . . . . . . . . . . . . . . 294
8.13 logresolve-ResolveIP-addressestohostnamesinApachelogfiles . . . . . . . . . . . . . . . . . 295
8.14 rotatelogs-PipedloggingprogramtorotateApachelogs . . . . . . . . . . . . . . . . . . . . . . 296
8.15 suexec-Switchuserbeforeexecutingexternalprograms. . . . . . . . . . . . . . . . . . . . . . . 298
8.16 OtherPrograms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
9 ApacheMiscellaneousDocumentation 301
9.1 ApacheMiscellaneousDocumentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
9.2 ApachePerformanceTuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
9.3 SecurityTips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
9.4 RelevantStandards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
9.5 PasswordFormats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
10 Apachemodules 325
10.1 TermsUsedtoDescribeModules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
10.2 TermsUsedtoDescribeDirectives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
10.3 ApacheModulecore. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
10.4 ApacheModulemod actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
10.5 ApacheModulemod alias. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
10.6 ApacheModulemod asis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
10.7 ApacheModulemod auth basic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387
10.8 ApacheModulemod auth digest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
vi CONTENTS
10.9 ApacheModulemod authn alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
10.10 ApacheModulemod authn anon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
10.11 ApacheModulemod authn dbd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
10.12 ApacheModulemod authn dbm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
10.13 ApacheModulemod authn default . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
10.14 ApacheModulemod authn file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
10.15 ApacheModulemod authnz ldap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406
10.16 ApacheModulemod authz dbm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
10.17 ApacheModulemod authz default . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
10.18 ApacheModulemod authz groupfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
10.19 ApacheModulemod authz host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
10.20 ApacheModulemod authz owner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
10.21 ApacheModulemod authz user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
10.22 ApacheModulemod autoindex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
10.23 ApacheModulemod cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
10.24 ApacheModulemod cern meta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
10.25 ApacheModulemod cgi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
10.26 ApacheModulemod cgid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
10.27 ApacheModulemod charset lite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
10.28 ApacheModulemod dav . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
10.29 ApacheModulemod dav fs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
10.30 ApacheModulemod dav lock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
10.31 ApacheModulemod dbd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468
10.32 ApacheModulemod deflate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473
10.33 ApacheModulemod dir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479
10.34 ApacheModulemod disk cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
10.35 ApacheModulemod dumpio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485
10.36 ApacheModulemod echo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487
10.37 ApacheModulemod env . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488
10.38 ApacheModulemod example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
10.39 ApacheModulemod expires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492
10.40 ApacheModulemod ext filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
10.41 ApacheModulemod file cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501
10.42 ApacheModulemod filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504
10.43 ApacheModulemod headers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511
10.44 ApacheModulemod ident . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516
10.45 ApacheModulemod imagemap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518
CONTENTS vii
10.46 ApacheModulemod include . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522
10.47 ApacheModulemod info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
10.48 ApacheModulemod isapi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536
10.49 ApacheModulemod ldap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540
10.50 ApacheModulemod log config . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549
10.51 ApacheModulemod log forensic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
10.52 ApacheModulemod logio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557
10.53 ApacheModulemod mem cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558
10.54 ApacheModulemod mime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562
10.55 ApacheModulemod mime magic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575
10.56 ApacheModulemod negotiation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579
10.57 ApacheModulemod nw ssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583
10.58 ApacheModulemod proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584
10.59 ApacheModulemod proxy ajp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608
10.60 ApacheModulemod proxy balancer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
10.61 ApacheModulemod proxy connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623
10.62 ApacheModulemod proxy ftp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 624
10.63 ApacheModulemod proxy http . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 626
10.64 ApacheModulemod proxy scgi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628
10.65 ApacheModulemod reqtimeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630
10.66 ApacheModulemod rewrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 632
10.67 ApacheModulemod setenvif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649
10.68 ApacheModulemod so . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653
10.69 ApacheModulemod speling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 655
10.70 ApacheModulemod ssl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657
10.71 ApacheModulemod status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688
10.72 ApacheModulemod substitute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 690
10.73 ApacheModulemod suexec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 692
10.74 ApacheModulemod unique id . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693
10.75 ApacheModulemod userdir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695
10.76 ApacheModulemod usertrack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697
10.77 ApacheModulemod version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 701
10.78 ApacheModulemod vhost alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703
10.79 ApacheModulebeos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707
10.80 ApacheModulempm common . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 709
10.81 ApacheModuleevent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 722
10.82 ApacheModulempm netware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724
viii CONTENTS
10.83 ApacheModulempmt os2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 726
10.84 ApacheModuleprefork . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 727
10.85 ApacheModulempm winnt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 730
10.86 ApacheModuleworker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 732
11 DeveloperDocumentation 735
11.1 DeveloperDocumentationforApache2.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 736
11.2 Apache1.3APInotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 737
11.3 DebuggingMemoryAllocationinAPR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753
11.4 DocumentingApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 754
11.5 Apache2.0HookFunctions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 755
11.6 ConvertingModulesfromApache1.3toApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . 758
11.7 RequestProcessingintheApacheHTTPServer2.x . . . . . . . . . . . . . . . . . . . . . . . . . 762
11.8 HowfiltersworkinApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 766
11.9 Apache2.0ThreadSafetyIssues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769
12 GlossaryandIndex 773
12.1 Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 774
12.2 ModuleIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 779
12.3 DirectiveQuickReference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 782
Chapter 1
Release Notes
1
2 CHAPTER1. RELEASENOTES
1.1 Upgrading to 2.2 from 2.0
Inordertoassistfolksupgrading, wemaintainadocumentdescribinginformationcriticaltoexistingApacheusers.
Theseareintendedtobebriefnotes,andyoushouldbeabletofindmoreinformationineithertheNewFeatures(p.4)
document,orinthesrc/CHANGESfile.
This document describes only the changes from 2.0 to 2.2. If you are upgrading from version 1.3, you should also
consultthe1.3to2.0upgradingdocument.1
Seealso
• OverviewofnewfeaturesinApache2.2(p.4)
Compile-TimeConfigurationChanges
The compilation process is very similar to the one used in version 2.0. Your old configure command line (as
foundinbuild/config.niceintheinstalledserverdirectory)canbeusedinsomecases. Themostsignificant
changerequiredwillbetoaccountforchangesinmodulenames,inparticularfortheauthenticationandauthorization
modules. Somedetailsofchanges:
• mod imaphasbeenrenamedtoMOD IMAGEMAP
• mod auth has been split up into MOD AUTH BASIC, MOD AUTHN FILE, MOD AUTHZ USER, and
MOD AUTHZ GROUPFILE
• mod accesshasbeenrenamedtoMOD AUTHZ HOST
• mod auth ldaphasbeenrenamedtoMOD AUTHNZ LDAP
• UpgradedtorequiretheAPR1.0API.
• UpdatedbundledPCREversionto5.0
Run-TimeConfigurationChanges
Your existing version 2.0 config files and startup scripts can usually be used unchanged in version 2.2. Some small
adjustmentsmaybenecessaryforparticularconfigurationsasdiscussedbelow. Inaddition,ifyoudynamicallyload
thestandardmodulesusingtheLOADMODULEdirective,thenyouwillneedtoaccountforthemodulenamechanges
mentionedabove.
Ifyouchoosetousethenewdefaultconfigurationfileforversion2.2,youwillfindthatithasbeengreatlysimplifiedby
removingallbutthemostessentialconfigurationsettings. Asetofexampleconfigurationsettingsformoreadvanced
featuresispresentintheconf/extra/directoryoftheinstalledserver. Defaultconfigurationfilesareinstalledin
theconf/originaldirectory.
Someruntimeconfigurationchangesthatyoumaynotice:
• The apachectl option startssl is no longer available. To enable SSL support, you should edit
httpd.conftoincludetherelevantMOD SSLdirectivesandthenuseapachectl starttostarttheserver.
AnexampleconfigurationtoactivateMOD SSLhasbeenincludedinconf/extra/httpd-ssl.conf.
• ThedefaultsettingofUSECANONICALNAMEisnowOff. Ifyoudidnothavethisdirectiveinyourconfigfile,
youcanaddUseCanonicalName Ontoretaintheoldbehavior.
• The module MOD USERDIR will no longer act on requests unless a USERDIR directive specifying a direc-
tory name is present in the config file. To restore the old default behavior, place the directive UserDir
public htmlinyourconfigfile.
1http://httpd.apache.org/docs/2.0/upgrading.html