Table Of ContentApache 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
Description:This version of the Apache HTTP Server Documentation is converted from XML source files to LATEX using XSLT with the help of Apache Ant, Apache XML Xalan, and Apache XML Xerces. Since the HTML version of the documentation is more commonly checked during development, the PDF ver-.
