From: Rich Bowen <rbowen@apache.org>
Date: Sun, 3 May 2026 17:26:24 +0000 (+0000)
Subject: mod_filter: Document AddOutputFilterByType limitation with user-defined filters ... 
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=16201b4697cda424135c5cb970ad59a86529299b;p=thirdparty%2Fapache%2Fhttpd.git

mod_filter: Document AddOutputFilterByType limitation with user-defined filters (Bug 65463)

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1933776 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/mod/mod_filter.xml b/docs/manual/mod/mod_filter.xml
index d41680d729..5aaae27c9f 100644
--- a/docs/manual/mod/mod_filter.xml
+++ b/docs/manual/mod/mod_filter.xml
@@ -314,6 +314,19 @@ AddOutputFilterByType DEFLATE text/html text/plain
 &lt;/VirtualHost&gt;
     </highlight>
 
+    <note type="warning"><title>Limitation with user-defined filters</title>
+    <p><directive>AddOutputFilterByType</directive> works with standard
+        compiled-in filters such as <code>DEFLATE</code> and
+        <code>INCLUDES</code>, but does not work with filters that look
+        up their configuration by filter name, such as those defined by
+        <module>mod_ext_filter</module> or <module>mod_lua</module>'s
+        <code>LuaOutputFilter</code>. This is because internally the
+        filter name is modified with a <code>BYTYPE:</code> prefix.
+        For user-defined filters, use
+        <directive>FilterDeclare</directive> and
+        <directive>FilterProvider</directive> with an expression
+        matching on <code>%{CONTENT_TYPE}</code> instead.</p></note>
+
 </usage>
 
 <seealso><directive module="mod_mime">AddOutputFilter</directive></seealso>