Document the affected running phases of configuration directive?

[Maxim Dounin]

Hello!

On Thu, Dec 11, 2014 at 03:26:57PM +0200, Gena Makhomed wrote:

> On 11.12.2014 15:07, Валентин Бартенев wrote:
> 
> >>Есть лимиты на коннекты с 1 айпи, но когда вторая нода переводит весь
> >>свой трафик на первую (сбой ее апача) -- ловим этот лимит. Есть идея
> >>использовать realip, но непонятно, кто сработает раньше - лимит или модуль.
> >
> >realip сработает раньше.
> >
> 
> Почему порядок работы фаз не описан в документации? Это было бы полезно.

Нет, это не было бы полезно.  Realip меняет адрес клиента, и 
делает это сразу после того, как прочитан заголовок запроса - и до 
того, как начинается какая-либо обработка запроса.  А в какой фазе 
это происходит - совершенно не важно с точки зрения использования 
realip.

> "Implementation detail" - это означает "implementation-defined behavior"
> или "unspecified behavior" и может произвольно меняться
> от версии к версии?

Implementation detail означает именно implementation detail.  Не 
следует путать особенности реализации и поведение.

> Это примерно то же самое, что и писать арифметические выражения,
> при этом не зная какой приоритет у операторов + - / * % ^ | &
> потому что это "implementation detail" используемых компиляторов.

Порядок, там где он важен, задан и документирован (а если вдруг 
нет - то patches are welcome).  А вот то, с помощью каких 
внутренних механизмов реализован этот порядок - совершенно точно 
не важно, и в пользовательской документации этому не место.

-- 
Maxim Dounin
http://nginx.org/