From: Christophe Jaillet Date: Thu, 14 Apr 2016 11:01:10 +0000 (+0000) Subject: Add some missing hyperlinks X-Git-Tag: 2.4.21~259 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=80e6993f42b7be614861bdf38935aecdc25c58e4;p=apache Add some missing hyperlinks (r1739045 in trunk) git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1739051 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/rewrite/rewritemap.xml b/docs/manual/rewrite/rewritemap.xml index c8fcdc2457..9e3f450f32 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,8 +143,10 @@ 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

@@ -178,7 +182,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.

@@ -211,7 +216,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 @@ -266,10 +272,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, @@ -298,7 +304,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, @@ -313,7 +320,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" @@ -324,7 +331,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 @@ -367,7 +374,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.pl"
RewriteRule "-" "${d2u:%{REQUEST_URI}}" @@ -422,27 +429,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.