From 49e9f0acdcd68bb9b7e4b30b41a95cb5b8c8b811 Mon Sep 17 00:00:00 2001
From: Glenn Strauss <gstrauss@gluelogic.com>
Date: Sat, 4 May 2019 17:10:35 -0400
Subject: [doc] highlight relevance of module load order (fixes #2946)

x-ref:
  "modules.conf order unhelpful (setenv vs. redirect)"
  https://redmine.lighttpd.net/issues/2946
---
 doc/config/modules.conf | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

(limited to 'doc')

diff --git a/doc/config/modules.conf b/doc/config/modules.conf
index fa9d6644..1e0d83f5 100644
--- a/doc/config/modules.conf
+++ b/doc/config/modules.conf
@@ -17,8 +17,6 @@
 ##
 ## Modules, which are pulled in via conf.d/*.conf
 ##
-## NOTE: the order of modules is important.
-##
 ## - mod_accesslog     -> conf.d/access_log.conf
 ## - mod_compress      -> conf.d/compress.conf
 ## - mod_status        -> conf.d/status.conf
@@ -38,6 +36,14 @@
 ## - mod_secdownload   -> conf.d/secdownload.conf
 ## - mod_expire        -> conf.d/expire.conf
 ##
+## NOTE: The order of modules in server.modules is important.
+##
+## Modules which gate requests (e.g. mod_access, mod_auth) or modify
+## requests (e.g. mod_alias, mod_setenv) should be listed before
+## modules which complete requests (e.g. mod_redirect, mod_rewrite),
+## and which, in turn, should be listed before dynamic handlers
+## (e.g. mod_cgi, mod_fastcgi, mod_proxy, mod_scgi, ...)
+##
 
 server.modules = (
   "mod_access",
@@ -45,10 +51,10 @@ server.modules = (
 #  "mod_auth",
 #  "mod_authn_file",
 #  "mod_evasive",
-#  "mod_redirect",
-#  "mod_rewrite",
 #  "mod_setenv",
 #  "mod_usertrack",
+#  "mod_redirect",
+#  "mod_rewrite",
 )
 
 ##
-- 
cgit v1.2.1