]> git.kaiwu.me - haproxy.git/commit
DOC: filters: document the automatic ordering of the legacy core filters
authorChristopher Faulet <cfaulet@haproxy.com>
Mon, 19 Oct 2026 12:57:53 +0000 (14:57 +0200)
committerChristopher Faulet <cfaulet@haproxy.com>
Tue, 20 Oct 2026 09:13:30 +0000 (11:13 +0200)
commit618083953bdd160526018a41d1edd5ad0834fb5b
tree463d0fe5e3b00b093c1e9f4779c105b2e0542cd7
parentf9ecf6a93f18d5c21b250ea6f94110b298428321
DOC: filters: document the automatic ordering of the legacy core filters

The default evaluation orders of the filters are now documented in the
configuration manual, next to the "filter-config" documentation, for both
filter modes: the default placement of the built-in classes in the new
mode, and the automatic placement of the implicitly declared core filters
in the legacy mode, as introduced by the automatic ordering. For each
mode, the three orders are given: the global one, used for the
side-independent operations, and the request and response ones, used for
the evaluation order of the filters on the corresponding channel.

The "decompression" directives no longer recommend declaring the
decompression filters explicitly to prevent misconfigurations: when
implicitly enabled in the legacy filter mode, the decompression filter is
automatically placed at the beginning of the filter list, before the
cache and compression filters.

Both modes' orders are explicitly informational only: they describe the
current placement and they may be changed by the build options or by a
future version. Only the placements explicitly requested by a filter, and
the position of an implicitly declared legacy filter relative to the
explicitly declared ones, should be relied upon.

The filter API internals documentation explains the structural part of
the automatic ordering in legacy mode (the filter config links and the
proxy lists holding the three orders, the segment boundaries of the
explicitly declared filters) and refers to the configuration manual for
the resulting orders, as it already does for the class orders of the new
mode.
doc/configuration.txt
doc/internals/api/filters.txt