You are previewing Apache 2 Pocket Reference.
O'Reilly logo
Apache 2 Pocket Reference

Book Description

Even if you know the Apache web server inside and out, you stillneed an occasional on-the-job reminder -- especially if you'removing to the newer Apache 2.x. Apache 2 Pocket Referencegives you exactly what you need to get the job done without forcingyou to plow through a cumbersome, doorstop-sized reference.This Book provides essential information to help you configure andmaintain the server quickly, with brief explanations that getdirectly to the point. It covers Apache 2.x, giving web masters,web administrators, and programmers a quick and easy referencesolution.This pocket reference includes:

  • Summaries of command-line options, configuration directives,and modules

  • Key information about Apache support utilities

  • What you need to know about URL rewriting, filters, caching,proxying and security

  • Whether you manage huge e-commerce operations, corporateintranets, or small personal websites, Apache 2 PocketReference is ideal for savvy administrators who no longer needdetailed tutorials and just want a convenient, on-the-jobreference.

    Table of Contents

    1. Special Upgrade Offer
    2. Preface
      1. Conventions
      2. Using Code Examples
      3. Safari<sup xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/ops" xmlns:m="http://www.w3.org/1998/Math/MathML" xmlns:pls="http://www.w3.org/2005/01/pronunciation-lexicon" xmlns:ssml="http://www.w3.org/2001/10/synthesis" xmlns:svg="http://www.w3.org/2000/svg">&#174;</sup> Books Online Books Online
      4. How to Contact Us
      5. Acknowledgments
    3. 1. Introduction
      1. Architectural Overview
        1. Operational Overview
        2. Current Versions of Apache
      2. How to Obtain Apache
      3. Starting and Stopping Apache
        1. Command-Line Options
      4. Configuration Files
        1. Configuration Directive Format
          1. DirectorySlash
        2. Basic Configuration File Directives
          1. ServerRoot
          2. Include
          3. AccessFileName
          4. AllowOverride
        3. Conditional Sections
          1. <IfDefine>
          2. <IfModule>
          3. <IfVersion>
        4. Container Sections
          1. <Directory>
          2. <DirectoryMatch>
          3. <Files>
          4. <FilesMatch>
          5. <Location>
          6. <LocationMatch>
          7. <Limit>
          8. <LimitExcept>
    4. 2. Server Environment
      1. Main Server and Virtual Hosts
        1. <VirtualHost>
        2. NameVirtualHost
        3. ServerAdmin
        4. ServerAlias
        5. ServerName
        6. ServerPath
        7. ServerSignature
        8. ServerTokens
        9. UseCanonicalName
        10. UseCanonicalPhysicalPort
      2. Network Configuration
        1. AcceptFilter
        2. AcceptMutex
        3. EnableSendfile
        4. HostnameLookups
        5. KeepAlive
        6. KeepAliveTimeout
        7. MaxKeepAliveRequests
        8. Listen
        9. ListenBacklog
        10. ReceiveBufferSize
        11. SendBufferSize
        12. Timeout
        13. TraceEnable
        14. Win32DisableAcceptEx
      3. Process Management
        1. GracefulShutDownTimeout
        2. MaxClients
        3. MaxMemFree
        4. MaxRequestsPerChild
        5. MaxRequestsPerThread
        6. MaxSpareServers
        7. MaxSpareThreads
        8. MaxThreads
        9. MinSpareServers
        10. MinSpareThreads
        11. ServerLimit
        12. StartServers
        13. StartThreads
        14. ThreadLimit
        15. ThreadsPerChild
        16. ThreadStackSize
      4. General Configuration Directives
        1. Optional Features
          1. EnableExceptionHook
          2. EnableMMAP
          3. Options
        2. User and Group
          1. User
          2. Group
        3. Administrative Files
          1. CoreDumpDirectory
          2. LockFile
          3. PidFile
          4. ScoreBoardFile
        4. Loading Shared Objects
          1. LoadFile
          2. LoadModule
        5. Request Limits
          1. LimitInternalRecursion
          2. LimitRequestBody
          3. LimitRequestFields
          4. LimitRequestFieldSize
          5. LimitRequestLine
          6. LimitXMLRequestBody
        6. Subprocess Resource Limits
          1. RLimitCPU
          2. RLimitMEM
          3. RLimitNPROC
      5. DBD Framework
        1. DBDExptime
        2. DBDKeep
        3. DBDMax
        4. DBDMin
        5. DBDParams
        6. DBDPersist
        7. DBDPrepareSQL
        8. DBDriver
      6. LDAP Framework
        1. LDAPCacheEntries
        2. LDAPCacheTTL
        3. LDAPConnectionTimeout
        4. LDAPOpCacheEntries
        5. LDAPOpCacheTTL
        6. LDAPSharedCacheFile
        7. LDAPSharedCacheSize
        8. LDAPTrustedClientCert
        9. LDAPTrustedGlobalCert
        10. LDAPTrustedMode
        11. LDAPVerifyServerCert
    5. 3. URL Mapping
      1. Initial Environment Setup
        1. SetEnvIf
        2. SetEnvIfNoCase
        3. BrowserMatch
        4. BrowserMatchNoCase
      2. Basic URL Translation
        1. DocumentRoot
        2. AcceptPathInfo
        3. AllowEncodedSlashes
      3. Aliases and Redirects
        1. Alias
        2. AliasMatch
        3. Redirect
        4. RedirectMatch
        5. RedirectPermanent
        6. RedirectTemp
        7. ScriptAlias
        8. ScriptAliasMatch
      4. Requests for Directories
        1. DirectoryIndex
        2. DirectorySlash
      5. URL Rewriting with mod_rewrite
        1. RewriteBase
        2. RewriteCond
        3. RewriteEngine
        4. RewriteLock
        5. RewriteLog
        6. RewriteLogLevel
        7. RewriteMap
        8. RewriteOptions
        9. RewriteRule
      6. Content Negotiated Documents
        1. CacheNegotiatedDocs
        2. LanguagePriority
        3. ForceLanguagePriority
      7. User Directories
        1. UserDir
      8. Correcting Misspelled URLs
        1. CheckCaseOnly
        2. CheckSpelling
      9. Imagemaps
        1. ImapBase
        2. ImapDefault
        3. ImapMenu
      10. Mass Virtual Hosting
        1. VirtualDocumentRoot
        2. VirtualDocumentRootIP
        3. VirtualScriptAlias
        4. VirtualScriptAliasIP
    6. 4. Access Controls
      1. Non-User-Based Access Controls
        1. Allow
        2. Deny
        3. Order
        4. Satisfy
      2. Authentication
        1. Authentication Setup
          1. AuthDefaultAuthoritative
          2. AuthName
          3. AuthType
        2. HTTP Basic Authentication
          1. AuthBasicAuthoritative
          2. AuthBasicProvider
        3. HTTP Digest Authentication
          1. AuthDigestAlgorithm
          2. AuthDigestDomain
          3. AuthDigestNcCheck
          4. AuthDigestNonceFormat
          5. AuthDigestNonceLifetime
          6. AuthDigestProvider
          7. AuthDigestQop
          8. AuthDigestShmemSize
      3. Authentication Providers
        1. Credentials Stored in Plain Text Files
          1. AuthUserFile
        2. Credentials Stored in DBM Files
          1. AuthDBMType
          2. AuthDBMUserFile
        3. Credentials Stored in a Relational Database
          1. AuthDBDUserPWQuery
          2. AuthDBDUserRealmQuery
        4. Anonymous Authentication
          1. Anonymous
          2. Anonymous_LogEmail
        5. Anonymous_MustGiveEmail
          1. Anonymous_NoUserId
          2. Anonymous_VerifyEmail
        6. Extended Authentication Providers
          1. <AuthnProviderAlias>
      4. Authorization
        1. Authorization Setup
          1. AuthzDefaultAuthoritative
          2. Require
        2. Explicit User Authorization
          1. AuthzUserAuthoritative
        3. Group Membership Stored in Plain Text Files
          1. AuthGroupFile
          2. AuthzGroupFileAuthoritative
        4. Group Membership Stored in DBM Files
          1. AuthDBMGroupFile
          2. AuthzDBMAuthoritative
          3. AuthzDBMType
        5. Authorization Based on File Ownership
          1. AuthzOwnerAuthoritative
      5. LDAP Authentication and Authorization
        1. LDAP Configuration Directives
          1. AuthLDAPCharsetConfig
          2. AuthLDAPDereferenceAliases
          3. AuthLDAPRemoteUserAttribute
          4. AuthLDAPRemoteUserIsDN
          5. AuthLDAPUrl
        2. Authentication Phase Directives
          1. AuthLDAPBindDN
          2. AuthLDAPBindPassword
        3. Authentication Phase Directives
          1. AuthzLDAPAuthoritative
          2. AuthLDAPCompareDNOnServer
          3. AuthLDAPGroupAttribute
          4. AuthLDAPGroupAttributeIsDN
    7. 5. Document Metainformation
      1. Standard Document Attributes
        1. AddCharset
        2. AddDefaultCharset
        3. AddEncoding
        4. AddLanguage
        5. AddType
        6. DefaultLanguage
        7. DefaultType
        8. ForceType
        9. ModMimeUsePathInfo
        10. MultiviewsMatch
        11. RemoveCharset
        12. RemoveEncoding
        13. RemoveLanguage
        14. RemoveType
        15. TypesConfig
      2. Automatic Type Determination
        1. MimeMagicFile
      3. Document Expiry
        1. ExpiresActive
        2. ExpiresByType
        3. ExpiresDefault
      4. Manipulating HTTP Headers
        1. ContentDigest
        2. FileETag
        3. Header
        4. RequestHeader
      5. CERN Metafiles
        1. MetaFiles
        2. MetaDir
        3. MetaSuffix
      6. User Tracking
        1. CookieDomain
        2. CookieExpires
        3. CookieName
        4. CookieStyle
        5. CookieTracking
      7. Environment Variables
        1. PassEnv
        2. SetEnv
        3. UnsetEnv
    8. 6. Content Handlers
      1. Handler Configuration
        1. AddHandler
        2. RemoveHandler
        3. SetHandler
      2. Static Files
      3. Automatically Generated Directory Indexes
        1. IndexOptions
        2. AddAlt
        3. AddAltByEncoding
        4. AddAltByType
        5. AddDescription
        6. AddIcon
        7. AddIconByEncoding
        8. AddIconByType
        9. DefaultIcon
        10. HeaderName
        11. IndexIgnore
        12. IndexOrderDefault
        13. IndexStyleSheet
        14. ReadmeName
      4. CGI Scripts
        1. Action
        2. CGIMapExtension
        3. Script
        4. ScriptInterpreterSource
        5. ScriptSock
        6. SuexecUserGroup
      5. Internet Server Extension API
        1. ISAPIAppendLogToErrors
        2. ISAPIAppendLogToQuery
        3. ISAPICacheFile
        4. ISAPIFakeAsync
        5. ISAPILogNotSupported
        6. ISAPIReadAheadBuffer
      6. WebDAV
        1. Dav
        2. DavDepthInfinity
        3. DavGenericLockDB
        4. DavLockDB
        5. DavMinTimeout
      7. Server-Generated Status Pages
        1. AddModuleInfo
        2. ExtendedStatus
        3. SeeRequestTail
      8. Customized Error Responses
        1. ErrorDocument
    9. 7. Filters
      1. Simple Filter Configuration
        1. AddInputFilter
        2. AddOutputFilter
        3. RemoveInputFilter
        4. RemoveOutputFilter
        5. SetInputFilter
        6. SetOutputFilter
      2. Dynamic Filter Configuration
        1. FilterChain
        2. FilterDeclare
        3. FilterProtocol
        4. FilterProvider
        5. FilterTrace
      3. External Filters
        1. ExtFilterDefine
        2. ExtFilterOptions
      4. Deflate Filter Directives
        1. DeflateBufferSize
        2. DeflateCompressionLevel
        3. DeflateFilterNote
        4. DeflateMemLevel
        5. DeflateWindowSize
      5. Server-Side Includes (SSI)
        1. SSIAccessEnable
        2. SSIEndTag
        3. SSIErrorMsg
        4. SSIStartTag
        5. SSITimeFormat
        6. SSIUndefinedEcho
        7. XBitHack
      6. Response Body Substitutions
        1. Substitute
    10. 8. Caching
      1. Simple, File-Oriented Caching
        1. CacheFile
        2. MMapFile
      2. Intelligent Caching
        1. CacheDefaultExpire
        2. CacheDisable
        3. CacheEnable
        4. CacheIgnoreCacheControl
        5. CacheIgnoreHeaders
        6. CacheIgnoreNoLastMod
        7. CacheIgnoreQueryString
        8. CacheLastModifiedFactor
        9. CacheMaxExpire
        10. CacheStoreNoStore
        11. CacheStorePrivate
      3. Memory-Based Storage
        1. MCacheMaxObjectCount
        2. MCacheMaxObjectSize
        3. MCacheMaxStreamingBuffer
        4. MCacheMinObjectSize
        5. MCacheRemovalAlgorithm
        6. MCacheSize
      4. Disk-Based Storage
        1. CacheRoot
        2. CacheDirLength
        3. CacheDirLevels
        4. CacheMaxFileSize
        5. CacheMinFileSize
    11. 9. Proxying
      1. Basic Proxy Configuration
        1. <Proxy>
        2. <ProxyMatch>
        3. AllowCONNECT
        4. ProxyBadHeader
        5. ProxyErrorOverride
        6. ProxyFtpDirCharset
        7. ProxyIOBufferSize
        8. ProxyPreserveHost
        9. ProxyReceiveBufferSize
        10. ProxyTimeout
      2. Proxy Chaining
        1. NoProxy
        2. ProxyMaxForwards
        3. ProxyRemote
        4. ProxyRemoteMatch
        5. ProxyVia
      3. Forward Proxy
        1. ProxyBlock
        2. ProxyDomain
        3. ProxyRequests
      4. Reverse Proxy
        1. ProxyPass
        2. ProxyPassMatch
        3. ProxyPassReverse
        4. ProxyPassReverseCookieDomain
        5. ProxyPassReverseCookiePath
        6. ProxySet
      5. Load Balancing
        1. BalancerMember
        2. ProxyStatus
    12. 10. SSL/TLS Support
      1. Secure Server Options
        1. SSLCryptoDevice
        2. SSLEngine
        3. SSLOptions
        4. SSLPassPhraseDialog
        5. SSLRandomSeed
        6. SSLUserName
      2. Certificates
        1. Server Certificate
          1. SSLCertificateChainFile
          2. SSLCertificateFile
        2. SSLCertificateKeyFile
        3. Certificate Authority (CA) Certificates
          1. SSLCACertificateFile
          2. SSLCACertificatePath
          3. SSLCADNRequestFile
          4. SSLCADNRequestPath
        4. Certificate Revocation Lists (CRLs)
          1. SSLCARevocationFile
        5. SSLCARevocationPath
      3. Session Caching
        1. SSLSessionCache
        2. SSLSessionCacheTimeout
        3. SSLMutex
      4. SSL-Based Access Controls
        1. SSLCipherSuite
        2. SSLHonorCipherOrder
        3. SSLProtocol
        4. SSLRequire
        5. SSLRequireSSL
        6. SSLVerifyClient
        7. SSLVerifyDepth
      5. Proxy Directives
        1. SSLProxyCACertificateFile
        2. SSLProxyCACertificatePath
        3. SSLProxyCARevocationFile
        4. SSLProxyCARevocationPath
        5. SSLProxyCipherSuite
        6. SSLProxyEngine
        7. SSLProxyMachineCertificateFile
        8. SSLProxyMachineCertificatePath
        9. SSLProxyProtocol
        10. SSLProxyVerify
        11. SSLProxyVerifyDepth
    13. 11. Logging
      1. Error Logging
        1. ErrorLog
        2. LogLevel
        3. DumpIOLogLevel
        4. DumpIOInput
        5. DumpIOOutput
      2. Request Logging
        1. BufferedLogs
        2. CustomLog
        3. IdentityCheck
        4. IdentityCheckTimeout
        5. LogFormat
        6. TransferLog
      3. Script Logging
        1. ScriptLog
        2. ScriptLogBuffer
        3. ScriptLogLength
      4. SSL Logging
      5. Forensic Logging
        1. ForensicLog
    14. A. Programs and Modules
      1. Support Utilities
      2. Apache Modules
    15. B. CGI Environment Variables
      1. Standard CGI Variables
      2. Additional SSL Variables
        1. SSL/TLS Protocol Information
        2. Server Certificate Information
        3. Client Certificate Information
    16. C. strftime() Time Formats
    17. D. HTTP Status Codes
    18. E. HTTP Header Fields
    19. Index
    20. About the Author
    21. Special Upgrade Offer
    22. Copyright