From: Sander Temme Date: Mon, 15 May 2006 18:15:19 +0000 (+0000) Subject: Document r399947, addition of optional scheme:// to ServerName directive X-Git-Tag: 2.3.0~2392 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=b2b4cd81694c1c5085cd8e20a75d25bd116f0ecb;p=thirdparty%2Fapache%2Fhttpd.git Document r399947, addition of optional scheme:// to ServerName directive git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@406697 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/core.html.en b/docs/manual/mod/core.html.en index 44d2da024ec..5f60d1ca9dd 100644 --- a/docs/manual/mod/core.html.en +++ b/docs/manual/mod/core.html.en @@ -2567,7 +2567,7 @@ to name-virtual hosts - + @@ -2575,7 +2575,8 @@ itself directive supersedes the functionality of the Port directive from version 1.3.
Description:Hostname and port that the server uses to identify itself
Syntax:ServerName fully-qualified-domain-name[:port]
Syntax:ServerName [scheme://]fully-qualified-domain-name[:port]
Context:server config, virtual host
Status:Core
Module:core
-

The ServerName directive sets the hostname and +

The ServerName directive sets the + request scheme, hostname and port that the server uses to identify itself. This is used when creating redirection URLs. For example, if the name of the machine hosting the web server is simple.example.com, @@ -2590,11 +2591,10 @@ itself

If no ServerName is specified, then the server attempts to deduce the hostname by performing a reverse lookup on the IP address. If no port is specified in the - ServerName, then the server will use the port - from the incoming - request. For optimal reliability and predictability, you should - specify an explicit hostname and port using the - ServerName directive.

+ ServerName, then the server will use the + port from the incoming request. For optimal reliability and + predictability, you should specify an explicit hostname and port + using the ServerName directive.

If you are using name-based virtual hosts, the ServerName inside a @@ -2602,14 +2602,25 @@ itself section specifies what hostname must appear in the request's Host: header to match this virtual host.

+ +

Sometimes, the server runs behind a device that processes SSL, + such as a reverse proxy, load balancer or SSL offload + appliance. When this is the case, specify the + https:// scheme and the port number to which the + clients connect in the ServerName directive + to make sure that the server generates the correct + self-referential URLs. +

+

See the description of the UseCanonicalName and UseCanonicalPhysicalPortdirectives for - settings which determine whether self-referential URL's (e.g., by the + settings which determine whether self-referential URLs (e.g., by the mod_dir module) will refer to the specified port, or to the port number given in the client's request.

+

See also