Chapter 4 Apache Server Frequently Asked Questions

669 Pages·2004·3.19 MB·English

by  Apache Software Foundation

Apache HTTP Server Documentation Version 2.0
ApacheSoftwareFoundation
April2,2004
ii
About The PDF Documentation
Copyright(cid:13)c2004TheApacheSoftwareFoundation
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.
SincetheHTMLversionofthedocumentationismorecommonlycheckedduringdevelopment,thePDFversionmay
containsomeerrorsandinconsistencies,especiallyinformatting.Ifyouhavedifficultyreadingapartofthisfile,please
consulttheHTMLversionofthedocumentationontheApacheHTTPServerwebsiteathttp://httpd.apache.org/docs-
2.0/
TheApacheHTTPServerDocumentationismaintainedbytheApacheHTTPServerDocumentationProject. More
informationisavailableathttp://httpd.apache.org/docs-project/
Contents
1 ReleaseNotes 1
1.1 Upgradingto2.0from1.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2 OverviewofnewfeaturesinApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.3 TheApacheLicense,Version2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2 UsingtheApacheHTTPServer 9
2.1 CompilingandInstalling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.2 StartingApache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.3 StoppingandRestarting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.4 ConfigurationFiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.5 ConfigurationSections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.6 Server-WideConfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
2.7 LogFiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
2.8 MappingURLstoFilesystemLocations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
2.9 SecurityTips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
2.10 DynamicSharedObject(DSO)Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
2.11 ContentNegotiation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
2.12 CustomErrorResponses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
2.13 Binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
2.14 Multi-ProcessingModules(MPMs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
2.15 EnvironmentVariablesinApache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
2.16 Apache’sHandlerUse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
2.17 Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
2.18 suEXECSupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
2.19 ApachePerformanceTuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
2.20 URLRewritingGuide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
3 ApacheVirtualHostdocumentation 111
3.1 ApacheVirtualHostdocumentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
iii
iv CONTENTS
3.2 Name-basedVirtualHostSupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
3.3 ApacheIP-basedVirtualHostSupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
3.4 Dynamicallyconfiguredmassvirtualhosting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
3.5 VirtualHostExamples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
3.6 AnIn-DepthDiscussionofVirtualHostMatching . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
3.7 FileDescriptorLimits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
3.8 IssuesRegardingDNSandApache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
4 ApacheServerFrequentlyAskedQuestions 141
4.1 FrequentlyAskedQuestions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
4.2 Support-FrequentlyAskedQuestions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
4.3 ErrorMessages-FrequentlyAskedQuestions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
5 ApacheSSL/TLSEncryption 147
5.1 ApacheSSL/TLSEncryption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
5.2 SSL/TLSStrongEncryption: AnIntroduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
5.3 SSL/TLSStrongEncryption: Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
5.4 SSL/TLSStrongEncryption: How-To . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
5.5 SSL/TLSStrongEncryption: FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
6 Guides,Tutorials,andHowTos 183
6.1 How-To/Tutorials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
6.2 Authentication,AuthorizationandAccessControl . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
6.3 ApacheTutorial: DynamicContentwithCGI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
6.4 ApacheTutorial: IntroductiontoServerSideIncludes . . . . . . . . . . . . . . . . . . . . . . . . . . 195
6.5 ApacheTutorial: .htaccessfiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
6.6 Per-userwebdirectories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
6.7 ApacheTutorials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
7 Platform-specificNotes 211
7.1 PlatformSpecificNotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
7.2 UsingApachewithMicrosoftWindows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
7.3 CompilingApacheforMicrosoftWindows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
7.4 UsingApacheWithNovellNetWare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
7.5 RunningaHigh-PerformanceWebServeronHPUX . . . . . . . . . . . . . . . . . . . . . . . . . . 232
7.6 TheApacheEBCDICPort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
8 ApacheHTTPServerandSupportingPrograms 237
8.1 ServerandSupportingPrograms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
CONTENTS v
8.2 httpd-ApacheHypertextTransferProtocolServer . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
8.3 ab-ApacheHTTPserverbenchmarkingtool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
8.4 apachectl-ApacheHTTPServerControlInterface . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
8.5 apxs-APacheeXtenSiontool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
8.6 configure-Configurethesourcetree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
8.7 dbmmanage-ManageuserauthenticationfilesinDBMformat . . . . . . . . . . . . . . . . . . . . . 259
8.8 htdigest-manageuserfilesfordigestauthentication. . . . . . . . . . . . . . . . . . . . . . . . . . . 261
8.9 htpasswd-Manageuserfilesforbasicauthentication . . . . . . . . . . . . . . . . . . . . . . . . . . 262
8.10 logresolve-ResolveIP-addressestohostnamesinApachelogfiles . . . . . . . . . . . . . . . . . . . 264
8.11 rotatelogs-PipedloggingprogramtorotateApachelogs . . . . . . . . . . . . . . . . . . . . . . . . 265
8.12 suexec-Switchuserbeforeexecutingexternalprograms . . . . . . . . . . . . . . . . . . . . . . . . 267
8.13 OtherPrograms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
9 ApacheMiscellaneousDocumentation 269
9.1 ApacheMiscellaneousDocumentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
9.2 InternationalCustomizedServerErrorMessages . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
9.3 ConnectionsintheFIN WAIT 2stateandApache. . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
9.4 KnownProblemsinClients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
9.5 DescriptorsandApache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
9.6 PATH INFOChangesintheCGIEnvironment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
9.7 RelevantStandards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
10 Apachemodules 295
10.1 TermsUsedtoDescribeModules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
10.2 TermsUsedtoDescribeDirectives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
10.3 ApacheModulecore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
10.4 ApacheModulemod access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
10.5 ApacheModulemod actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
10.6 ApacheModulemod alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
10.7 ApacheModulemod asis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
10.8 ApacheModulemod auth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
10.9 ApacheModulemod auth anon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
10.10ApacheModulemod auth dbm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
10.11ApacheModulemod auth digest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
10.12ApacheModulemod auth ldap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
10.13ApacheModulemod autoindex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
10.14ApacheModulemod cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
10.15ApacheModulemod cern meta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
vi CONTENTS
10.16ApacheModulemod cgi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
10.17ApacheModulemod cgid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
10.18ApacheModulemod charset lite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
10.19ApacheModulemod dav . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
10.20ApacheModulemod dav fs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
10.21ApacheModulemod deflate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
10.22ApacheModulemod dir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
10.23ApacheModulemod disk cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
10.24ApacheModulemod echo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
10.25ApacheModulemod env . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417
10.26ApacheModulemod example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
10.27ApacheModulemod expires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
10.28ApacheModulemod ext filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
10.29ApacheModulemod file cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
10.30ApacheModulemod headers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
10.31ApacheModulemod imap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
10.32ApacheModulemod include . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
10.33ApacheModulemod info. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
10.34ApacheModulemod isapi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
10.35ApacheModulemod ldap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455
10.36ApacheModulemod log config . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460
10.37ApacheModulemod logio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
10.38ApacheModulemod mem cache. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
10.39ApacheModulemod mime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
10.40ApacheModulemod mime magic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
10.41ApacheModulemod negotiation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486
10.42ApacheModulemod nw ssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
10.43ApacheModulemod proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491
10.44ApacheModulemod proxy connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504
10.45ApacheModulemod proxy ftp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505
10.46ApacheModulemod proxy http . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506
10.47ApacheModulemod rewrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507
10.48ApacheModulemod setenvif. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527
10.49ApacheModulemod so. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531
10.50ApacheModulemod speling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533
10.51ApacheModulemod ssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535
10.52ApacheModulemod status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558
CONTENTS vii
10.53ApacheModulemod suexec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560
10.54ApacheModulemod unique id. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561
10.55ApacheModulemod userdir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563
10.56ApacheModulemod usertrack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565
10.57ApacheModulemod vhost alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 568
10.58ApacheModulebeos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572
10.59ApacheModulempm common . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574
10.60ApacheModuleleader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585
10.61ApacheModulempm netware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586
10.62ApacheModulempmt os2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588
10.63ApacheModuleperchild . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589
10.64ApacheModuleprefork . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593
10.65ApacheModulethreadpool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
10.66ApacheModulempm winnt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
10.67ApacheModuleworker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598
11 DeveloperDocumentation 601
11.1 DeveloperDocumentationforApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602
11.2 Apache1.3APInotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603
11.3 DebuggingMemoryAllocationinAPR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619
11.4 DocumentingApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622
11.5 Apache2.0HookFunctions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623
11.6 ConvertingModulesfromApache1.3toApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . 626
11.7 RequestProcessinginApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630
11.8 HowfiltersworkinApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 634
12 GlossaryandIndex 637
12.1 Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638
12.2 ModuleIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 642
12.3 DirectiveIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 644
12.4 DirectiveQuickReference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 650
viii CONTENTS
Chapter 1
Release Notes
1
2 CHAPTER1. RELEASENOTES
1.1 Upgrading to 2.0 from 1.3
Inordertoassistfolksupgrading, wemaintainadocumentdescribinginformationcriticaltoexistingApacheusers.
Theseareintendedtobebriefnotes,andyoushouldbeabletofindmoreinformationineithertheNewFeatures(p.4)
document,orinthesrc/CHANGESfile.
Seealso
• OverviewofnewfeaturesinApache2.0(p.4)
Compile-TimeConfigurationChanges
• Apachenowusesanautoconfandlibtoolsystemforconfiguringthebuildprocesses(p.10). Usingthis
systemissimilarto,butnotthesameas,usingtheAPACIsysteminApache1.3.
• Inadditiontotheusualselectionofmoduleswhichyoucanchoosetocompile,Apache2.0hasmovedthemain
partofrequestprocessingintoMulti-ProcessingModules(p.59)(MPMs).
Run-TimeConfigurationChanges
• ManydirectivesthatwereinthecoreserverinApache1.3arenowintheMPMs.Ifyouwishthebehaviorofthe
servertobeassimilaraspossibletothebehaviorofApache1.3,youshouldselectthe PREFORKMPM.Other
MPMswillhavedifferentdirectivestocontrolprocesscreationandrequestprocessing.
• Theproxymodule(p.491)hasbeenrevampedtobringituptoHTTP/1.1.Amongtheimportantchanges,proxy
accesscontrolisnowplacedinsidea<PROXY>blockratherthana<Directory proxy:>block.
• ThehandlingofPATH INFO(trailingpathinformationafterthetruefilename)haschangedforsomemodules.
Modules that were previously implemented as a handler but are now implemented as a filter may no longer
acceptrequestswithPATH INFO.FilterssuchasINCLUDES(p.441)orPHP1 areimplementedontopofthe
corehandler, andthereforerejectrequestswithPATH INFO.Youcanusethe ACCEPTPATHINFO directiveto
forcethecorehandlertoacceptrequestswithPATH INFOandtherebyrestoretheabilitytousePATH INFOin
server-sideincludes.
• TheCACHENEGOTIATEDDOCSdirectivenowtakestheargumentonoroff.ExistinginstancesofCACHENE-
GOTIATEDDOCSshouldbereplacedwithCacheNegotiatedDocs on.
• The ERRORDOCUMENT directive no longer uses a quote at the beginning of the argument to indicate a text
message. Instead,youshouldenclosethemessageindoublequotes. Forexample,existinginstancesof
ErrorDocument 403 "Some Message
shouldbereplacedwith
ErrorDocument 403 "Some Message"
AslongasthesecondargumentisnotavalidURLorpathname,itwillbetreatedasatextmessage.
• TheAccessConfigandResourceConfigdirectivesnolongerexist.Existinginstancesofthesedirectives
can be replaced with the INCLUDE directive which has equivalent functionality. If you were making use of
the default values of these directives without including them in the configuration files, you may need to add
Include conf/access.conf and Include conf/srm.conf to your httpd.conf. In order to
assure that Apache reads the configuration files in the same order as was implied by the older directives, the
INCLUDEdirectivesshouldbeplacedattheendofhttpd.conf,withtheoneforsrm.confprecedingthe
oneforaccess.conf.
1http://www.php.net/