<-
Apache > HTTP Server > Documentation > Version 2.0 > Modules

Apache Модуль mod_alias

Description: предусматривает картографию различных частей файловой системы хозяина в дереве документа и для переназначения URL
Status: основа
Module Identifier: alias_module
Source File: mod_alias.c

резюме

директивы, содержавшиеся в этом модуле учитывают манипуляцию и контроль URL, поскольку запросы достигают сервера. Alias и ScriptAlias директивы используются, чтобы нанести на карту между дорожками файловой системы и URL. Это учитывает содержание, которое не непосредственно под DocumentRoot служивший часть дерева документа сети. ScriptAlias директива имеет дополнительный эффект отметить целевой справочник как содержащий только подлинники CGI.

Redirect директивы используются, чтобы проинструктировать клиентов делать новый запрос с различным URL. Они часто используются, когда ресурс переместился в новое местоположение.

mod_alias разработан, чтобы обращаться с простыми задачами манипуляции URL. Для более сложных задач, типа управления вереницей вопроса, используйте инструменты, обеспеченные mod_rewrite .

директивы

темы

см. также

top

Order of Processing

псевдонимы и Переадресовывают появление в различных контекстах, обработаны как другие директивы согласно стандарту merging rules . но когда многократные Псевдонимы или Переадресовывают, происходят в том же самом контексте (например, в том же самом <VirtualHost> секция) они обработаны в специфическом заказе.

сначала, все Переадресовывает, обработаны прежде, чем Псевдонимы обработаны, и поэтому запрос, который соответствует a Redirect или RedirectMatch никогда не будут применять Псевдонимы. Во вторых, Псевдонимы и Переадресовывают, обработаны в заказе, они появляются в файлах конфигурации, с первым имеющим приоритет состязанием.

поэтому, когда две или больше из этих директив обращаются к той же самой поддорожке, Вы должны перечислить самую определенную дорожку сначала для всех директив, чтобы иметь эффект. Например, следующая конфигурация будет работать как ожидается:

Alias /foo/bar /baz
Alias /foo /gaq

но если вышеупомянутые две директивы были полностью изменены чтобы, /foo Alias всегда соответствовал бы перед /foo/bar Alias , таким образом последняя директива игнорировалась бы.

top

Alias Directive

Description: карты URL к местоположениям файловой системы
Syntax: Alias URL-path file-path | directory-path
Context: сервер config, действительный хозяин
Status: основа
Module: mod_alias

Alias директива позволяет документам быть сохраненными в местной файловой системе кроме под DocumentRoot . URL с (% - расшифрованный) начинающаяся дорожка дорожка URL будет нанесен на карту к местным начинающимся файлам директивная дорожка .

Example:

Alias /image /ftp/pub/image

запрос о http://myserver/image/foo.gif заставил бы сервер возвращать файл/ftp/pub/image/foo.gif.

отметить это, если Вы включаете перемещение / на дорожка URL тогда сервер будет требовать перемещения / чтобы расширить псевдоним. Таким образом, если Вы используете Alias /icons/ /usr/local/apache/icons/ тогда url /icons не будет aliased.

отметить, что Вы, возможно, должны определить дополнительный <Directory> секции, которые покрывают предназначение из псевдонимов. Совмещение имен происходит прежде <Directory> секции проверены, таким образом только предназначение псевдонимов затронуто. (Примечание однако <Location> секции пробегаются однажды, псевдонимы выполнены, таким образом они применятся.)

в частности если Вы создаете Alias к директивной внешней стороне вашего DocumentRoot , Вы, возможно, должны явно разрешить доступ к целевому справочнику.

Example:

Alias /image /ftp/pub/image
<Directory /ftp/pub/image>
Order allow,deny
Allow from all
</Directory>

top

AliasMatch Directive

Description: карты URL к местоположениям файловой системы, используя регулярные выражения
Syntax: AliasMatch regex file-path | directory-path
Context: сервер config, действительный хозяин
Status: основа
Module: mod_alias

эта директива эквивалентна Alias , но использует стандартные регулярные выражения, вместо простого соответствия приставки. Поставляемое регулярное выражение подобрано против ДОРОЖКИ URL, и если это будет соответствовать, то сервер заменит любыми введенными спичками в данную вереницу и будет использовать это как имя файла. Например, чтобы активизировать /icons справочник, можно было использовать:

AliasMatch ^/icons(.*) /usr/local/apache/icons$1

top

Redirect Directive

Description: посылает внешнее, переадресовывают то, чтобы просить клиента принести различный URL
Syntax: Redirect [ status ] URL-path URL
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: FileInfo
Status: основа
Module: mod_alias

Переадресовывающаяся директива наносит на карту старый URL в новый. Новый URL возвращен клиенту, который пытается принести это снова с новым адресом. ДОРОЖКА URL (% - расшифрованный) дорожка; любые запросы о документах, начинающихся с этой дорожки будут возвращены переадресовывающаяся ошибка к новому (% - закодированный) начинающийся URL URL .

