Дата: 2009-05-18
Наверняка при загрузке различных скриптов или просто на сервере Вам доводилось встречать такой файл .htaccess . Обратите внимание что наличие точки впереди - является обязательным!!! Если Вы не видите этот файл, но знаете что он должен быть, то скорее всего в настойках Вашей Винды не показываются скрытые файлы. Исправить это легко заходим в меню Сервис/Свойства папки/Вид/Скрытые файлы и папки . Здесь устанавливаем переключатель в положение Показывать скрытые файлы и папки. Жмем Применить, ОК . Или же посмотрите каким-то файловым менеджером, например я пользуюсь Total Commander и Вам рекомендую.
Многие даже продвинутые web-мастера, не всегда знают что этот файл означает, как с ним работать и следовательно не могут использовать все доступные возможности.
Давайте разберемся с назначением и использованием .htaccess
Файл .htaccess (обратите внимание что первый символ в названии файла - точка ) применяется для управления веб-сервером Apache со стороны конечного пользователя хостинга. Вы помещаете в этот файл директивы, которые веб-сервер воспринимает и обрабатывает, выполняя далее действия в соответствии с настройками, которые были сделаны пользователем.
Файл .htaccess может быть размещен в корневом каталоге веб-сервера (прямо в каталоге public_html ) и в этом случае директивы из такого .htaccess действуют по всему веб-серверу. Также .htaccess может находиться и в конкретном подкаталоге (папке) сервера и тогда директивы, которые указаны в этом файле, "перекрывают" действие директив из "основного" файла, который размещен в каталоге public_html или в любом каталоге более высокого уровня. То есть, действие директив из .htaccess наследуется сверху вниз, но не наоборот. Изменения, внесенные в файл, вступают в силу немедленно. Это связано с тем, что информация из .htaccess перечитывается при каждом обращении к веб-серверу Apache.
Т.е. проще говоря в файл .htaccess мы прописываем инструкции для веб-сервера Apache. Эти инструкции могут распостраняться как на весь сайт в целом (если файл .htaccess один и лежит в корне сайта) или на конкретную директорию (папку), (если файл .htaccess лежит в этой папке - значит инструкции будут работать только в этой папкке).
Пример простейшего использования возможностей конфигурирования Apache через файл.htaccess: Мы хотим "объяснить" веб-серверу что все html-документы, которые размещены на сервере, нужно "отдавать" клиенту в кодировке koi8-r, а не в windows-1251, как это сервер делает по умолчанию. Поместим в.htaccess строку:
AddType "text/html; charset=koi8-r" .html .htm .shtml
Получив такой.htaccess, веб-сервер Apache станет выдавать клиентскому браузеру заголовок, в котором будет указано, что документ имеет кодировку koi8-r.
Рассмотрим другие примеры использования файла.htaccess:
Переопределение индексного файла
Ситуация: пользователь обратился к каталогу http://www.vash_domen.ru/katalog/. При таком запросе первым откроется и будет показан индексный файл index.html . Если вы хотите переопределить индексный файл и сделать так, чтобы первым открывался не index.html , а например файл prais.php . Сделать это можно поместив в файл .htaccess в соответствующем каталоге следующую инструкцию:
DirectoryIndex prais.php
Получив .htaccess с таким содержимым, веб-сервер Apache откроет по умолчанию именно файл prais.php .
Запрет доступа к некоторым файлам
Иногда возникает необходимость запретить доступ к определенным файлам. Например, к конфигурационным файлам, содержащим реквизиты доступа к базам данных, интерфейсам и т.п. Допустим, в файле config.cfg вы храните логин/пароль доступа к базе данных. Создаем в этой директории файл .htaccess с директивами:
Order allow,deny Deny from all
Теперь, если посетитель наберет в браузере нечто вида http://vash_domen/config.cfg, он получит ошибку ошибку 403 или вашу страницу для этой ошибки. Подробнее о страницах ошибок можно почитать
Как закрыть директорию паролем
Одна из стандартных задач, которая решается путем использования .htaccess , это ограничение доступа к определенному каталогу на сервере. Например, нужно дать доступ к определенному каталогу отдельным посетителям, снабдив их при этом уникальными логином и паролем.
Создаем в каталоге, к которому хотим ограничить доступ по паролю, файл .htaccess с такими директивами:
AuthType Basic AuthName "Some Name" AuthUserFile /public_html/XX/YY/.htpasswd require valid-user
Путь /public_html/XX/YY/.htpasswd обозначает полный путь к файлу паролей на диске сервера. Если, например, вы поместите файл .htpasswd (в нем будут пароли) в домашний каталог, куда вы попадаете зайдя на сервер по FTP, то путь к этому файлу будет иметь вид /public_html/XX/YY/.htpasswd.
В директиве AuthUserFile указываем абсолютный путь к файлу с логинами/паролями. Если вы создаете файл .htaccess на своем компьютере, а не сразу на сервере используя текстовый редактор, обратите особое внимание на то, что .htaccess должен передаваться по FTP строго в текстовом (ASCII) режиме .
Создаем файл паролей .htpasswd . Файл с паролями должен содержать строки вида login:password . Пароль должен быть зашифрован с использованием алгоритма MD5. Один из способов создать такой файл - воспользоваться программой, входящей в поставку Apache - htpasswd (обычно на сервере она находится в каталоге /usr/local/bin/, полный путь - /usr/local/bin/htpasswd). Использхование этой программы на каждом сервере индивидуально - уточняйте у своего хостера.
После окончания заведения всех логинов и паролей файлы нужно загрузить на сервер.
Заголовок last-modified
Иногда требуется, чтобы web-сервер выдавал HTTP-заголовок Last-Modified
. К примеру, при регистрации вашего ресурса на Яндексе, возникает ошибка "Неправильные даты".
Для статических документов, согласно документации по Apache:
cервер будет выдавать значение last-modified в том случае, если прописана директива "XBitHack full" (просто пропишите эту строку в .htaccess ), и для файла, к которому происходит обращение, выставлен атрибут "исполняемый" для группы.
Это действительно для html-файлов. В скриптах last-modified выдается иными средствами. Например, если учесть то, что php-скрипт генерирует код динамически, то самым логичным будет в качестве last-modified отдавать текущую дату и время. Реализуется это следующим образом - в файле .htaccess прописываем следующую строчку:
("Last-Modified: " . gmdate("D, d M Y H:i:s") . " GMT");
Что это дает сервер будет выдавать роботам последную дату обновления вашего документа, очень полезная функция.
Наверное вы знаете что, все базовые настройки сервера Apache размещены в файлe httpd.conf, доступ к которому есть не всегда. Например, если на хостинге используется виртуальный сервер, когда один сервер обслуживает не одну сотню сайтов, то, невозможно разрешить хозяину одного сайта изменять конфигурацию всего сервера, так как это повлияет на все остальные сайты. Однако, Web-сервер Apache разрешает конфигурирование во время выполнения для отдельных директорий при помощи файлов.htaccess.
Предупреждение:
WEB-сервером Apache файлы с точкой в начале имени зачастую не выдаются в листинге и не показываются через FTP-клиенты.
Для полного контроля над такими файлами Вам нужен физический доступ к серверу или полноценный удалённый клиент. Через FTP Вы будете работать вслепую, посылая на сервер команды через командную строку (Думаю, что команда "help" в коммандной строке будет не лишней). Файл.htaccess – это конфигурационный файл, который даёт возможность настраивать работу сервера на уровне отдельных каталогов: устанавливать права доступа к файлам в каталогах, менять названия индексных файлов, самостоятельно обрабатывать коды ответов протокола HTTP, модифицировать адреса запрошенных страниц.
Примечание:
Файл .htaccess
может быть размещен в любом каталоге. Директивы этого файла действуют на все файлы в текущем каталоге и во всех его подкаталогах (если эти директивы не переопределены директивами файлов.htaccess во вложенных каталогах).
Изменения, вносимые в файлы.htaccess, вступают в силу немедленно и не требуют перезагрузки сервера в отличие от изменений, вносимых в главный конфигурационный файл httpd.conf.
Для того, чтобы файлы.htaccess можно было использовать, необходимы соответствующие настройки главного конфигурационного файла httpd.conf, где должны быть прописаны директивы, которые разрешат файлу.htaccess переопределять конфигурацию Web-сервера
в каталоге. Список этих директив задаётся директивой AllowOverride.
Директива AllowOverride может включать в себя одну из следующих директив или их комбинацию:
AuthConfig, FileInfo, Indexes, Limit, Options, All, None
Для того чтобы дать директивам файлов.htaccess максимальные права на изменения директив, значение директивы AllowOverride в файле httpd.conf должно быть равно All. Оно является значением по умолчанию.
AllowOverride All
Запретить переопределение любых директив в конфигурационных файлах.htaccess можно при помощи значения None:
AllowOverride None
Замечание:
Название конфигурационного файла можно изменить, и например, назвать его не.htaccess, a access.conf. За наименование этого файла отвечает директива AccessFileName в файле httpd.conf. Изменение названия конфигурационного файла.htaccess не рекомендуется, т.к. это может усложнить дальнейшую поддержку сервера.
Синтаксис.htaccess
Перед тем, как будут рассмотрены примеры, остановимся на синтаксисе директив в файлах.htaccess.
Пути к файлам и каталогам должны указываться а абсолютной адресации от корня партишена.
Например:
/home/users/vasya999/public_html/a_content/masters/
При указании абсолютных url обязательно должны быть зaданы протоколы, например:
Redirect / http://www.site.ru
В файлах.htaccess недопустимы пробелы в указаниях путей к файлам и в названиях самих файлов, т.к. это приводит к генерации кода ответа 500 - ошибка конфигурации сервера: "Internal Server Error".
Примеры использования.htaccess
Индексные страницы
Индексные файлы - это файлы, загружаемые по умолчанию, если в URL не указан ресурс. Например:
http://site.ru/ - ресурс не указан (файл, страница), но всё равно сервер подгрузит что-то вроде index.html.
Могут возникнуть ситуации, когда необходимо изменить состав индексных файлов, например, если нужна индексная страница index.php, а в основном конфигурационном файле httpd.conf она не прописана. Эту задачу можно решить при помощи файла.htaccess, в котором необходимо создать директиву DirectoryIndex, где будут перечислены имена индексных страниц:
DirectoryIndex index.php index.html index.htm
При запросе каталога без указания имени файла сначала будет осуществлён поиск страницы с именем index.php, а если она не найдена, тогда index.html и т.д. до конца списка, пока не будет найдена и открыта соответствующая страница.
Запрет на отображение содержимого каталога при отсутствии индексного файла
Часто требуется запретить отображение списка файлов в каталоге, если не указан или отсутствует индексный файл.Например, запретить отображение содержимого каталога с изображениями. Если такой запрет не поставить, то пользователь, обратившийся напрямую к такому каталогу, получит список всех изображений. Но мы добавим директиву
Options –Indexes
Обработка кодов ответов Web-сервера
Ни один сайт не засрахован от возникновения ошибок. Самой частой ошибкой является переход по ссылке на несуществующую страницу. В этом случае Apache генерирует код ответа 404 и отображает автоматически сгенерированную страницу с сообщением об ошибке. Наличие несуществующих страниц производит плохое впечатление на посетителей сайта. Это впечатление можно сгладить, если вместо стандартных страниц, подставлять собственные страницы с сообщением об ошибке. За назначение страниц - обработчиков кодов ответа протокола HTTP несёт ответственность директива ErrorDocument
ErrorDocument 401 /401.html
ErrorDocument 403 /403.html
ErrorDocument 404 /404.html
ErrorDocument 500 "Forbidden"
После директивы ErrorDocument следует указать код ответа и страницу, на которую необходимо перенаправить посетителя при возникновении данного кода ответа.
Также, вместо адреса страницы, можно указывать простой текстовый ответ в кавычках.
Расшифровка нескольких кодов ответов сервера (HTTP response status codes):
401 ошибка - Запрос требует аутентификации пользователя (Unautorized).
403 ошибка - Доступ к запрашиваемому ресурсу запрещён (Forbidden).
404 ошибка - Запрашиваемый документ на сервере отсутствует (Not Found).
500 ошибка - Ошибка конфигурации сервера или внешней программы (Internal Server Error).
Разрешение или запрет выполнения кода PHP
Разрешение выполнения. Обычно PHP-код в HTML выполняется в файлах с расширениями php. Иногда возникают ситуации, когда необходимо выполнять PHP-код в файлах с другим расширением. В этом случае можно дать указание Web-серверу выполнять PHP-код не только в файлах с расширением php, но и в файлах с расширением html.
RemoveHandler .html .htm
AddType application/x-httpd-php .php .htm .html .phtml
Первая строка удаляет обработчик файлов с расширениями html и htm, а вторая строка сообщает серверу о необходимости использовать для файлов с расширениями htm и html обработчик PHP.
Запрет выполнения PHP, например в каталоге с картинками:
php_flag engine 0
RemoveHandler .phtml .php .php3 .php4 .php5
AddType text/html .phtml .php .php3 .php4 .php5
- элементарная защита от хаков с загрузкой шела.
Задание кодировки на сервере
Указанная кодировка отправляется браузеру в заголовке Content-Type и позволит браузеру клиента автоматически переключиться на требуемую кодировку.
AddDefaultCharset utf-8
Задание кодировки загружаемых файлов
При загрузке файлов на сервер можно указать, в какой кодировке сервер должен ожидать файл.
CharsetSourceEnc windows-1251
Отключение директивы MultiViews
Включённая на хостинге опция MultiViews может вызвать неожиданные проблемы, например, отображение несуществующих страниц сайта или отсутствие доступа к существубщим. Допустим, на сайте существует страница с адресом http://www.sait.ru/down.php, и если посетители обратятся к несуществующему каталогу http://www.sait.ru/down/, то включённая опция MultiViews вместо этого каталога подставит файл down.php. Однако подстановка будет выполнена не полностью - пути к изображениям, таблицам стилей и т.п. будут подставлены неверно. То есть страница будет отображена с искажениями. Для подавления такого поведения Apache опцию MultiViews следует отключить.
Options -MultiViews
Запрет доступа к файлам
Для того чтобы посетители не могли получить доступ к служебным файлам из окна браузера, можно запретить доступ к таким файлам. Для этого используется директива запрета Deny и разрешения доступа Allow.
Примечание
Использование директив Deny и Allow управляет только доступом к файлам из браузера, либо из другой программы-клиента. Подобные запреты не распространяются на скрипты сервера.
Запрет доступа к файлам из браузера Deny from all
При использовании такой директивы будет запрещён доступ из браузера ко всем файлам и каталогам текущего каталога. Запрет доступа к определенному файлу, например, здесь запрещен доступ только к файлам с именем config.php
Запрет доступа к файлам расширения inc
Для запрета доступа к файлам с несколькими типами расширений можно использовать регулярные выражения:
Запрещен доступ к файлам с расширением inc, conf и cfg
Или использовать конструкцию FilesMatch:
Запрещен доступ к файлам, имя которых начинается с " .ht " (точка, далее ht, далее что угодно).
Запретить или разрешить доступ с определенного IP-адреса или подсети
Order deny, allow
Deny from 100.111.222.70
133.252.0.0/24
Разрешить доступ только с определенного IP-адреса
Order deny, allow
Deny from all
Allow from 100.111.222.70
Директива Order позволяет задать порядок, в котором будут выполняться директивы. Сначала выполняется директива запрета доступа (Deny), а затем разрешается доступ то для IP-адреса 100.111.222.70 (Allow). Если в первой строке поменять порядок следования директив на Order allow, deny, то доступ для IP-адреса 100.111.222.70 не будет открыть, т.к. директива Deny, выполняемая последней, перекроет действие директивы Allow.
Примечание:
Следует отметить, что разрешение доступа с определённого IP-адреса иногда может не сработать. Например, в том случае, если на хостинге установлен обратный кэширующий proxy-сервер. Если директивы разрешения доступа не работают, то вам нужно обратиться по этому вопросу в службу технической поддержки хостинга.
Перенаправление на другой адрес (redirect)
Часто встречаются задачи, когда все запросы к определённому адресу нужно перенаправить на другой адрес. Это можно сделать с помощью директив Redirect и RedirectMatch. Они сообщают, что ресурс по запрошенному url отсутствует, и указывают адрес, по которому следует перейти.
Сервер с помощью директивы Redirect посылает браузеру соответствующий заголовок, и уже браузер осуществляет перенаправление.
Глобальное перенаправление на новый адрес
Redirect / http://www.site.ru/
Перенаправление при обращении к определённому файлу
Redirect /books/index.php http://www.site.ru/new/
Перенаправление при обращении к любым страницам каталога
RedirectMatch /books/.* http://www.site.ru/new/
Перенаправление при обращении к любым страницам сайта
RedirectMatch /.* http://www.site2.ru/
Также можно использовать условный редирект, например при заходе на сайт с www (www.site.ru) или на субдомен "sub.site.ru" надо перенаправлять на основной домен без www:
RewriteCond %{SERVER_NAME} ^www\.site\.ru
RewriteCond %{SERVER_NAME} (www\.)?sub\.site\.ru
RewriteRule ^(.*)$ http://site.ru/$1
Или дать отпор нехорошим ботам:
RewriteCond %{HTTP_USER_AGENT} (crawler|spider|scraper)
RewriteCond %{HTTP_USER_AGENT} (Excite|360Spider|haosou|MJ12bot)
#Никого нет дома
RewriteRule ^(.*)$ -
#или вообще Forbidden
#RewriteRule ^(.*)$ -
Если вас заинтересовало конфигурирование режимов WEB-сервера через файл.htaccess - почитайте в документации веб-сервера Apache про модуль mod_rewrite и.htaccess.
Для того, что бы.htaccess можно было использовать — необходимы соответствующие настройки главного конфигурационного файла Apache -
httpd.conf
.
AllowOverride
. Она может быть установлена как для всего сервера (глобально), так и для отдельного каталога.
Директива AllowOverride может включать в себя одну из следующих директив или их комбинацию: All, None, AuthConfig, FileInfo, Indexes, Limit, Options .
AllowOverride All
Синтаксис.htaccess
redirect /company http://www.newsite.com/newcompany
redirect /forum http://www.newsite.com/newforum
SetEnvIf REMOTE_ADDR 192.145.121.1 REDIR= "redir"
RewriteCond %{REDIR} redir
RewriteRule ^/$ /only_for_you.html
DirectoryIndex index.html index.php inde x.shtml
RemoveHandler .html .htm
AddType application/x-httpd-php .php .ht m .html .phtml
Обработка ошибок Apache
ErrorDocument 401 /401.html
ErrorDocument 403 /403.html
ErrorDocument 404 /404.html
ErrorDocument 500 /500.html
Options -Indexes
AddDefaultCharset windows-1251
CharsetSourceEnc windows-1251
Запрет доступа ко всем файлам
deny from all
order deny,allow
deny from all
allow from 195.135.232.70
deny from 195.135.232.70
[Error:
Irreparable invalid markup ("
Для того, что бы.htaccess можно было использовать — необходимы соответствующие настройки главного конфигурационного файла Apache - httpd.conf.
В файле httpd.conf должны быть прописаны директивы, которые разрешат файлу.htaccess переопределять конфигурацию web-сервера в каталоге. Эта директива называется AllowOverride. Она может быть установлена как для всего сервера (глобально), так и для отдельного каталога.
Директива AllowOverride может включать в себя одну из следующих директив или их комбинацию: All, None, AuthConfig, FileInfo, Indexes, Limit, Options.
Для того чтобы дать директивам файлов.htaccess максимальные права следует прописать в httpd.conf:
AllowOverride All
Синтаксис.htaccess
Перед тем, как будут рассмотрены примеры, остановимся на синтаксисе директив в файлах.htaccess.
- Пути к файлам и директориям должны указываться от корня сервера, например, /pub/home/server1/html/
Если вы не знаете путь от корня сервера, то Вы можете его узнать, спросив у администратора сервера, либо можете посмотреть сами, запустив на сайте функцию PHP — phpinfo(). Она выведет на экран конфигурацию PHP в виде фиолетовых таблиц. В них Вам необходимо найти переменную doc_root и посмотреть ее значение — это будет путь от корня сервера до Вашей основной директории.
- В именах доменов обязательно должны быть указаны протоколы, например:
Примеры использования.htaccess
Глобальное перенаправление (редирект) на другой адрес:
Redirect / http://www.newsite.ru
Перенаправление (редирект) только при запросе определенных страниц:
redirect /company http://www.newsite.com/newcompany
redirect /forum http://www.newsite.com/newforum
При запросе страниц из каталогов company и forum будет произведено перенаправление на новые адреса.
Перенаправление (редирект) только посетителей с определенным IP-адресом:
SetEnvIf REMOTE_ADDR 192.145.121.1 REDIR="redir"
RewriteCond %{REDIR} redir
RewriteRule ^/$ /only_for_you.html
Если посетитель имеет IP-адрес 192.145.121.1, то ему будет открыта страница only_for_you.html.
Изменение названия индексной страницы:
DirectoryIndex index.html index.php index.shtml
Можно указать несколько индексных страниц. При запросе каталога они будут искаться в том порядке, в котором перечислены в директиве DirectoryIndex. Если не будет найден файл index.html, то будет произведен поиск файла index.php и т.д.
Выполнять код PHP в файлах HTML
RemoveHandler .html .htm
AddType application/x-httpd-php .php .htm .html .phtml
Добавив эти строки в.htaccess вы дадите директиву серверу выполнять инструкции PHP не только в файлах с расширением *.php и *.phtml, но и в файлах с расширением *.htm и *.html.
Обработка ошибок Apache
ErrorDocument 401 /401.html
ErrorDocument 403 /403.html
ErrorDocument 404 /404.html
ErrorDocument 500 /500.html
При возникновении этих ошибок посетитель будет перенаправлен на специально созданные страницы.
- 401 ошибка — Требуется авторизация (Authorization Required).
- 403 ошибка — пользователь не прошел аутентификацию, доступ запрещен (Forbided).
- 404 ошибка — Документ не найден (Not Found).
- 500 ошибка — Внутренняя ошибка сервера (Internal Server Error).
Запрет на отображение содержимого каталога при отсутствии индексного файла
Options -Indexes
Определение кодировки, в которой сервер "отдает" файлы
AddDefaultCharset windows-1251
Определение кодировки на загружаемые файлы
CharsetSourceEnc windows-1251
Запрет доступа ко всем файлам
deny from all
Запрещен доступ ко всем файлам и каталогам в текущей директории.
Разрешить доступ только с определенного IP-адреса
order deny,allow
deny from all
allow from 195.135.232.70
Строка order deny,allow определяет, в каком порядке следует выполнять директивы. Сначала выполняется директива запрета доступа, а затем разрешается доступ только для IP-адреса 195.135.232.70. Если в первой строке поменять порядок следования директив на order allow,deny, то доступ для данного IP-адреса не будет открыть, так как директива deny, выполняемая последней перекроет действия директивы allow.
Запретить доступ с определенного IP-адреса
deny from 195.135.232.70
Запретить доступ к определенному файлу
deny from all
Запрещен доступ посетителей к файлам config.php. Этот запрет не действует на скрипты web-сервера. Они по прежнему будут иметь доступ к этому файлу.
Запретить доступ к файлам с определенным расширением
Здесь запрещен доступ к файлам с расширением *.conf. Директива
? - любой одиночный символ
* - любая последовательность символов, исключая символ / (слеш)
Запретить доступа к файлам с несколькими типа расширений
Запрещен доступ к файлам с расширением *.inc, *.conf и *.cfg. Хотя директива
[тильда] [пробел] [далее_все_без_пробелов]
Установка пароля на директорию
AuthName "Admin page"
AuthType Basic
AuthUserFile /pub/home/server/.pass
require valid-user
Apache
- самый распространённый HTTP-сервер
. Распространяется бесплатно,
включая исходные тексты.
Поддерживаются сценарии на CGI
(включая FastCGI
), PHP
, Perl
, Java
. Аутентификация
- базовая
, message-digest
, TLS
(SSL)
. С апреля 1996 это самый популярный HTTP-сервер
в Интернете,
в августе 2007 года он работал на 51% всех веб-серверов.
.htaccess
- файл дополнительной конфигурации веб-сервера Apache
, а также подобных ему серверов.
Позволяет задавать большое
количество дополнительных параметров и разрешений для работы веб-сервера у отдельных пользователей (а также на
различных папках отдельных пользователей),
таких как управляемый доступ к каталогам
, переназначение типов файлов
и т.д., не предоставляя доступа
к главному
конфигурационному файлу, т.е. не влияя на
работу всего сервиса целиком.
.htaccess является подобием httpd.conf с той разницей, что действует только на каталог, в котором располагается, и на его дочерние каталоги. Возможность использования .htaccess присутствует в любом каталоге пользователя.
Файл .htaccess может быть размещен в любом каталоге сайта. Директивы этого файла действуют на все файлы в текущем каталоге и во всех его подкаталогах (если эти директивы не переопределены директивами нижележащих файлов .htaccess ).
Директивы .htaccess
предоставляют пользователю широкий выбор возможностей по настройке своего сайта,
среди которых:
|
|
Список всех доступных директив можно посмотреть .
Описываются предпочтения клиента относительно типа документа.
IP-адрес посетителя.
Адрес посетителя в нормальной форме - например, rt99.net.ru
.
Имя удаленного пользователя. Имеет формат имя.хост, например, kondr.www.rtt99.net.ru
Тоже, что и REMOTE_IDENT, но содержит только имя. Пример: kondr
Позволяет определить тип запроса (GET или POST). Должен обязательно анализироваться, т.к.
определяет дальнейший способ обработки информации.
Полный путь к веб-странице на сервере.
Содержит в себе все, что передавалось в скрипт.
Содержит строчку, переданную в качестве запроса при вызове CGI
скрипта.
Используется для идентификации пользователя
Cодержит путь к корневой директории сервера.
Почтовый адрес владельца сервера, указанный при установке.
IP-адрес вашего сайта.
Порт, на котором работает Apache.
Версия HTTP
протокола.
Название сервера, например, Apache/1.3.2 (Unix)
TIME_MON
TIME_DAY
TIME_HOUR
TIME_MIN
TIME_SEC
TIME_WDAY
TIME
Переменные, предназначеные для работы со временем в разных форматах.
Это версия API
модуля Apache
(внутренний интерфейс между сервером и модулем) в
текущей сборке сервера, что определено в include/ap_mmn.h
.
Полная строка HTTP
-запроса, отправленная браузером серверу (т.е., «GET /index.html
HTTP/1.1»
).
Она не включает какие-либо дополнительные заголовки отправляемые браузером.
Ресурс, запрошенный в строке HTTP-запроса.
Полный путь в файловой системе сервера к файлу или скрипту, соответствующему этому запросу.
Условие - это шаблон условия, т.е. какое-либо регулярное выражение, применяемое к текущему экземпляру
"Сравниваемая Строка", т.е. "Сравниваемая Строка" просматривается на поиск соответствия Условию.
Помните, что Условие это perl
-совместимое регулярное выражение с некоторыми дополнениями:
Все эти проверки также могут быть предварены префиксом восклицательный знак ("!") для инвертирования их значения.
RewriteEngine
включает или выключает работу механизма преобразования. Если она установлена в положение
off
, этот модуль совсем не работает.
Заметьте, что по умолчанию настройки преобразований не наследуются. Это означает, что вы должны иметь RewriteEngine
on директиву для каждого
виртуального хоста, в котором вы хотите использовать этот модуль.
Синтаксис RewriteEngine
выглядит следующим образом:
Используйте для комбинирования условий в правилах OR
вместо AND
. Типичный пример - перенаправление
запросов на поддомены в отдельные каталоги.
Для выдачи разных сайтов для разных браузеров, согласно «User-Agent:»
заголовку запроса,
Вы можете использовать следующие директивы:
В подстановке вы можете использовать, в том числе, и специальные флаги путем добавления в качестве третьего аргумента директивы RewriteRule . Флаги - это разделённый запятыми следующий список флагов:
"redirect|R [=code]"
(вызывает редирект)
Префикс в Подстановке вида http://thishost[:thisport]/
(создающий новый URL
из какого-либо
URI
)
запускает внешний редирект (перенаправление). Если нет никакого кода, в подстановке ответ будет со
HTTP
статусом 302 (ВРЕМЕННО ПЕРЕМЕЩЕН). Для остановки процесса преобразования
вам также нужно написать флаг "L"
.
"forbidden|F [=code]"
(делает URL запрещенным)
Это делает текущий URL
запрещённым, например, клиенту немедленно отправляется ответ
с HTTP
статусом 403 (ЗАПРЕЩЕНО). Используйте этот флаг в сочетании с соответствующими
RewriteConds
для блокирования URL
по некоторым критериям.
"gone|G [=code]"
(делает URL «мёртвым»)
Этот флаг делает текущий URL
«мертвым», т.е., немедленно отправляется HTTP
ответ
со статусом 410 (GONE
). Используйте этот флаг для маркировки «мертвыми» несуществующие более
страницы.
"proxy|P [=code]"
(вызвает прокси)
Этот флаг помечает подстановочную часть как внутренний запрос прокси и немедленно
(т.е. процесс преобразования здесь останавливается) пропускает его через прокси-модуль.
Используйте этот флаг для того, чтобы добиться более мощной реализации директивы ProxyPass
,
интегрирующей некоторое содержимое на удаленных серверах в пространство имён локального сервера.
"last|L [=code]"
(последнее правило)
Остановить процесс преобразования на этом месте и не применять больше никаких
правил преобразований. Используйте этот флаг для того, чтобы не преобразовывать
текущий URL
другими, следующими за этим, правилами преобразований.
"next|N [=code]"
(следуюший раунд)
Перезапустить процесс преобразований (начав с первого правила). В этом случае URL
снова
сопоставляется неким условиям, но не оригинальный URL
, а URL
вышедший из последнего
правила преобразования. Используйте этот флаг для перезапуска процесса преобразований, т.е.
безусловному переходу на начало цикла.
"chain|C [=code]"
(связь со следующим правилом)
Этот флаг связывает текущее правило со следующим (которое, в свою очередь, может
быть связано со следующим за ним, и т.д.). Это имеет следующий эффект: если есть
соответствие правилу, процесс продолжается как обычно, т.е. флаг не производит
никакого эффекта. Если правило не соответствует условию, все следующие, связанные
правила, пропускаются.
"type|T=MIME-тип [=code]"
(принудительно установить MIME тип)
Принудительно установить MIME-тип
целевого файла в MIME-тип
. К примеру, это можно
использовать для имитации mod_alias
директивы ScriptAlias
, которая принудительно
устанавливает для всех файлов внутри отображаемого каталога MIME
тип
равный «application/x-httpd-cgi»
.
"nosubreq|NS [=code]"
(используется только в случае не внутреннего подзапроса)
Этот флаг дает команду механизму преобразований пропустить директиву, если текущий подзапрос
является внутренним подзапросом. К примеру, внутренние подзапросы в Apache
происходят тогда,
когда mod_include пытается получить информацию о возможных файлах по умолчанию для каталогов
(index.xxx). При подзапросах это не всегда полезно и даже иногда вызывает проблему в работе
набора директив преобразований. Используйте этот флаг для исключения некоторых правил.
"nocase|NC [=code]"
(не учитывать регистр)
Это делает Шаблон нечувствительным к регистру, т.е. нет различий между "A-Z" и "a-z",
когда Шаблон применяется к текущему URL
.
"qsappend|QSA [=code]"
(добавлять строку запроса)
Этот флаг указывает механизму преобразований на добавление, а не замену,
строки запроса из URL
к существующей, в строке подстановки. Используйте
это когда вы хотите добавлять дополнительные данные в строку запроса с
помощью директив преобразований.
"noescape|NE [=code]"
Этот флаг не даёт mod_rewrite
применять обычные правила экранирования URI
к результату
преобразования.
Обычно, специальные символы (такие как "%", "$", ";", и так далее) будут экранированы их шестнадцатиричными
подстановками ("%25", "%24", и "%3B", соответственно); этот флаг не дает это делать.
(не экранировать URI при выводе)
Если в подкаталогах в .htaccess нет ни одной директивы модуля mod_rewrite , то все правила преобразования наследуются из родительского каталога.
При наличии в файле .htaccess каких-либо директив модуля mod_rewrite не наследуется ничего, а состояние по умолчанию выставляется таким же, как в главном конфигурационном файле веб-сервера (по умолчанию "off"). Поэтому, если нужны правила преобразования для конкретного каталога, то нужно еще раз вставить директиву "RewriteEngine on " в .htaccess для конкретного каталога.
При наследовании правил из верхних каталогов и добавлении к ним новых свойственных только данному каталогу - необходимо выставить в начале следующее: "RewriteEngine on " и "RewriteOptions inherit " - последняя директива сообщает серверу о продолжении.
Примеры использования mod_rewrite можно посмотреть
Если у Вас установлена операционная система семейства Windows , Вы можете подключится к серверу по SSH (инструкцию по подключению можно найти ) и воспользоваться утилитой htpasswd .
Запустив htpasswd
без параметров мы увидим:
|
beget@ginger
~ #
htpasswd Usage: htpasswd [-cmdps] passwordfile username htpasswd -b passwordfile username password -c Create a new file. beget@ginger ~ # |
Здесь не будут рассматриваться все параметры этой команды, но вы можете сами прочитать подробности, запустив htpasswd в unix shell , или ознакомившись с соответствующей страницей документации по Apache.
Итак, изначально у нас еще нет файла с паролями и нам нужно его создать:
А теперь мы хотим добавить еще одного пользователя. Так как файл с паролями у нас уже есть,
мы просто не будем использовать ключ "-c" :
Указывая valid-user , Вы разрешаете доступ всем пользователям, перечисленным в файле паролей.
Приведем пример для доступа определенных пользователей из файла с паролями .htpasswd
|
|
Следует помнить, что при таком ограничении доступа пароли передаются по каналам связи в открытом виде и при определенных обстоятельствах могут быть перехвачены злоумышленниками. Поэтому в целях безопасности рекомендуется организовывать доступ к закрытым областям веб-сайта через защищенное SSL-соединение .
