ngx_http_apache_rewrite_module/cms/simple/SUMMARY.md

Тесты 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

Правило:

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)

Правила:

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

Правило:

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

Правило:

RewriteRule ^subdir/?$ /index.html [L]

Ожидаемое поведение:

Запрос	Результат
http://localhost/test/subdir/	Показывается content из index.html
URL в браузере остается /test/subdir/	✅ Internal rewrite

---

5️⃣ Дополнительные проверки (из main .htaccess)

Правило:

RewriteCond %{REQUEST_FILENAME} !test\.xmx$
RewriteRule \.xmx$ - [F,L]

Ожидаемое поведение:

• Блокирует все .xmx файлы кроме test.xmx
• НО: Работает ПОСЛЕ правила 1, поэтому test.xmx сначала редиректится на index.html

---

6️⃣ Перенаделение subdir с последующей блокировкой (конфликт)

Порядок в .htaccess:

# Сначала перенаправление
RewriteRule ^subdir/?$ /index.html [L]

# Затем блокировка
RewriteRule ^subdir/?$ - [F,L]

Ожидаемое поведение:

• subdir сначала переадресуется на index.html (правило 4)
• Затем применяется правило блокировки → 403 Forbidden
• Итог: subdir заблокирован с ошибкой 403

---

📁 Правила в подкаталоге subdir/.htaccess

1️⃣ Блокировка всех .xmx файлов в subdir (кроме test.xmx)

Правило:

RewriteRule \.xmx$ - [F,L]

Ожидаемое поведение:

Запрос	Результат
http://localhost/test/subdir/other.xmx	403 Forbidden
Файл заблокирован	✅

---

2️⃣ Внутреннее перенаправление subdir/file.html на ../show.html

Правило:

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

Правило:

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 запросов для тестирования

# 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 для запуска тестов:

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)
    }
}

Команды запуска:

# 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

Все тестовые файлы готовы и содержат документацию по ожидаемому поведению! 🎉