XAMPP作为常用的集成开发环境,内置的Apache服务支持通过加载不同模块扩展功能,所有模块的加载配置都集中在httpd.conf文件中,修改该文件就能完成模块的启用或禁用操作。

XAMPP中httpd.conf文件的位置
不同系统下XAMPP的安装路径不同,httpd.conf的位置也有区别,常见的路径如下:
- Windows系统:XAMPP安装目录下的apacheconfhttpd.conf,比如默认安装路径为C:xamppapacheconfhttpd.conf
- macOS系统:通过官方安装包安装的XAMPP,路径为/Applications/XAMPP/xamppfiles/apache/conf/httpd.conf
- Linux系统:如果是通过包管理器安装的XAMPP,路径通常为/opt/lampp/apache2/conf/httpd.conf
httpd.conf中加载模块的语法规则
Apache加载模块的核心指令是LoadModule,语法格式为:
LoadModule 模块名称 模块文件路径
其中模块名称是Apache预定义的固定标识,模块文件路径是对应模块文件在XAMPP中的绝对路径,Windows系统路径使用反斜杠,Linux和macOS使用正斜杠。
启用Apache模块的具体步骤
1. 打开httpd.conf文件
用记事本或者任意代码编辑器打开前面找到的httpd.conf文件,建议先备份原文件,避免修改出错后无法恢复。
2. 查找目标模块配置项
在文件中搜索LoadModule关键字,就能看到所有已加载和未加载的模块配置,未加载的模块通常前面有#注释符号。比如要启用URL重写模块mod_rewrite,找到对应的配置行:
#LoadModule rewrite_module modules/mod_rewrite.so
3. 取消注释启用模块
去掉配置行前面的#符号,保存文件即可启用该模块。如果是启用其他模块,比如mod_ssl模块,找到对应行取消注释:
#LoadModule ssl_module modules/mod_ssl.so
取消注释后变为:
LoadModule ssl_module modules/mod_ssl.so
4. 重启Apache服务
修改完httpd.conf后,必须重启XAMPP中的Apache服务才能让配置生效。在XAMPP控制面板中,先点击Apache对应的Stop按钮,再点击Start按钮即可完成重启。
验证模块是否成功加载
可以通过两种方式验证模块是否生效:
- 查看XAMPP控制面板的Apache日志,如果没有报错信息,说明模块加载成功
- 创建PHP测试文件,输出
phpinfo()函数的结果,在页面中搜索模块名称,能找到对应模块信息说明加载成功
测试文件代码如下:
<?php phpinfo(); ?>
常见加载错误及解决方法
| 错误类型 | 原因 | 解决方法 |
|---|---|---|
| Apache启动失败,提示模块文件不存在 | 模块文件路径错误,或者模块文件被删除 | 检查LoadModule后面的路径是否正确,确认对应so文件存在于指定目录 |
| 提示模块名称重复加载 | httpd.conf中存在多个相同模块的LoadModule指令 | 注释掉多余的重复配置项,只保留一个生效的配置 |
| 模块加载后功能不生效 | 模块依赖的其他模块未启用 | 查看模块官方文档,启用该模块依赖的所有前置模块 |
注意事项
- 不要随意删除httpd.conf中原有的LoadModule配置,避免破坏Apache基础功能
- 如果启用的模块需要额外配置,还需要在httpd.conf中添加对应的配置段,比如mod_rewrite需要设置AllowOverride规则
- 修改配置前一定要备份原文件,出现问题时可以快速回滚
XAMPPApachehttpd_conf加载模块配置修改时间:2026-07-08 21:12:26