# Чистые URL (правила перезаписи)

Правила перезаписи не обязательны: API всегда доступен по «прямому» адресу `index.php?action=api;path=v1/members/5`. Правила лишь превращают его в короткий `/api/v1/members/5`. Ведущий сегмент `api` мод снимает сам, поэтому запрос уходит в `index.php?action=api` с путём в параметре `path`; остальные query-параметры (например, `?limit=25&offset=50`) при этом сохраняются.

## Apache (.htaccess в корне форума)

.htaccess

```apache
RewriteEngine On
# /api/v1/members/5  ->  index.php?action=api;path=v1/members/5
RewriteRule ^api/(.*)$ index.php?action=api;path=$1 [QSA,L]
```

Флаг `QSA` дописывает исходную строку запроса, поэтому фильтры и пагинация продолжают работать. Если форум установлен в подкаталоге, добавьте перед правилом `RewriteBase` — например, `RewriteBase /forum/`.

## Nginx

nginx.conf

```nginx
# /api/v1/members/5  ->  index.php?action=api;path=v1/members/5
location ^~ /api/ {
    rewrite ^/api/(.*)$ /index.php?action=api;path=$1 last;
}
```

Модификатор `^~` даёт этому блоку приоритет над общим `location ~ \.php$` (порядок описания при этом не важен), а сам `/index.php` затем обрабатывается штатным PHP-location форума. Nginx автоматически дописывает исходные query-параметры к цели `rewrite`.

> [!TIP]
>
> **Прямой адрес работает всегда**
>
> Правила перезаписи можно не настраивать и использовать `index.php?action=api;path=v1/members/5` (или `index.php?action=api&path=v1/members/5` в зависимости от стиля разделителя).

> [!WARNING]
>
> **Заголовок Authorization должен дойти до PHP**
>
> Некоторые серверные конфигурации срезают заголовок `Authorization` до того, как он дойдёт до PHP — так делает Apache с CGI, то же происходит за прокси. Мод читает срезанный заголовок и из `REDIRECT_HTTP_AUTHORIZATION`, поэтому обычно всё работает из коробки. Если аутентификация не проходит с верным ключом, пробросьте заголовок явно (для Apache: `CGIPassAuth On` или `SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1`).

Путь также читается из `PATH_INFO`, если параметр `path` отсутствует, поэтому сработает и правило перезаписи, которое только меняет URL, не передавая путь параметром.
