Шпаргалка по .htaccess Разработка

.htaccess — конфигурационный файл веб-сервера Apache, позволяющий управлять работой веб-сервера и настройками сайта с помощью различных параметров (директив) без изменения основного конфигурационного файла веб-сервера.

Директивы файла .htaccess действуют для каталога, в котором размещён такой файл и для всех его подкаталогов. Если вы желаете с помощью .htaccess изменить настройки для сайта в целом, его следует размещать в корневом каталоге сайта — ~/ваш_домен/docs.

Перенаправление c синонимов сайта на основной домен с редиректом 301

Перенаправить запросы на domain.ru с любого из синонимов сайта

RewriteEngine On
RewriteCond % !^domain\.ru$ [NC]
RewriteRule ^(.*)$ http://domain.ru/$1 [L,R=301]

Перенаправить запросы на www.domain.ru с любого из синонимов сайта

RewriteEngine On
RewriteCond % !^www\.domain\.ru$ [NC]
RewriteRule ^(.*)$ http://www.domain.ru/$1[L,R=301]

Данные правила рекомендуется размещать в самом начале файла .htaccess

Постоянное перенаправление с редиректом 301

Если вы изменили адрес страницы сайта, добавьте в  .htaccess следующие строки, чтобы запросы со старого адреса переадресовывались на новый.

Redirect 301 /page.html http://www.domain.ru/new_page.html

здесь:
page.html — адрес старой страницы относительно корня сайта;
www.domain.ru — имя сайта;
new_page.html — адрес страницы, на которую нужно выполнить перенаправление.
Обратите внимание, что подобное правило не сработает для перенаправления с адресов, содержащих Query String (символы после ?). Для запросов, содержащих QUERY_STRING, можно использовать сочетание RewriteCond и RewriteRule.

Например, для перенаправления всех запросов к странице /period/?test=123 вашего сайта на domain.ru, вы можете написать:

Options +FollowSymLinks
RewriteEngine On
RewriteCond % ^test=123$ [NC]
RewriteRule ^period/$ http://domain.ru/ [L,R=301]

Переопределение страниц ошибок

При помощи файла .htaccess вы можете установить свои страницы ошибок:

#401  Авторизация не выполнена
ErrorDocument 401 /401.html
#403  Доступ запрещен
ErrorDocument 403 /403.html
#404  Страница не найдена
ErrorDocument 404 /404.html
#500  Внутренняя ошибка сервера
ErrorDocument 500 /500.html

Соответствующие файлы страниц ошибок (401.html, 404.html и др.) необходимо разместить в каталоге ~/ваш_домен/docs/.

Для того чтобы при случайном упоминании прямых ссылок на такие страницы они не проиндексировались в поисковых системах, рекомендуется:

1. В файле ~/ваш_домен/docs/robots.txt указать:

User-agent: *
Disallow: /errors


2. Создать файл ~/ваш_домен/docs/errors/.htaccess, в котором указать:

Options -Indexes

Постраничный редирект запросов на другой домен c кодом 301

Следующий код перенаправит все запросы к страницам вашего сайта на аналогичные страницы другого сайта, например, запрос http://domain.ru/main будет переадресован на http://www.newdomain.ru/main:

Redirect 301 / http://www.newdomain.ru/

либо:

RewriteEngine On
RewriteRule ^(.*)$ http://newdomain.ru/$1 [R=301,L]

Ограничение доступа к сайту по IP

Запретить доступ к сайту с IP-адресов 123.4.5.6 и 123.5.4.3

Order Allow,Deny
Allow from all
Deny from 123.4.5.6 123.5.4.3

Запретить доступ к сайту со всех адресов кроме 123.4.5.6 и 123.5.4.3:

Order Deny,Allow
Deny from all
Allow from 123.4.5.6 123.5.4.3

Запретить доступ к сайту для всех:

Deny from all

Переопределение главной страницы сайта (индексного файла каталога)

Сделать главной страницей файл menu.html:

DirectoryIndex menu.html

Включение обработки PHP в .html-файлах

RemoveHandler .html .htm
AddType application/x-httpd-php .php .htm .html .phtml

Запрет выдачи листинга каталога

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

Options -Indexes

Включить выполнение CGI-скриптов в папке docs для файлов с расширениями .cgi, .pl, .py

В папке c CGI-скриптами необходимо разместить файл .htaccess с содержимым:

AddHandler cgi-script .cgi .pl .py
Options +ExecCGI


Скрипт должен иметь атрибут исполнения (+x, права доступа, начинающиеся с 7, например, 755).

Блокировка переходов со сторонних ресурсов

Для запрета перехода c baddomain.ru на domain.ru добавьте в .htaccess следующее:

RewriteEngine on
RewriteCond % baddomain\.ru [NC]
RewriteRule .* - [F]

Если требуется запретить переходы с нескольких доменов, то используйте следующие директивы:

RewriteEngine on
RewriteCond % baddomain\.ru [NC,OR]
RewriteCond % baddomain2\.ru [NC,OR]
RewriteCond % baddomain3\.ru [NC]
RewriteRule .* - [F]

Включение передачи заголовка Last-Modified для файлов .htm .html

По умолчанию на хостинге файлы .html .htm обрабатываются как SSI, поэтому для них не передается заголовок Last-Modified. Для включения в файл .htaccess необходимо добавить строку:

RemoveHandler .html. .htm

При этом файлы .html .htm уже не будут обрабатываться как SSI.

Особенности использования кириллических доменов

В файле .htaccess использование кириллицы не допускается. При составлении правил перенаправления для кириллических доменов необходимо указывать имя домена в punycode. Узнать имя домена в punycode можно с помощью сервиса WHOIS.

Например, для перенаправления site.ru на caйт.рф нужно воспользоваться следующим правилом:

RewriteEngine on
RewriteCond % ^www\.site.ru [NC]
RewriteRule ^(.*)$ http://xn--80aswg.xn--p1ai /$1 [R=301,L]

Обращаем ваше внимание, что в этом случае ваши посетители могут увидеть именно punycode-представление доменного имени в адресной строке браузера. Это не является ошибкой.

Диагностика ошибок

Если после редактирования или размещения .htaccess при обращении к сайту вы получили ошибку 500, то, скорее всего, в файле .htaccess допущена ошибка. Посмотреть причины её возникновения вы можете в log-файлах вашего сайта.

Если указанные вами в файле .htaccess правила не выполняются, необходимо убедиться, что обработка файла .htaccess включена и разрешена в настройках вашего хостинг-аккаунта.

Свяжитесь с нами если у Вас возникли вопросы
или позвоните:
+38 (050) 471-21-14
Vodafone, Украина