如何在 XAMPP 中开启 Apache 的 mod_deflate 模块优化资源加载

雨芳小哥_2256

雨芳小哥_2256

2026-05-10

551人浏览

原创

必须先启用mod_deflate、mod_filter和mod_headers三模块,否则所有gzip配置均无效;需取消httpd.conf中对应loadmodule行的注释并重启apache,规则须写入httpd.conf末尾而非.htaccess,且按实际content-type精准匹配mime类型。

如何在 xampp 中开启 apache 的 mod_deflate 模块优化资源加载

不启用 mod_deflate 模块,后续所有 Gzip 配置都无效——这是 XAMPP 用户开启压缩失败的首要原因,不是规则写错,而是模块根本没加载。

必须先取消三行注释:deflate、filter、headers

XAMPP 默认只编译了模块,但全部被注释掉。光开 deflate_module 不够,filter_module 和 headers_module 是隐性依赖:前者让压缩能介入响应流,后者用于加 Vary: Accept-Encoding 头(否则 CDN 或代理可能缓存错版本)。

  • 打开 C:\xampp\apache\conf\httpd.conf(Windows)或 /Applications/XAMPP/xamppfiles/etc/httpd.conf(macOS)
  • 搜索 mod_deflate.so,删掉这行开头的 #:LoadModule deflate_module modules/mod_deflate.so
  • 同样处理这两行:LoadModule filter_module modules/mod_filter.so、LoadModule headers_module modules/mod_headers.so
  • 保存后,必须通过 XAMPP Control Panel 点 Stop → Start(仅刷新页面或重载配置不生效)

AddOutputFilterByType DEFLATE 的 MIME 类型要精准匹配响应头

压缩按实际返回的 Content-Type 触发,不是按文件后缀。比如一个 .js 文件如果由 PHP 动态输出且没设 header,它可能返回 text/plain,而你的规则只写了 application/javascript,那它就不会被压。

Apache Superset Dashboard and SQL Exploration Skill
Apache Superset Dashboard and SQL Exploration Skill

Apache Superset 是一个广泛采用的开源 BI 平台,用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时,此技能非常有用。

下载
  • 推荐配置(覆盖主流文本资源):AddOutputFilterByType DEFLATE text/html text/plain text/css application/javascript application/json application/xml
  • 别写 AddOutputFilterByType DEFLATE * —— Apache 不支持通配符,会直接报错 Invalid command
  • 现代 JS 应用 application/javascript,而非过时的 text/javascript;漏配就等于没压 JS
  • 不要加 application/x-httpd-php —— PHP 层若开了 zlib.output_compression = On(见 php.ini),会导致头冲突,Apache 会跳过压缩

规则必须写在 httpd.conf 末尾,别碰 .htaccess

XAMPP 默认设置 AllowOverride None,意味着 .htaccess 文件里的任何 AddOutputFilterByType 都不会被读取。写在那里等于白写,还会让人误以为“配置对但没效果”。

  • 把整个 <ifmodule mod_deflate.c>...</ifmodule> 块追加到 httpd.conf 文件最底部
  • 如果配了多端口(如 <virtualhost></virtualhost>),规则仍要放全局主配置里,不能塞进某个 <virtualhost></virtualhost> 内部——否则 Apache 会报 Invalid command 'AddOutputFilterByType'
  • 可选加一行:Header append Vary Accept-Encoding(需包在 <ifmodule mod_headers.c></ifmodule> 里),避免代理缓存歧义

验证是否生效:看响应头和传输体积,不是看配置文件

浏览器 Network 面板里 Content-Encoding: gzip 没出现?大概率是以下某一点卡住了:

  • Apache 没真正重启:Control Panel 显示 “Running” 不代表新配置已加载,必须 Stop 再 Start
  • PHP 提前输出了编码头:检查 php.ini 中 zlib.output_compression = Off
  • 浏览器缓存了旧响应:强制刷新(Ctrl+F5)或清空缓存,再对比 Size 列(如从 12KB → 3KB 才算成功)
  • MIME 类型不匹配:用 curl 测真实响应头:curl -I http://localhost/test.js,确认 Content-Type 是你规则里写的那个

