From: Rich Bowen Date: Fri, 9 Apr 2010 12:20:38 +0000 (+0000) Subject: General review and updating of document. Added mention of the other X-Git-Tag: 2.3.6~241 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=1a64036f3f4044ed3c593414dee72027c4d2811b;p=thirdparty%2Fapache%2Fhttpd.git General review and updating of document. Added mention of the other modules located in the modules/mappers directory that aren't already mentioned, and made a note to come back and flesh this out a little later. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@932378 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/urlmapping.html.en b/docs/manual/urlmapping.html.en index ffdece5e1f3..cc1c2c07a83 100644 --- a/docs/manual/urlmapping.html.en +++ b/docs/manual/urlmapping.html.en @@ -37,12 +37,13 @@
  • Reverse Proxy
  • Rewriting Engine
  • File Not Found
    • +
  • Other URL Mapping Modules
    • top

    Related Modules and Directives

    -
    Related ModulesRelated Directives
    +
    Related ModulesRelated Directives
    top

    DocumentRoot

    @@ -200,7 +201,7 @@ of the local server. This technique is called reverse proxying because the web server acts like a proxy server by fetching the documents from a remote server and returning them to the -client. It is different from normal proxying because, to the client, +client. It is different from normal (forward) proxying because, to the client, it appears the documents originate at the reverse proxy server.

    In the following example, when clients request documents under the @@ -226,11 +227,19 @@ directory on the local server. Similarly, the and ProxyPassReverseCookiePath rewrite cookies set by the backend server.

    It is important to note, however, that -links inside the documents will not be rewritten. So any absolute +links inside the documents will not be rewritten. So any absolute links on internal.example.com will result in the client breaking out of the proxy server and requesting directly from -internal.example.com. A third-party module -mod_proxy_html +internal.example.com. You can modify these links (and other +content) in a page as it is being served to the client using +mod_substitute.

    + +

    +Substitute s/internal\.example\.com/www.example.com/i +

    + +

    Additionally, a third-party module, +mod_proxy_html, is available to rewrite links in HTML and XHTML.

    top
    @@ -238,7 +247,7 @@ is available to rewrite links in HTML and XHTML.

    When even more powerful substitution is required, the rewriting engine provided by mod_rewrite - can be useful. The directives provided by this module use + can be useful. The directives provided by this module can use characteristics of the request such as browser type or source IP address in deciding from where to serve content. In addition, mod_rewrite can use external database files or programs to @@ -287,6 +296,26 @@ is available to rewrite links in HTML and XHTML.

    and can be customized in a flexible manner as discussed in the Custom error responses document.

    +
    top
    +
    +

    Other URL Mapping Modules

    + + + +

    Other modules available for URL mapping include: +

    +

    +

    Available Languages:  en  | diff --git a/docs/manual/urlmapping.xml b/docs/manual/urlmapping.xml index db6b6e090ae..e316622f0cc 100644 --- a/docs/manual/urlmapping.xml +++ b/docs/manual/urlmapping.xml @@ -34,11 +34,15 @@ +mod_actions mod_alias +mod_dir +mod_imagemap +mod_negotiation mod_proxy mod_rewrite -mod_userdir mod_speling +mod_userdir mod_vhost_alias @@ -227,7 +231,7 @@ of the local server. This technique is called reverse proxying because the web server acts like a proxy server by fetching the documents from a remote server and returning them to the -client. It is different from normal proxying because, to the client, +client. It is different from normal (forward) proxying because, to the client, it appears the documents originate at the reverse proxy server.

    In the following example, when clients request documents under the @@ -253,11 +257,19 @@ directory on the local server. Similarly, the and ProxyPassReverseCookiePath rewrite cookies set by the backend server.

    It is important to note, however, that -links inside the documents will not be rewritten. So any absolute +links inside the documents will not be rewritten. So any absolute links on internal.example.com will result in the client breaking out of the proxy server and requesting directly from -internal.example.com. A third-party module -mod_proxy_html +internal.example.com. You can modify these links (and other +content) in a page as it is being served to the client using +mod_substitute.

    + + +Substitute s/internal\.example\.com/www.example.com/i + + +

    Additionally, a third-party module, +mod_proxy_html, is available to rewrite links in HTML and XHTML.

    @@ -265,7 +277,7 @@ is available to rewrite links in HTML and XHTML.

    When even more powerful substitution is required, the rewriting engine provided by mod_rewrite - can be useful. The directives provided by this module use + can be useful. The directives provided by this module can use characteristics of the request such as browser type or source IP address in deciding from where to serve content. In addition, mod_rewrite can use external database files or programs to @@ -316,4 +328,24 @@ is available to rewrite links in HTML and XHTML.

    document.

    +
    Other URL Mapping Modules + + + +

    Other modules available for URL mapping include: +

      +
    • mod_actions - Maps a request to a CGI script + based on the request method, or resource MIME type.
      • +
    • mod_dir - Provides basic mapping of a trailing + slash into an index file such as index.html.
      • +
    • mod_imagemap - Maps a request to a URL based + on where a user clicks on an image embedded in a HTML document.
      • +
    • mod_negotiation - Selects an appropriate + document based on client preferences such as language or content + compression.
      • +
    +

    + +
    +