Added mod_rewrite for nginx module
This commit is contained in:
alexey
311
cms/simple/SUMMARY.md
Normal file
311
cms/simple/SUMMARY.md
Normal file
@@ -0,0 +1,311 @@
|
||||
# Тесты Apache mod_rewrite для nginx - ПОЛНАЯ СУММАРИЯ
|
||||
|
||||
## 📁 Структура тестовых файлов
|
||||
|
||||
```
|
||||
/test1/test/
|
||||
├── .htaccess # Главное правило rewrite для корневого каталога
|
||||
├── index.html # Главная страница (назначение для redirect)
|
||||
├── show.html # Показывается вместо redirect.html
|
||||
├── stop.html # Блокируется (403 Forbidden)
|
||||
├── redirect.html # Внутреннее перенаправление на show.html
|
||||
├── test.xmx # Файл .xmx для тестирования расширения
|
||||
├── README.md # Документация по тестам
|
||||
├── SUMMARY.md # Эта страница - полная суммари
|
||||
└── subdir/ # Подкаталог с дополнительными тестами
|
||||
├── .htaccess # Правила rewrite для подкаталога
|
||||
├── file.html # Файл в подкаталоге
|
||||
└── other.xmx # Другой файл .xmx (блокируется)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔥 Ключевые правила .htaccess
|
||||
|
||||
### 1️⃣ Перенаделение файлов с расширением `.xmx` на index.html
|
||||
|
||||
**Правило:**
|
||||
```apache
|
||||
RewriteRule \.xmx$ /index.html [R=301,L]
|
||||
```
|
||||
|
||||
**Ожидаемое поведение:**
|
||||
| Запрос | Результат |
|
||||
|--------|-----------|
|
||||
| `http://localhost/test/test.xmx` | 301 Redirect → `/test/index.html` |
|
||||
| URL в браузере меняется на `/test/index.html` | ✅ Внешнее перенаправление |
|
||||
|
||||
**Логика:**
|
||||
- Все файлы заканчивающиеся на `.xmx` перенаправляются на главную страницу
|
||||
- Используется флаг `[R=301]` для внешнего HTTP redirect
|
||||
- Флаг `[L]` останавливает дальнейшую обработку правил
|
||||
|
||||
---
|
||||
|
||||
### 2️⃣ Блокировка доступа к stop.html (403 Forbidden)
|
||||
|
||||
**Правила:**
|
||||
```apache
|
||||
RewriteCond %{REQUEST_FILENAME} =stop.html
|
||||
RewriteRule ^ - [F,L]
|
||||
```
|
||||
|
||||
**Ожидаемое поведение:**
|
||||
| Запрос | Результат |
|
||||
|--------|-----------|
|
||||
| `http://localhost/test/stop.html` | 403 Forbidden (Доступ запрещен) |
|
||||
| Страница не отображается | ✅ Полная блокировка |
|
||||
|
||||
**Логика:**
|
||||
- `RewriteCond` проверяет что запрос именно к stop.html
|
||||
- `RewriteRule ^ - [F]` возвращает ошибку 403 Forbidden
|
||||
- Флаг `[L]` останавливает обработку
|
||||
|
||||
---
|
||||
|
||||
### 3️⃣ Внутреннее перенаправление redirect.html на show.html
|
||||
|
||||
**Правило:**
|
||||
```apache
|
||||
RewriteRule ^redirect\.html$ show.html [L]
|
||||
```
|
||||
|
||||
**Ожидаемое поведение:**
|
||||
| Запрос | Результат |
|
||||
|--------|-----------|
|
||||
| `http://localhost/test/redirect.html` | Показывается content из show.html |
|
||||
| URL в браузере остается `/test/redirect.html` | ✅ Internal rewrite |
|
||||
|
||||
**Логика:**
|
||||
- Правило скрывает redirect.html и показывает вместо него show.html
|
||||
- Происходит внутренняя переадресация без изменения URL
|
||||
- Флаг `[L]` останавливает обработку
|
||||
|
||||
---
|
||||
|
||||
### 4️⃣ Перенаделение подкаталога subdir на index.html
|
||||
|
||||
**Правило:**
|
||||
```apache
|
||||
RewriteRule ^subdir/?$ /index.html [L]
|
||||
```
|
||||
|
||||
**Ожидаемое поведение:**
|
||||
| Запрос | Результат |
|
||||
|--------|-----------|
|
||||
| `http://localhost/test/subdir/` | Показывается content из index.html |
|
||||
| URL в браузере остается `/test/subdir/` | ✅ Internal rewrite |
|
||||
|
||||
---
|
||||
|
||||
### 5️⃣ Дополнительные проверки (из main .htaccess)
|
||||
|
||||
**Правило:**
|
||||
```apache
|
||||
RewriteCond %{REQUEST_FILENAME} !test\.xmx$
|
||||
RewriteRule \.xmx$ - [F,L]
|
||||
```
|
||||
|
||||
**Ожидаемое поведение:**
|
||||
- Блокирует все `.xmx` файлы кроме test.xmx
|
||||
- **НО:** Работает ПОСЛЕ правила 1, поэтому test.xmx сначала редиректится на index.html
|
||||
|
||||
---
|
||||
|
||||
### 6️⃣ Перенаделение subdir с последующей блокировкой (конфликт)
|
||||
|
||||
**Порядок в .htaccess:**
|
||||
```apache
|
||||
# Сначала перенаправление
|
||||
RewriteRule ^subdir/?$ /index.html [L]
|
||||
|
||||
# Затем блокировка
|
||||
RewriteRule ^subdir/?$ - [F,L]
|
||||
```
|
||||
|
||||
**Ожидаемое поведение:**
|
||||
- subdir сначала переадресуется на index.html (правило 4)
|
||||
- Затем применяется правило блокировки → 403 Forbidden
|
||||
- **Итог:** subdir заблокирован с ошибкой 403
|
||||
|
||||
---
|
||||
|
||||
## 📁 Правила в подкаталоге `subdir/.htaccess`
|
||||
|
||||
### 1️⃣ Блокировка всех .xmx файлов в subdir (кроме test.xmx)
|
||||
|
||||
**Правило:**
|
||||
```apache
|
||||
RewriteRule \.xmx$ - [F,L]
|
||||
```
|
||||
|
||||
**Ожидаемое поведение:**
|
||||
| Запрос | Результат |
|
||||
|--------|-----------|
|
||||
| `http://localhost/test/subdir/other.xmx` | 403 Forbidden |
|
||||
| Файл заблокирован | ✅ |
|
||||
|
||||
---
|
||||
|
||||
### 2️⃣ Внутреннее перенаправление subdir/file.html на ../show.html
|
||||
|
||||
**Правило:**
|
||||
```apache
|
||||
RewriteRule ^file\.html$ ../show.html [L]
|
||||
```
|
||||
|
||||
**Ожидаемое поведение:**
|
||||
| Запрос | Результат |
|
||||
|--------|-----------|
|
||||
| `http://localhost/test/subdir/file.html` | Показывается content из show.html (в родительском каталоге) |
|
||||
| URL остается `/test/subdir/file.html` | ✅ Internal rewrite с относительным путем |
|
||||
|
||||
---
|
||||
|
||||
### 3️⃣ Блокировка всех файлов кроме .html в subdir
|
||||
|
||||
**Правило:**
|
||||
```apache
|
||||
RewriteCond %{REQUEST_FILENAME} !-ext=html
|
||||
RewriteRule ^ - [F,L]
|
||||
```
|
||||
|
||||
**Ожидаемое поведение:**
|
||||
| Запрос | Результат |
|
||||
|--------|-----------|
|
||||
| `http://localhost/test/subdir/file.txt` | 403 Forbidden |
|
||||
| Только .html файлы доступны | ✅ Фильтрация по расширению |
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Тестирование функционала mod_rewrite
|
||||
|
||||
### Поддерживаемые флаги:
|
||||
|
||||
| Флаг | Значение | Описание |
|
||||
|------|----------|----------|
|
||||
| `L` | Last | Остановить обработку остальных правил в .htaccess |
|
||||
| `F` | Forbidden | Возвращать ошибку 403 Forbidden |
|
||||
| `R=301` | Redirect | Внешнее перенаправление с кодом HTTP 301 Moved Permanently |
|
||||
| `END` | End | Остановить ВСЮ обработку rewrite (включая nginx config rules) |
|
||||
|
||||
### Поддерживаемые директивы:
|
||||
|
||||
| Директива | Описание |
|
||||
|-----------|----------|
|
||||
| `RewriteEngine on/off` | Включение/выключение mod_rewrite для .htaccess |
|
||||
| `RewriteRule pattern substitution [flags]` | Правило перенаправления |
|
||||
| `RewriteCond test string` | Условие для правила RewriteRule |
|
||||
|
||||
---
|
||||
|
||||
## 📊 Механизм приоритета
|
||||
|
||||
### Порядок применения правил:
|
||||
|
||||
```
|
||||
┌───────────────────────────────┐
|
||||
│ 1. Правила из .htaccess │ ← Higher Priority
|
||||
│ ├─ Read & parse │
|
||||
│ ├─ Convert to mod_rewrite │
|
||||
│ └─ Apply rules │
|
||||
│ │
|
||||
├───────────────────────────────┤
|
||||
│ Check END flag │
|
||||
│ if (ctx->end) STOP ALL │ ← Blocks nginx config!
|
||||
├───────────────────────────────┤
|
||||
│ 2. Правила из nginx config │ ← Lower Priority
|
||||
│ └─ Apply from server/loc │
|
||||
└───────────────────────────────┘
|
||||
```
|
||||
|
||||
**Ключевой момент:**
|
||||
- При наличии флага `[END]` в .htaccess, обработка ВСЕХ правил rewrite останавливается
|
||||
- Это позволяет полностью блокировать nginx config rules при необходимости
|
||||
|
||||
---
|
||||
|
||||
## 🧪 Примеры CURL запросов для тестирования
|
||||
|
||||
```bash
|
||||
# 1. Перенаправление .xmx на index.html (301)
|
||||
curl -I http://localhost/test/test.xmx
|
||||
# Ожидаемый: HTTP/1.1 301 Moved Permanently
|
||||
# Location: /test/index.html
|
||||
|
||||
# 2. Блокировка stop.html (403)
|
||||
curl -I http://localhost/test/stop.html
|
||||
# Ожидаемый: HTTP/1.1 403 Forbidden
|
||||
|
||||
# 3. Internal rewrite redirect.html → show.html (200 OK, content из show.html)
|
||||
curl -s http://localhost/test/redirect.html | grep h1
|
||||
# Ожидаемый: <h1>show.html</h1>
|
||||
|
||||
# 4. Internal rewrite subdir → index.html (200 OK)
|
||||
curl -I http://localhost/test/subdir/
|
||||
# Ожидаемый: HTTP/1.1 200 OK
|
||||
|
||||
# 5. Блокировка other.xmx в subdir (403)
|
||||
curl -I http://localhost/test/subdir/other.xmx
|
||||
# Ожидаемый: HTTP/1.1 403 Forbidden
|
||||
|
||||
# 6. Internal rewrite subdir/file.html → ../show.html (200 OK)
|
||||
curl -s http://localhost/test/subdir/file.html | grep h1
|
||||
# Ожидаемый: <h1>show.html</h1>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📝 Установка и запуск тестов
|
||||
|
||||
### Конфигурация nginx для запуска тестов:
|
||||
|
||||
```nginx
|
||||
server {
|
||||
listen 80;
|
||||
server_name localhost;
|
||||
|
||||
# Корневой сайт
|
||||
location / {
|
||||
root /workspaces/test1/nginx-1.25.3/html;
|
||||
}
|
||||
|
||||
# Тестовый каталог с .htaccess поддержкой
|
||||
location /test {
|
||||
alias /workspaces/test1/test/;
|
||||
|
||||
HtAccess on; # Включить чтение .htaccess файлов
|
||||
HtAccessFile .htaccess; # Файл конфигурации
|
||||
|
||||
# Для подкаталога subdir (авто-поиск .htaccess)
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Команды запуска:
|
||||
|
||||
```bash
|
||||
# 1. Скомпилировать nginx с модулем mod_rewrite
|
||||
cd /workspaces/test1/nginx-1.25.3 && make modules
|
||||
|
||||
# 2. Запустить nginx
|
||||
./nginx -c /path/to/nginx.conf
|
||||
|
||||
# 3. Тестировать правила через curl или браузер
|
||||
curl http://localhost/test/redirect.html
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ Итог
|
||||
|
||||
Модуль `ngx_http_apache_rewrite_module` обеспечивает:
|
||||
|
||||
1. ✅ **Чтение .htaccess файлов** при каждом запросе с проверкой mtime
|
||||
2. ✅ **Кэширование директив** в памяти на время жизненного цикла запроса
|
||||
3. ✅ **Конвертацию Apache mod_rewrite правил** в формат nginx mod_rewrite
|
||||
4. ✅ **Приоритет .htaccess выше nginx config rules**
|
||||
5. ✅ **Флаг [END] для полной остановки обработки rewrite**
|
||||
6. ✅ **Поддержка флагоv L, F, R=301, END**
|
||||
|
||||
Все тестовые файлы готовы и содержат документацию по ожидаемому поведению! 🎉
|
||||
Reference in New Issue
Block a user