From 61f39ed4e01b19aa86aa12b71e569e90d6a718e8 Mon Sep 17 00:00:00 2001 From: Christophe Jaillet Date: Thu, 14 Apr 2016 09:58:23 +0000 Subject: [PATCH] Add some missing hyperlinks git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1739045 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/rewrite/rewritemap.xml | 71 ++++++++++++++++-------------- 1 file changed, 39 insertions(+), 32 deletions(-) diff --git a/docs/manual/rewrite/rewritemap.xml b/docs/manual/rewrite/rewritemap.xml index 1bb5f0629e..0386394e7c 100644 --- a/docs/manual/rewrite/rewritemap.xml +++ b/docs/manual/rewrite/rewritemap.xml @@ -26,7 +26,8 @@

This document supplements the mod_rewrite reference documentation. It describes the use of the RewriteMap directive, -and provides examples of each of the various RewriteMap types.

+and provides examples of each of the various RewriteMap types.

Note that many of these examples won't work unchanged in your particular server configuration, so it's important that you understand @@ -57,8 +58,8 @@ configuration. the RewriteMap reference documentation.

-

The syntax of the RewriteMap directive is as - follows:

+

The syntax of the RewriteMap + directive is as follows:

RewriteMap MapName MapType:MapSource @@ -85,12 +86,12 @@ RewriteMap MapName MapType:MapSource if no DefaultValue was specified.

For example, you can define a - RewriteMap as:

+ RewriteMap as:

RewriteMap examplemap "txt:/path/to/file/map.txt"

You would then be able to use this map in a - RewriteRule as follows:

+ RewriteRule as follows:

RewriteRule "^/ex/(.*)" "${examplemap:$1}" @@ -104,13 +105,13 @@ RewriteRule "^/ex/(.*)" "${examplemap:$1|/not_found.html}" Per-directory and .htaccess context

-The RewriteMap directive may not be used in -<Directory> sections or .htaccess files. You must +The RewriteMap directive may not be +used in Directory sections or +.htaccess files. You must declare the map in server or virtualhost context. You may use the map, -once created, in your RewriteRule and -RewriteCond directives in those scopes. You just can't -declare it in those scopes. -

+once created, in your RewriteRule and +RewriteCond directives in those +scopes. You just can't declare it in those scopes.

The sections that follow describe the various MapTypes that @@ -121,7 +122,8 @@ may be used, and give examples of each.

int: Internal Function

When a MapType of int is used, the MapSource is one - of the available internal RewriteMap functions. Module authors can provide + of the available internal RewriteMap + functions. Module authors can provide additional internal functions by registering them with the ap_register_rewrite_mapfunc API. The functions that are provided by default are: @@ -141,14 +143,16 @@ may be used, and give examples of each.

- To use one of these functions, create a RewriteMap referencing - the int function, and then use that in your RewriteRule: + To use one of these functions, create a RewriteMap referencing + the int function, and then use that in your RewriteRule:

Redirect a URI to an all-lowercase version of itself

RewriteMap lc int:tolower -RewriteRule (.*) ${lc:$1} [R] +RewriteRule "(.*)" "${lc:$1}" [R] @@ -177,7 +181,8 @@ RewriteRule (.*) ${lc:$1} [R] MatchingKey SubstValue # comment
-

When the RewriteMap is invoked the argument is looked for in the +

When the RewriteMap is invoked + the argument is looked for in the first argument of a line, and, if found, the substitution value is returned.

@@ -210,7 +215,8 @@ telephone 328

Thus, when http://example.com/product/television is - requested, the RewriteRule is applied, and the request + requested, the RewriteRule is + applied, and the request is internally mapped to /prods.php?id=993.

Note: .htaccess files @@ -265,10 +271,10 @@ RewriteRule "^/(.*)" "http://${servers:dynamic}/$1" [P,L]

So, when an image is requested and the first of these rules is - matched, RewriteMap looks up the string + matched, RewriteMap looks up the string static in the map file, which returns one of the specified hostnames at random, which is then used in the - RewriteRule target.

+ RewriteRule target.

If you wanted to have one of the servers more likely to be chosen (for example, if one of the server has more memory than the others, @@ -297,7 +303,8 @@ static www1|www1|www2|www3|www4 RewriteMap examplemap "dbm=sdbm:/etc/apache/mapfile.dbm" -

The type can be sdbm, gdbm, ndbm or db. +

The type can be sdbm, gdbm, ndbm + or db. However, it is recommended that you just use the httxt2dbm utility that is provided with Apache HTTP Server, as it will use the correct DBM library, @@ -312,7 +319,7 @@ $ httxt2dbm -i mapfile.txt -o mapfile.map

You can then reference the resulting file in your -RewriteMap directive:

+RewriteMap directive:

RewriteMap mapname "dbm:/etc/apache/mapfile.map" @@ -323,7 +330,7 @@ RewriteMap mapname "dbm:/etc/apache/mapfile.map" a common base name. For example, you may have two files named mapfile.map.dir and mapfiile.map.pag. This is normal, and you need only use the base name mapfile.map in -your RewriteMap directive.

+your RewriteMap directive.

Cached lookups @@ -372,7 +379,7 @@ by many requests.

A simple example is shown here which will replace all dashes with underscores in a request URI.

-

Rewrite configuration

+

Rewrite configuration

RewriteMap d2u "prg:/www/bin/dash2under.programlisting" apache:apache
RewriteRule "-" "${d2u:%{REQUEST_URI}}" @@ -427,27 +434,27 @@ this process, or if the script itself is very slow. restarted.

If a query returns more than one row, a random row from -the result set is used.

+ the result set is used.

- Example + Example RewriteMap myquery "fastdbd:SELECT destination FROM rewrite WHERE source = %s" - +
Summary -

The RewriteMap directive can occur more than - once. For each mapping-function use one - RewriteMap directive to declare its rewriting - mapfile.

+

The RewriteMap directive can + occur more than once. For each mapping-function use one + RewriteMap directive to declare + its rewriting mapfile.

While you cannot declare a map in per-directory context (.htaccess files or - <Directory> blocks) it is possible to - use this map in per-directory context.

+ Directory blocks) it is + possible to use this map in per-directory context.

-- 2.50.1