From: Rich Bowen Date: Mon, 2 Nov 2009 17:57:33 +0000 (+0000) Subject: Rewrite of the overview/introduction for this section of the docs. X-Git-Tag: 2.3.3~101 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=7d3058f9cb3d5519b44c44ec6280f91f107883af;p=thirdparty%2Fapache%2Fhttpd.git Rewrite of the overview/introduction for this section of the docs. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@831985 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/rewrite/index.html.en b/docs/manual/rewrite/index.html.en index 181fa8dbf3c..c82b3cadb07 100644 --- a/docs/manual/rewrite/index.html.en +++ b/docs/manual/rewrite/index.html.en @@ -23,56 +23,37 @@  tr 

-
-

``The great thing about mod_rewrite is it gives you - all the configurability and flexibility of Sendmail. - The downside to mod_rewrite is that it gives you all - the configurability and flexibility of Sendmail.''

-

-- Brian Behlendorf
- Apache Group

- -
- -
-

``Despite the tons of examples and docs, - mod_rewrite is voodoo. Damned cool voodoo, but still - voodoo.''

- -

-- Brian Moore
- bem@news.cmc.net

- -
- -

Welcome to mod_rewrite, the Swiss Army Knife of URL - manipulation!

- -

This module uses a rule-based rewriting engine (based on a +

mod_rewrite uses a rule-based rewriting engine (based on a regular-expression parser) to rewrite requested URLs on the fly. It supports an unlimited number of rules and an unlimited number of attached rule conditions for each rule to provide a really flexible and powerful URL manipulation - mechanism. The URL manipulations can depend on various tests, - for instance server variables, environment variables, HTTP - headers, time stamps and even external database lookups in - various formats can be used to achieve granular URL + mechanism. The URL manipulations can depend on various tests: + server variables, environment variables, HTTP + headers, time stamps external database lookups, and various other + external processes or handlers, can be used to achieve granular URL matching.

-

This module operates on the full URLs (including the - path-info part) both in per-server context - (httpd.conf) and per-directory context - (.htaccess files and <Directory> - blocks) and can even generate query-string - parts on result. The rewritten result can lead to internal - sub-processing, external request redirection or even to an - internal proxy throughput.

+

Rewrite rules can operate on the full URLs, including the path-info + and query string portions, and may be used in per-server context + (httpd.conf), per-virtualhost context (<VirtualHost> blocks), or + per-directory context (.htaccess files and <Directory> blocks). The + rewritten result can lead to further rules, internal + sub-processing, external request redirection, or proxy + passthrough.

-

But all this functionality and flexibility has its - drawback: complexity. So don't expect to understand this - entire module in just one day.

+

Since mod_rewrite is so powerful, it can indeed be rather + complex. This document supplements the reference documentation, and + attempts to allay some of that complexity, and provide highly + annoted examples of common scenarios that you may handle with + mod_rewrite. But we also attempt to show you when you should not + use mod_rewrite, and use other standard Apache features instead, + thus avoiding this unnecessary complexity.

-

See also