Apache VirtualHost中AddOutputFilterByType等指令覆盖原有配置问题

编辑说明：该问题已上报至官方Docker PHP镜像仓库对应反馈渠道。

问题背景 #

当前使用官方Docker PHP Apache镜像php:8.1.8-apache-bullseye，镜像内搭载Debian系统适配的Apache 2.4.48版本。
最初编写的基础VirtualHost配置如下：

<VirtualHost *:80>
    DocumentRoot /srv/app/docroot
    AddDefaultCharset utf-8

    <Directory "/srv/app/docroot">
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

通过如下Dockerfile完成配置启用：

FROM php:8.1.8-apache-bullseye

COPY . /srv/app

COPY .docker/vhost.conf /etc/apache2/sites-available/000-default.conf

WORKDIR /srv/app

初始配置运行正常，但Debian提供的Apache默认配置无法满足现代网站需求：默认不会对SVG文件执行gzip压缩，也未配置AVIF图片对应的image/avif MIME类型。

尝试在VirtualHost中追加如下配置补充上述能力，单独测试时配置可正常生效：

<VirtualHost *:80>
    ...
    <IfModule mod_deflate.c>
        <IfModule mod_filter.c>
            AddOutputFilterByType DEFLATE image/svg+xml
        </IfModule>
    </IfModule>

    <IfModule mod_mime.c>
        AddType image/avif avif
    </IfModule>
</VirtualHost>

但将上述配置加入vhost.conf后，Debian原有的标准配置出现失效：CSS、JavaScript文件不再启用gzip压缩，webp图片对应的MIME类型也未正常加载。

核心疑问：在VirtualHost配置块中添加相关指令时，为何会覆盖全局已预先设置的指令？

实测验证结果 #

• 手动在VirtualHost中重复写入所有原有已配置的压缩规则，可以解决该问题，配置可正常运行，示例配置如下：

<IfModule mod_deflate.c>
    <IfModule mod_filter.c>
        AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript
        AddOutputFilterByType DEFLATE application/x-javascript application/javascript application/ecmascript
        AddOutputFilterByType DEFLATE application/rss+xml
        AddOutputFilterByType DEFLATE application/wasm
        AddOutputFilterByType DEFLATE application/xml

        AddOutputFilterByType DEFLATE image/svg+xml
    </IfModule>
</IfModule>

• 将AddType指令写在<IfModule mod_mime.c>条件块外部时可正常工作，仅会新增指定MIME类型，不会替换原有其他类型配置：

AddType image/avif avif 

更新说明：最新版本的Docker镜像中已无法复现该问题，但此前的镜像版本确实存在该异常现象。

原因说明 #

该现象是两方面逻辑共同导致的：

1. AddOutputFilterByType指令的作用域规则：该指令不属于可跨作用域自动继承的类型，当你在VirtualHost作用域内第一次写入该指令时，会重置当前VirtualHost下的所有输出过滤器规则，不会自动拉取全局（服务器级）配置里预设的同指令规则。Debian默认的mod_deflate压缩规则写在全局conf-enabled目录的配置文件中，属于服务器级配置，在VirtualHost内新增该指令后，原有全局压缩规则在当前VirtualHost下就不再生效，仅会应用你新写入的规则，这也是手动补全所有原有规则后功能恢复正常的原因。
2. 旧版镜像的模块加载顺序bug：你遇到的<IfModule mod_mime.c>块内AddType配置连带导致webp等MIME类型失效的问题，是当时镜像内Apache模块加载顺序存在问题：mod_mime的加载时机晚于站点配置文件的解析时机，写在<IfModule mod_mime.c>块内的配置在解析时因为模块尚未加载，整个代码块会被直接跳过，不仅你新加的AVIF类型不生效，连带全局配置中写在同类型条件块内的webp等MIME规则也未被正确合并到当前VirtualHost作用域。把AddType写到IfModule块外时，指令不会被条件判断跳过，等mod_mime加载完成后就会正常生效，也不会影响其他已配置的MIME类型。

新版镜像修复了模块加载顺序和配置合并的相关问题，因此无法复现该异常。

内容的提问来源于stack exchange，提问作者Pere