configuring.xml revision c68aa7f213d409d464eaa6b963afb28678548f4f
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke<!DOCTYPE manualpage SYSTEM "/style/manualpage.dtd">
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke<!-- $LastChangedRevision$ -->
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke Licensed to the Apache Software Foundation (ASF) under one or more
b72a390042c19e630cf221494b60c9df2a60d187Dominik Luecke contributor license agreements. See the NOTICE file distributed with
b72a390042c19e630cf221494b60c9df2a60d187Dominik Luecke this work for additional information regarding copyright ownership.
b72a390042c19e630cf221494b60c9df2a60d187Dominik Luecke The ASF licenses this file to You under the Apache License, Version 2.0
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke (the "License"); you may not use this file except in compliance with
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke the License. You may obtain a copy of the License at
cf04ba46b9eb495d334466e24e082e391055ca7bDominik Luecke Unless required by applicable law or agreed to in writing, software
cf04ba46b9eb495d334466e24e082e391055ca7bDominik Luecke distributed under the License is distributed on an "AS IS" BASIS,
cf04ba46b9eb495d334466e24e082e391055ca7bDominik Luecke WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
cf04ba46b9eb495d334466e24e082e391055ca7bDominik Luecke See the License for the specific language governing permissions and
cf04ba46b9eb495d334466e24e082e391055ca7bDominik Luecke limitations under the License.
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke<p>This document describes the files used to configure Apache HTTPD.</p>
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke </modulelist>
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke <directivelist>
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke <directive module="core" type="section">IfDefine</directive>
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke <directive module="mod_mime">TypesConfig</directive>
f90884915ff10ae83f59e709c68824de834e64f5Dominik Luecke </directivelist>
b72a390042c19e630cf221494b60c9df2a60d187Dominik Luecke href="mod/directives.html">directives</a> in plain text
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke configuration files. The main configuration file is usually called
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke <code>httpd.conf</code>. The location of this file is set at
b72a390042c19e630cf221494b60c9df2a60d187Dominik Luecke compile-time, but may be overridden with the <code>-f</code>
b72a390042c19e630cf221494b60c9df2a60d187Dominik Luecke command line flag. In addition, other configuration files may be
b72a390042c19e630cf221494b60c9df2a60d187Dominik Luecke added using the <directive module="core">Include</directive>
b72a390042c19e630cf221494b60c9df2a60d187Dominik Luecke directive, and wildcards can be used to include many configuration
b72a390042c19e630cf221494b60c9df2a60d187Dominik Luecke files. Any directive may be placed in any of these configuration
b72a390042c19e630cf221494b60c9df2a60d187Dominik Luecke files. Changes to the main configuration files are only
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke recognized by httpd when it is started or restarted.</p>
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke <p>The server also reads a file containing mime document types;
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke the filename is set by the <directive
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke module="mod_mime">TypesConfig</directive> directive,
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke and is <code>mime.types</code> by default.</p>
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke <title>Syntax of the Configuration Files</title>
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke <p>httpd configuration files contain one directive per line.
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke The back-slash "\" may be used as the last character on a line
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke to indicate that the directive continues onto the next line.
b72a390042c19e630cf221494b60c9df2a60d187Dominik Luecke There must be no other characters or white space between the
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke back-slash and the end of the line.</p>
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke <p>Directives in the configuration files are case-insensitive,
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke but arguments to directives are often case sensitive. Lines
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke that begin with the hash character "#" are considered
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke comments, and are ignored. Comments may <strong>not</strong> be
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke included on a line after a configuration directive. Blank lines
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke and white space occurring before a directive are ignored, so
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke you may indent directives for clarity.</p>
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke <p>The values of shell environment variables can be used in
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke configuration file lines using the syntax <code>${ENVVAR}</code>.
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke If "ENVVAR" is the name of a valid environment variable, the value
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke of that variable is substituted into that spot in the
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke configuration file line, and processing continues as if that text
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke were found directly in the configuration file. (If the ENVVAR
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke variable is not found, the characters "${ENVVAR}" are left
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke unchanged for use by later stages in the config file
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke processing.)</p>
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke <p>Only environment variables defined before the server is started
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke can be used in expansions. Variables defined in the
08056875f5f633ef432598d5245ea41c112d2178Dominik Luecke configuration file itself, for example with <directive
href="sections.html">How Directory, Location and Files sections