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