Example:

Redirect /service http://foo2.bar.com/service

если клиент будет просить http://myserver/service/foo.txt, то это будет говориться доступу http://foo2.bar.com/service/foo.txt вместо этого.

отметить

переадресовать директивы, имеют приоритет по Псевдониму и директивам ScriptAlias, независимо от их заказа в файле конфигурации. Кроме того, ДОРОЖКА URL должен быть полностью компетентный URL, не относительная дорожка, даже когда используется с .htaccess файлами или в <Directory> секции.

если нет статус аргумент дается, переадресовывание будет "временным" (статус HTTP 302). Это указывает клиенту, что ресурс переместился временно. статус аргумент может использоваться, чтобы возвратить другие кодексы статуса HTTP:

постоянный
возвращается постоянное переадресовывают статус (301) указание, что ресурс переместился постоянно.
временный секретарь
возвращается временное переадресовывают статус (302). Это - неплатеж.
seeother
возвращается, "Видят Другой" статус (303) указание, что ресурс был заменен.
уведенный
возвращает "Уведенный" статус (410) указание, что ресурс постоянно удалялся. Когда этот статус используется URL аргумент должен быть опущен.

другие кодексы статуса могут быть возвращены, давая числовой кодекс статуса как ценность статус . если статус - между 300 и 399, URL аргумент должен присутствовать, иначе это должно быть опущено. Отметьте, что статус должен быть известен Apacheскому кодексу (см. функцию send_error_response в http_protocol.c).

Example:

Redirect permanent /one http://example.com/two
Redirect 303 /three http://example.com/other

top

RedirectMatch Directive

Description: посылает внешнее, переадресовывают основанный на регулярном состязании выражения текущего URL
Syntax: RedirectMatch [ status ] regex URL
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: FileInfo
Status: основа
Module: mod_alias

эта директива эквивалентна Redirect , но использует стандартные регулярные выражения, вместо простого соответствия приставки. Поставляемое регулярное выражение подобрано против ДОРОЖКИ URL, и если это будет соответствовать, то сервер заменит любыми введенными спичками в данную вереницу и будет использовать это как имя файла. Например, чтобы переадресовать все файлы ДЖИФА к подобному - названный файлами JPEG на другом сервере, можно было использовать:

RedirectMatch (.*)\.gif$ http://www.anotherserver.com$1.jpg

top

RedirectPermanent Directive

Description: посылает внешнее постоянное, переадресовывают то, чтобы просить клиента принести различный URL
Syntax: RedirectPermanent URL-path URL
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: FileInfo
Status: основа
Module: mod_alias

эта директива заставляет клиента знать, что Переадресовывание постоянно (статус 301). Точно эквивалентный Redirect permanent .

top

RedirectTemp Directive

Description: посылает внешнее временное, переадресовывают то, чтобы просить клиента принести различный URL
Syntax: RedirectTemp URL-path URL
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: FileInfo
Status: основа
Module: mod_alias

эта директива заставляет клиента знать, что Переадресовывание является только временным (статус 302). Точно эквивалентный Redirect temp .

top

ScriptAlias Directive

Description: наносит на карту URL к местоположению файловой системы и определяет цель как подлинник CGI
Syntax: ScriptAlias URL-path file-path | directory-path
Context: сервер config, действительный хозяин
Status: основа
Module: mod_alias

ScriptAlias директива имеет то же самое поведение как Alias директива, за исключением того, что кроме того это отмечает целевой справочник как содержащий подлинники CGI, которые будут обработаны mod_cgi 's тренер cgi-подлинника. URL с (% - расшифрованный) начинающаяся дорожка ДОРОЖКА URL будет нанесен на карту к подлинникам, начинающимся со второго аргумента, который является полным именем пути в местной файловой системе.

Example:

ScriptAlias /cgi-bin/ /web/cgi-bin/

запрос о http://myserver/cgi-bin/foo заставил бы сервер управлять подлинником /web/cgi-bin/foo .

top

ScriptAliasMatch Directive

Description: наносит на карту URL к местоположению файловой системы, используя регулярное выражение и определяет цель как подлинник CGI
Syntax: ScriptAliasMatch regex file-path | directory-path
Context: сервер config, действительный хозяин
Status: основа
Module: mod_alias

эта директива эквивалентна ScriptAlias , но использует стандартные регулярные выражения, вместо простого соответствия приставки. Поставляемое регулярное выражение подобрано против ДОРОЖКИ URL, и если это будет соответствовать, то сервер заменит любыми введенными спичками в данную вереницу и будет использовать это как имя файла. Например, чтобы активизировать стандарт /cgi-bin , можно было использовать:

ScriptAliasMatch ^/cgi-bin(.*) /usr/local/apache/cgi-bin$1