Во многих случаях Apache httpd должен создать самореферентный URL-адрес, то есть URL-адрес, ссылающийся на тот же сервер. С UseCanonicalName On Apache httpd будет использовать имя хоста и порт, указанные в директиве, ServerName для создания канонического имени для сервера. Это имя используется во всех самореферентных URL-адресах, а также для значений SERVER_NAME и SERVER_PORT в CGI.

С UseCanonicalName Off Apache httpd будет формировать самореферентные URL-адреса, используя имя хоста и порт, предоставленные клиентом, если они предоставлены (в противном случае он будет использовать каноническое имя, как определено выше). Эти значения совпадают с теми, которые используются для реализации виртуальных хостов на основе имен и доступны для тех же клиентов. Переменные CGI SERVER_NAME и SERVER_PORT также будут созданы из значений, предоставленных клиентом.

Примером, когда это может быть полезно, является сервер интрасети, где пользователи подключаются к машине, используя короткие имена, такие как www . Вы заметите, что если пользователи вводят короткое имя и URL-адрес, который представляет собой каталог, например http://www/splat , без косой черты в конце , то Apache httpd перенаправит их на http://www.example.com/splat/ . Если у вас включена аутентификация, это заставит пользователя дважды аутентифицироваться (один раз для www и еще раз для www.example.com -- см. FAQ по этому вопросу для получения дополнительной информации). Но если UseCanonicalName установлено Off , то Apache httpd будет перенаправлять на http://www/splat/ .

Существует третий вариант, UseCanonicalName DNS который предназначен для использования с массовым виртуальным хостингом на основе IP для поддержки старых клиентов, которые не предоставляют заголовок Host: . С этой опцией Apache httpd выполняет обратный поиск DNS по IP-адресу сервера, к которому подключился клиент, чтобы выработать самореферентные URL-адреса.

Смотрите также

• UseCanonicalPhysicalPort
• ServerName
• Listen