Файл .htaccess: что это и как с ним работать

Что такое .htaccess

Файл .htaccess (с точкой в начале имени) — настройки Apache для одной папки. Они действуют на папку, где лежит файл, и на все вложенные папки. Если во вложенной папке есть свой .htaccess, его строки применяются после строк из папки выше и могут их заменить.

Apache читает .htaccess при каждом запросе, поэтому перезапускать ничего не нужно: правка действует со следующего открытия страницы. Хостинги Timeweb, Beget, Рег.ру и Спринтхост описывают .htaccess в своей справке — у них правила в этом файле работают.

nginx файл .htaccess не читает. А если у вас свой сервер с Apache, документация Apache советует писать настройки в файл сайта: .htaccess нужен там, где доступа к настройкам сервера нет.

Где лежит файл

Главный .htaccess лежит в корневой папке сайта — там же, где index.php или index.html. Его правила действуют на весь сайт. Файл в подпапке действует только на неё и её вложенные папки.

На VPS папку сайта покажет команда grep -Rn DocumentRoot /etc/apache2/sites-enabled/.

Как увидеть скрытый файл

Имя .htaccess начинается с точки, а такие файлы в Linux считаются скрытыми: файловый менеджер панели или программа для FTP могут их не показывать. Ищите в настройках менеджера пункт про скрытые файлы. В панели cPanel, по справке Рег.ру, путь такой: «Файлы» → «Менеджер файлов» → «Настройки» → «Показать скрытые файлы (dotfiles)».

На сервере скрытые файлы покажет команда ls -a в папке сайта — подробнее про ls.

Как создать файл

1. В файловом менеджере панели нажмите кнопку создания файла. У Timeweb: «Файловый менеджер» → «Создать файл».
2. Введите имя .htaccess — с точкой в начале, без пробелов и без окончания .txt. У Timeweb после ввода имени нажмите «Создать».
3. Откройте файл двойным щелчком, впишите строки и сохраните. У Timeweb — кнопка «Сохранить».

Файл можно подготовить и на компьютере, а потом загрузить в папку сайта по FTP. Сохраните его в кодировке UTF-8 и после загрузки проверьте имя — ровно .htaccess. Timeweb предупреждает: Блокнот Windows может добавить в начало файла невидимую метку BOM, и веб-сервер может прочитать файл неправильно. Поэтому Timeweb советует править файл в файловом менеджере панели или в редакторе Notepad++.

Как устроены строки

Пример файла с двумя правилами:

# Страница переехала на новый адрес
Redirect 301 /old-page/ https://example.com/new-page/

# Своя страница для ошибки 404
ErrorDocument 404 /404.html

• Одна настройка — одна строка. Первое слово — имя директивы, дальше через пробел её значения.
• Строка, которая начинается с #, — комментарий: Apache её пропускает. Комментарий пишут отдельной строкой.
• Имена директив можно писать в любом регистре, а в значениях регистр может иметь значение: Redirect различает /Old/ и /old/.
• Правила RewriteRule выполняются сверху вниз. Переадресацию на HTTPS ставят в самое начало файла — так советуют Beget и Спринтхост.
• Строки внутри блока <IfModule …> действуют, только если нужный модуль Apache включён. Если модуля нет, Apache пропускает блок без ошибки.

Если после правки сайт выдаёт ошибку 500

Ошибка в .htaccess — опечатка в имени директивы, лишний символ или директива, которую хостинг запрещает, — даёт ошибку 500 на всех страницах папки.

1. Верните сохранённую копию файла или уберите последние добавленные строки — сайт заработает.
2. Добавляйте строки по одной и после каждой открывайте сайт: так видно, какая из них ломает сайт.
3. Посмотрите журнал ошибок: на хостинге — в панели, на своём VPS — командой sudo tail -n 50 /var/log/apache2/error.log. В записи будет путь к файлу .htaccess и причина.

Что значат сообщения в журнале — Почему .htaccess не работает. Другие причины ошибки 500 — разбор ошибки.

.htaccess на своём VPS

В Ubuntu Apache по умолчанию не читает .htaccess: в его настройках для папки /var/www/ стоит AllowOverride None. Если сайт переехал с хостинга и правила из .htaccess не действуют, разрешите их для папки сайта.

Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне. Если система спросит пароль, введите пароль своего пользователя на сервере. Символы при вводе не видны — наберите пароль и нажмите Enter.

Откройте файл настроек сайта:

sudo nano /etc/apache2/sites-available/example.com.conf

Вместо example.com.conf — файл вашего сайта: список покажет ls /etc/apache2/sites-enabled/. В начало файла, перед строкой <VirtualHost *:80>, добавьте блок — путь замените на папку своего сайта:

<Directory /var/www/example.com>
    AllowOverride All
</Directory>

Блок стоит вне <VirtualHost>, поэтому действует и для HTTP, и для HTTPS. Затем включите модуль переадресаций mod_rewrite — в Ubuntu после установки Apache он выключен:

sudo a2enmod rewrite

Сохраните файл — Ctrl+O, Enter, затем Ctrl+X — и проверьте настройки: sudo apache2ctl configtest. В конце ответа должно быть Syntax OK. Тогда примените их: sudo systemctl restart apache2.

Если вместо Syntax OK пришла ошибка, Apache назовёт файл и номер строки: исправьте её и проверьте снова. Пока проверка не прошла, перезапуск не делайте.

Создать или открыть .htaccess на сервере можно так: sudo nano /var/www/example.com/.htaccess. Сохраните файл: в nano — Ctrl+O, Enter, затем Ctrl+X.

Какие задачи решает .htaccess

Ошибки и как их исправить