index.xml revision 06ed4d71350dacf8c4bedec7ac850eeb9a84637a
3726777f47ac4bba3e21b075905959bbea47e72eerikabele<!DOCTYPE manualpage SYSTEM "/style/manualpage.dtd">
3726777f47ac4bba3e21b075905959bbea47e72eerikabele<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
3726777f47ac4bba3e21b075905959bbea47e72eerikabele<!-- $LastChangedRevision$ -->
3726777f47ac4bba3e21b075905959bbea47e72eerikabele Licensed to the Apache Software Foundation (ASF) under one or more
3726777f47ac4bba3e21b075905959bbea47e72eerikabele contributor license agreements. See the NOTICE file distributed with
3726777f47ac4bba3e21b075905959bbea47e72eerikabele this work for additional information regarding copyright ownership.
3726777f47ac4bba3e21b075905959bbea47e72eerikabele The ASF licenses this file to You under the Apache License, Version 2.0
3726777f47ac4bba3e21b075905959bbea47e72eerikabele (the "License"); you may not use this file except in compliance with
3726777f47ac4bba3e21b075905959bbea47e72eerikabele the License. You may obtain a copy of the License at
3726777f47ac4bba3e21b075905959bbea47e72eerikabele Unless required by applicable law or agreed to in writing, software
3726777f47ac4bba3e21b075905959bbea47e72eerikabele distributed under the License is distributed on an "AS IS" BASIS,
3726777f47ac4bba3e21b075905959bbea47e72eerikabele WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
3726777f47ac4bba3e21b075905959bbea47e72eerikabele See the License for the specific language governing permissions and
3726777f47ac4bba3e21b075905959bbea47e72eerikabele limitations under the License.
3726777f47ac4bba3e21b075905959bbea47e72eerikabele <p>mod_rewrite uses a rule-based rewriting engine (based on a
3726777f47ac4bba3e21b075905959bbea47e72eerikabele regular-expression parser) to rewrite requested URLs on the
3726777f47ac4bba3e21b075905959bbea47e72eerikabele fly. It supports an unlimited number of rules and an
3726777f47ac4bba3e21b075905959bbea47e72eerikabele unlimited number of attached rule conditions for each rule to
3726777f47ac4bba3e21b075905959bbea47e72eerikabele provide a really flexible and powerful URL manipulation
3726777f47ac4bba3e21b075905959bbea47e72eerikabele mechanism. The URL manipulations can depend on various tests:
3726777f47ac4bba3e21b075905959bbea47e72eerikabele server variables, environment variables, HTTP
cbbae5f6f6dab2f4431c8609ef9aee6c00705645nd headers, time stamps external database lookups, and various other
cbbae5f6f6dab2f4431c8609ef9aee6c00705645nd external processes or handlers, can be used to achieve granular URL
cbbae5f6f6dab2f4431c8609ef9aee6c00705645nd matching.</p>
cbbae5f6f6dab2f4431c8609ef9aee6c00705645nd <p>Rewrite rules can operate on the full URLs, including the path-info
1fb92290c22cf761b7219074d75cde2016050ed1slive and query string portions, and may be used in per-server context
43a46e566e58e888c7889448cabd3dcf1f4b9fbend (<code>httpd.conf</code>), per-virtualhost context (<directive
43a46e566e58e888c7889448cabd3dcf1f4b9fbend type="section" module="core">VirtualHost</directive> blocks), or
43a46e566e58e888c7889448cabd3dcf1f4b9fbend per-directory context (<code>.htaccess</code> files and <directive
43a46e566e58e888c7889448cabd3dcf1f4b9fbend type="section" module="core">Directory</directive> blocks). The
43a46e566e58e888c7889448cabd3dcf1f4b9fbend rewritten result can lead to further rules, internal
43a46e566e58e888c7889448cabd3dcf1f4b9fbend sub-processing, external request redirection, or proxy
43a46e566e58e888c7889448cabd3dcf1f4b9fbend passthrough.</p>
3726777f47ac4bba3e21b075905959bbea47e72eerikabele <p>Since mod_rewrite is so powerful, it can indeed be rather
3726777f47ac4bba3e21b075905959bbea47e72eerikabele complex. This document supplements the <a
3726777f47ac4bba3e21b075905959bbea47e72eerikabele href="/mod/mod_rewrite.html">reference documentation</a>, and
3726777f47ac4bba3e21b075905959bbea47e72eerikabele attempts to allay some of that complexity, and provide highly
3726777f47ac4bba3e21b075905959bbea47e72eerikabele annoted examples of common scenarios that you may handle with
3726777f47ac4bba3e21b075905959bbea47e72eerikabele mod_rewrite. But we also attempt to show you when you should not
3726777f47ac4bba3e21b075905959bbea47e72eerikabele use mod_rewrite, and use other standard Apache features instead,
3726777f47ac4bba3e21b075905959bbea47e72eerikabele thus avoiding this unnecessary complexity.</p>
3726777f47ac4bba3e21b075905959bbea47e72eerikabele<li><a href="/mod/mod_rewrite.html">mod_rewrite reference
3726777f47ac4bba3e21b075905959bbea47e72eerikabele<li><a href="intro.html">Introduction to regular expressions and
3726777f47ac4bba3e21b075905959bbea47e72eerikabele<li><a href="rewrite_guide.html">Rewrite Guide - useful examples</a></li>
3726777f47ac4bba3e21b075905959bbea47e72eerikabele<li><a href="access.html">Using mod_rewrite to control access</a></li>
3726777f47ac4bba3e21b075905959bbea47e72eerikabele<seealso><a href="/mod/mod_rewrite.html">mod_rewrite reference
3726777f47ac4bba3e21b075905959bbea47e72eerikabele<seealso><a href="/urlmapping.html">Mapping URLs to the Filesystem</a></seealso>
3726777f47ac4bba3e21b075905959bbea47e72eerikabele<seealso><a href="http://wiki.apache.org/httpd/Rewrite">mod_rewrite
3726777f47ac4bba3e21b075905959bbea47e72eerikabele<seealso><a href="/glossary.html">Glossary</a></seealso>
eed750bc8c60b3057bf2f39a60866796260ee594slive</manualpage>