Настройка mod_rewrite на веб-сервере Apache в CentOS 7

Amber

6 лет назад

Apache – это модульный веб-сервер (то есть, он позволяет настраивать функции путём включения и отключения модулей). Это предоставляет администраторам возможность максимально точно подгонять настройки веб-сервера под требования приложений.

Данное руководство поможет установить Apache на сервер CentOS 7 и настроить поддержку mod_rewrite.

Требования

Сервер CentOS 7.
Пользователь с доступом к sudo (подробности можно найти в руководстве Создание пользователя sudo в CentOS).

1: Установка Apache

Apache можно установить с помощью пакетного менеджера yum.

sudo yum install httpd

Команда запросит подтверждения:

Is this ok [y/d/N]:

Чтобы продолжить установку, введите Y и нажмите Enter.

Запустите демон Apache (это автономный процесс, который создаёт пул дочерних процессов или потоков для обработки запросов):

sudo systemctl start httpd

Чтобы убедиться в том, что запуск Apache прошёл успешно, введите:

sudo systemctl status httpd . . . systemd[1]: Starting The Apache HTTP Server... systemd[1]: Started The Apache HTTP Server.

Сервер Apache успешно установлен. Теперь нужно сосредоточить внимание на модулях.

2: Модуль mod_rewrite

В CentOS 7 модуль mod_rewrite поддерживается по умолчанию. Проверьте, так ли это. Используйте команду httpd с флагом –M, чтобы вывести список включенных модулей:

httpd -M . . . remoteip_module (shared) reqtimeout_module (shared) rewrite_module (shared) setenvif_module (shared) slotmem_plain_module (shared) . . .

Если в списке нет модуля rewrite_module, включите его вручную. Отредактируйте 00-base.conf.

sudo vi /etc/httpd/conf.modules.d/00-base.conf

Когда текстовый редактор откроется, перейдите в режим вставки (нажмите i) и добавьте в файл:

# # This file loads most of the modules included with the Apache HTTP # Server itself. # . . . LoadModule rewrite_module modules/mod_rewrite.so . . .

Чтобы выйти из режима вставки, нажмите Esc. Нажмите :x и Enter, чтобы сохранить и закрыть файл.

Обновите настройки веб-сервера:

sudo systemctl restart httpd

Теперь можно приступать к созданию файла .htaccess.

3: Создание файла .htaccess

Файл .htaccess определяет индивидуальные директивы Apache (включая RewriteRule) для каждого отдельного домена.

Примечание: В Linux с символа точки начинаются имена скрытых файлов.

Сначала нужно включить поддержку файлов .htaccess. Дляэтого отредактируйте директиву AllowOverride:

sudo vi /etc/httpd/conf/httpd.conf

Найдите в этом файле раздел <Directory /var/www/html>. Он содержит AllowOverride. Измените значение None на All.

. . . <Directory /var/www/html> . . . # # AllowOverride controls what directives may be placed in .htaccess files. # It can be "All", "None", or any combination of the keywords: # Options FileInfo AuthConfig Limit # AllowOverride All . . . </Directory> . . .

Сохраните и закройте файл. Перезапустите Apache:

sudo systemctl restart httpd

Создайте файл .htaccess в стандартном каталоге document root (/var/www/html):

sudo vi /var/www/html/.htaccess

Добавьте в начало файла следующую строку, чтобы активировать RewriteEngine. Так Apache сможет обрабатывать правила перезаписи.

RewriteEngine On

Теперь на сервере есть файл .htaccess, который позволяет установить правила перезаписи URL-ов. Прежде чем приступить к написанию этих правил, нужно ознакомиться с синтаксисом mod_rewrite.

4: Синтаксис RewriteRule

Директива RewriteRule позволяет преобразовать запросы Apache на основе URL-адреса. Файл .htaccess может содержать множество правил перезаписи. Apache применяет правила в том порядке, в котором они определены в файле. RewriteRule имеет такую структуру:

RewriteRule Pattern Substitution [Flags]

Где:

RewriteRule: собственно директива.
Pattern: библиотека PCRE (Perl Compatible Regular Expression). Больше информации об этом можно найти здесь.
Substitution: куда отправить поступивший запрос.
[Flags]: опциональные параметры, изменяющие поведение правила. Список доступных флагов можно найти в документации Apache.

Директива RewriteRule очень важна для mod_rewrite.

5: Синтаксис RewriteCond

Директива RewriteCond позволяет добавлять условия в правило перезаписи. Условие перезаписи состоит из следующих компонентов:

RewriteCond TestString Condition [Flags]

RewriteCond: директива.
TestString: строка, которую нужно проверить.
Condition: шаблон, которому должна отвечать строка.
[Flags]: опциональные параметры.

Благодаря директиве RewriteCond Apache пвыполняет перезапись только в том случае, если определённое условие истинно.

6: Создание тестового файла

Создайте простое правило, которое позволит пользователям получать доступ к странице about.html без расширения (.html). Для начала создайте файл about.html в каталоге document root:

sudo vi /var/www/html/about.html

Скопируйте следующий код HTML и вставьте в файл:

<!DOCTYPE html> <html> <head> <title>About Us</title> </head> <body> <h1>About Us</h1> </body> </html>

Сохраните и закройте файл.

Откройте браузер и перейдите по ссылке:

http://server_domain_or_IP/about.html

На экране появится страница с заголовком About Us. Попробуйте удалить из ссылки расширение .html. Браузер отобразит сообщение об ошибке 404 Not Found. По умолчанию Apache получает доступ к компонентам с помощью полного имени файла. Модуль mod_rewrite может изменить это поведение.

7: Настройка RewriteRule

