Are headers set in the server block inherited to all location blocks

Maxim Dounin mdounin at
Wed Feb 5 16:42:57 UTC 2014


On Wed, Feb 05, 2014 at 03:10:03PM +0000, Francis Daly wrote:

> On Wed, Feb 05, 2014 at 05:52:21PM +0400, Maxim Dounin wrote:
> > On Wed, Feb 05, 2014 at 01:33:34PM +0000, Francis Daly wrote:
> Hi there,
> > > Can you say where you got that impression? Perhaps documentation can be
> > > clarified or corrected.
> > 
> > It looks like add_header documentation doesn't have our usual 
> > clause for array-like directives, and something like this should 
> > be helpful:
> I'm not sure where the best place for it is; but I'd suggest not putting
> this on every directive, but only marking the few that don't follow the
> common inheritance rules.
> And then have an obvious document which describes what the common
> inheritance rules are.

Having some generic description of directive inheritance is 
certainly a plus (just in case, it likely should be in 
/syntax.xml, which currently only contains some basics about size 
and time units and needs to be actually written), but it's yet to 
find somebody who'll sign up for this work.

On the other hand, writing this information explicitly for 
array-like directives matches our current practice and seems to 
help a lot.  Especially keeping in mind that there are only a few 
array-like directives where inheritance is important, and most of 
them already have the clause in question.


Maxim Dounin

More information about the nginx mailing list