如何在XAMPP中开启mod_rewrite模块实现伪静态URL

在XAMPP集成的Apache环境中，mod_rewrite模块是实现伪静态URL的核心组件，默认情况下该模块可能处于未开启状态，需要手动配置才能使用。伪静态URL可以将动态页面的参数形式转换为更简洁的静态路径样式，既方便用户记忆，也有利于搜索引擎抓取。

Windows系统下开启mod_rewrite模块

Windows系统的XAMPP配置步骤相对简单，主要分为修改配置文件和重启服务两步。

修改Apache配置文件

首先找到XAMPP的安装目录，默认路径一般为C:xamppapacheconf，打开该目录下的httpd.conf文件，使用文本编辑器搜索mod_rewrite相关内容。

找到如下配置行：

#LoadModule rewrite_module modules/mod_rewrite.so

将该行前面的#注释符号删除，修改后内容为：

LoadModule rewrite_module modules/mod_rewrite.so

接着继续在httpd.conf文件中搜索Directory配置段，找到网站根目录对应的配置，默认根目录为C:/xampp/htdocs，将对应配置段中的AllowOverride None修改为AllowOverride All，修改后的配置示例如下：

<Directory "C:/xampp/htdocs">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

重启Apache服务

修改完成后保存httpd.conf文件，打开XAMPP控制面板，点击Apache对应的Stop按钮停止服务，再点击Start按钮重新启动服务，此时mod_rewrite模块就已经成功开启。

Linux系统下开启mod_rewrite模块

Linux系统的XAMPP配置流程和Windows略有不同，主要通过终端命令操作。

启用模块与修改配置

打开终端，切换到XAMPP的Apache配置目录，执行如下命令启用mod_rewrite模块：

sudo /opt/lampp/bin/a2enmod rewrite

如果提示模块不存在，需要先确认XAMPP安装路径是否正确，默认Linux下XAMPP安装路径为/opt/lampp。

启用模块后，同样需要修改Apache的配置文件，打开/opt/lampp/etc/httpd.conf文件，按照Windows系统的配置方式，将AllowOverride None修改为AllowOverride All。

重启服务

配置修改完成后，执行如下命令重启XAMPP的Apache服务：

sudo /opt/lampp/lampp restartapache

验证模块是否开启

可以通过创建测试文件的方式验证mod_rewrite模块是否正常工作。

在XAMPP的网站根目录（Windows为C:xampphtdocs，Linux为/opt/lampp/htdocs）下创建phpinfo.php文件，内容如下：

<?php
phpinfo();
?>

在浏览器中访问http://127.0.0.1/phpinfo.php，搜索mod_rewrite，如果能找到对应的模块信息，说明模块已经成功开启。

配置伪静态规则示例

模块开启后，就可以在网站根目录创建.htaccess文件来配置伪静态规则，以下是一个简单的规则示例，将article.php?id=1形式的URL转换为article/1.html：

RewriteEngine On
# 将article/数字.html的请求重写到article.php?id=数字
RewriteRule ^article/([0-9]+).html$ article.php?id=$1 [L]

保存.htaccess文件后，访问http://127.0.0.1/article/1.html，如果能正常显示article.php?id=1对应的内容，说明伪静态规则配置生效。

常见问题排查

• 如果修改配置后重启服务失败，检查httpd.conf文件是否有语法错误，可以通过XAMPP控制面板的Apache日志查看报错信息。
• 如果.htaccess规则不生效，确认AllowOverride是否已经设置为All，同时检查规则的正则表达式是否正确。
• 部分系统下.htaccess文件可能被隐藏，需要在文件管理器中开启显示隐藏文件的选项才能编辑。

XAMPPmod_rewrite伪静态_URLApache修改时间：2026-07-23 20:21:31