Теперь попробуйте сделать так, чтобы посетители страницы About Us могли получить к ней доступ без расширения .html в ссылке. Для этого нужно создать правило.

Откройте .htaccess:

sudo vi /var/www/html/.htaccess

Найдите строку RewriteEngine On и добавьте после неё следующую строку:

RewriteRule ^about$ about.html [NC]

Сохраните и закройте файл.

Теперь в ссылке на страницу About Us не будет расширения:

http://server_domain_or_IP/about

Рассмотрим это правило подробнее:

^about$ – шаблон, с которым совпадает URL, и который пользователи вводят в браузере. В данном примере используются метасимволы, благодаря которым можно чётко обозначить местонахождение шаблона: символ ^ определяет начало шаблона (после server_domain_or_IP/), а & – конец.
about.html – путь к файлу, который обслуживает Apache, когда встречает этот шаблон.
[NC] – флаг, который отключает учет регистра, благодаря чему пользователи могут вводить адрес как в верхнем, так и в нижнем регистре. К примеру, URL-адреса serverdomainor_IP/about, serverdomainor_IP/About и serverdomainor_IP/ABOUT отобразят страницу about.html.

Общие шаблоны

Итак, теперь вы знаете основы написания правил перезаписи. Рассмотрим два дополнительных примера.

Примечание: Для тестирования можно создать пару дополнительных файлов.

Пример 1: Упрощение строки запросов с помощью RewriteRule

Приложения часто используют строки запросов. Эти строки находятся в URL-адресе, начиная с вопросительного знака (?) и заканчивая амперсандом (&). Обрабатывая правила перезаписи, Apache игнорирует эти два символа. К примеру, URL страницы результатов поиска, написанной на PHP, может выглядеть следующим образом:

http://example.com/results.php?item=shoes&type=women

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

http://example.com/shoes/women

Этого можно добиться двумя способами: с помощью простой замены или группирования параметров.

1: Простая замена

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

RewriteRule ^shoes/women$ results.php?item=shoes&type=women

Это правило вместо results.php?item=shoes&type=women будет использовать shoes/women.

2: Сопоставление и группирование

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

Задать набор параметров, разделив их с помощью символа вертикальной черты | (логический оператор OR).
Сгруппировать все заданные параметры с помощью круглых скобок (), а затем сослаться на группу с помощью переменной $1 (где 1 – номер группы параметров).

В результате получится такое правило:

RewriteRule ^shoes/(men|women|youth) results.php?item=shoes&type=$1

Это правило добавляет в URL новый сегмент.

3: Совпадение наборов символов

Чтобы пользователь мог открыть чистый URL любого раздела сайта (не только /shoes), нужно:

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

RewriteRule ^([A-Za-z0-9]+)/(men|women|youth) results.php?item=$1&type=$2

Это правило преобразует:

http://example.com/pants/men

в:

http://example.com/results.php?item=pants&type=men

4: Дополнительная строка запроса

Это позволит вам устранить ряд потенциальных проблем. Попробуйте преобразовать:

http://example.com/pants/men?page=2

в:

http://example.com/results.php?item=pants&type=men&page=2

При текущих настройках вы не сможете перейти на page=2. Это можно исправить с помощью флага QSA, который позволяет комбинировать строки запросов. Отредактируйте правило следующим образом:

RewriteRule ^([A-Za-z0-9]+)/(men|women|youth) results.php?item=$1&type=$2 [QSA]

Пример 2: Условия RewriteCond

Теперь рассмотрим подробнее директиву RewriteCond. Если условие перезаписи истинно, Apache обработает следующее за ним правило RewriteRule.

1: Страница по умолчанию

Ранее вы видели, что в случае если запрашиваемой страницы не существует, Apache возвращает страницу ошибки 404 Not Found. Однако вместо этого Apache может перенаправлять все подобные запросы на домашнюю страницу. Добавьте следующее условие, чтобы убедиться, что запрашиваемый файл существует:

RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^admin/(.*)$ /admin/home

Теперь все ссылки на несуществующие страницы будут перенаправлены на /admin/home.

Рассмотрим вышеприведённое правило по частям:

%{REQUEST_FILENAME} проверяет запрашиваемую строку.
!-f: оператор ! (not) указывает, что если запрашиваемого файла не существует, веб-сервер должен выполнить следующее правило переадресации.
RewriteRule перенаправляет запрос на /admin/home.

Также можно задать ErrorDocument, на который будут отправляться все запросы на несуществующие страницы. Создайте правило ErrorDocument и перенаправьте все ошибки 404 на страницу error.html:

ErrorDocument 404 /error.html

Теперь все запросы, которые получили ошибку 404, будут переадресованы на error.html.

2: Ограничение доступа по IP

RewriteCond позволяет ограничивать доступ к сайту по IP-адресу.

К примеру, это правило заблокирует весь трафик, кроме 198.51.100.24:

RewriteCond %{REMOTE_ADDR} !^(198\.51\.100\.24)$ RewriteRule (.*) - [F,L]

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

Вкратце рассмотрим это правило:

%{REMOTE_ADDR} – строка адреса.
!^(198\.51\.100\.24)$ – IP-адрес. Обратный слеш позволяет обойти метасимвол «.».

Чтобы заблокировать доступ к сайту для определенного IP, используйте такое правило:

RewriteCond %{REMOTE_ADDR} ^(198\.51\.100\.24)$ RewriteRule (.*) - [F,L]

Существует множество способов управления доступом к сайту, и файл .htaccess – один из самых простых.

Заключение

Модуль mod_rewrite – один из основных компонентов Apache.

В данном руководстве вы научились создавать файл .htaccess и работать с директивами RewriteRule и RewriteCond.