Document the affected running phases of configuration directive?

Maxim Dounin mdounin at
Mon Dec 8 00:38:26 UTC 2014


On Fri, Dec 05, 2014 at 03:45:50PM -0800, Yichun Zhang (agentzh) wrote:

> Hello!
> It'll be great if the official nginx documentation documents the
> affected request running phase of each configuration directive. For
> example, proxy_pass affects the content phase while set_real_ip_from
> affects the post-read and pre-access phases. This can help a lot when
> the users try to combine directives of different modules and predict
> their relative running order. Right now we have to look into the nginx
> internals to be sure (either source code or debugging tools like gdb
> and systemtap).

Phases of processing is an implementation detail, and while 
understanding them sometimes helps to understand what goes on in 
some complex cases, it's not something to be exposed into the 

Maxim Dounin

More information about the nginx-devel mailing list