最容易被忽略的是:你以为改了配置就完事了,其实 Apache 还在跑老进程;或者你盯着 .htaccess 死磕,却忘了 XAMPP 根本不读它。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

xampp apache

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
XAMPP用法详解
XAMPP用法详解

本专题整合了XAMPP相关用法介绍,阅读专题下面的文章了解更多详细内容。

2026.04.08

253

20

XAMPP 安装与快速入门指南
XAMPP 安装与快速入门指南

面向零基础用户,详细介绍 XAMPP 在 Windows、macOS、Linux 三大平台上的下载、安装步骤、首次启动配置、控制面板使用以及 Apache/MySQL 服务的基本启停操作,帮助初学者在最短时间内搭建起可用的本地开发环境。

2026.04.08

230

23

XAMPP Apache 与 MySQL 核心配置实战
XAMPP Apache 与 MySQL 核心配置实战

深入讲解 XAMPP 中 Apache 和 MySQL 的核心配置技巧,包括 httpd.conf 端口修改、虚拟主机(VirtualHost)多站点配置、MySQL 用户权限管理与远程连接设置、php.ini 关键参数调优,以及 SSL 证书的本地配置方法,适合有一定基础的开发者进阶使用。

2026.04.08

465

21

XAMPP 本地项目部署与调试全流程
XAMPP 本地项目部署与调试全流程

以 WordPress、Laravel、ThinkPHP 等主流 PHP 框架和 CMS 为例,演示如何在 XAMPP 环境中完成项目部署、本地域名绑定(hosts配置)、数据库导入、伪静态规则配置以及 Xdebug 断点调试的完整流程,让本地开发与线上环境无缝衔接。

2026.04.08

122

21

XAMPP 常见问题排查与故障解决
XAMPP 常见问题排查与故障解决

汇总 XAMPP 使用过程中最常遇到的故障场景及其解决方案,涵盖 80/443 端口被占用、Apache 或 MySQL 无法启动、phpMyAdmin 访问报错、文件权限不足、日志分析方法等问题,提供逐步排查思路与一键修复技巧,减少开发者的排错时间。

2026.04.08

370

22

XAMPP 安全加固与生产环境迁移
XAMPP 安全加固与生产环境迁移

聚焦 XAMPP 的安全实践与环境迁移,包括修改 MySQL 默认 root 密码、关闭目录列表浏览、限制 phpMyAdmin 外部访问、配置防火墙规则等安全加固措施,同时讲解如何将 XAMPP 本地开发完成的项目平滑迁移部署到 Linux 生产服务器。

2026.04.08

284

30

XAMPP 与 phpMyAdmin 数据库管理实操
XAMPP 与 phpMyAdmin 数据库管理实操

专注于 XAMPP 内置的 phpMyAdmin 数据库管理工具,系统讲解数据库和数据表的创建与设计、SQL 语句执行、CSV/SQL 格式数据的导入导出、定时备份与一键还原、多数据库批量管理等日常操作,帮助开发者高效管理本地 MySQL 数据。

2026.04.08

355

26

apache是什么意思
apache是什么意思

Apache是Apache HTTP Server的简称,是一个开源的Web服务器软件。是目前全球使用最广泛的Web服务器软件之一,由Apache软件基金会开发和维护,Apache具有稳定、安全和高性能的特点,得益于其成熟的开发和广泛的应用实践,被广泛用于托管网站、搭建Web应用程序、构建Web服务和代理等场景。本专题为大家提供了Apache相关的各种文章、以及下载和课程,希望对各位有所帮助。

2023.08.23

1155

4

apache启动失败
apache启动失败

Apache启动失败可能有多种原因。需要检查日志文件、检查配置文件等等。想了解更多apache启动的相关内容,可以阅读本专题下面的文章。

2024.01.16

13073

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程