如何设置XAMPP环境下的Laravel框架Rewrite规则？

本文共计850个文字，预计阅读时间需要4分钟。

EXAMPP默认不支持Laravel的URL重写，直接访问会出现404错误。基本原因是Apache没有正确读取`.htaccess`文件，或`mod_rewrite`模块未启用。

确认 mod_rewrite 模块已加载

打开 XAMPP\apache\conf\httpd.conf，搜索：LoadModule rewrite_module modules/mod_rewrite.so。如果这行开头有 #，删掉它；如果整行被注释或根本不存在，手动添加该行（确保放在其他 LoadModule 行附近）。Windows 下必须是 .so 后缀，不是 .dll。

改完后重启 Apache（通过 XAMPP 控制面板），再检查是否生效：

• 在 htdocs 下新建一个 .htaccess，内容只写 RewriteEngine On
• 访问任意 PHP 页面（如 localhost/test.php），若报 500 Internal Server Error，说明模块已加载且 .htaccess 被识别；若完全无反应或 404，说明模块未加载或配置未生效

AllowOverride 必须设为 All，否则 .htaccess 形同虚设

仍在 httpd.conf 中，搜索 <Directory "C:/xampp/htdocs">（路径按你实际安装位置调整，比如 D:/xampp/htdocs）。找到其中的 AllowOverride None，改成：AllowOverride All。

注意：不要改错位置 —— 常见错误是改了 <Directory /> 这个全局根目录块，但它对项目目录无效。必须定位到你放 Laravel 项目的那个 <Directory> 块。

改完保存，重启 Apache。验证方式仍是上面那个 RewriteEngine On 测试：报 500 才算成功。

Laravel 项目根目录的 .htaccess 规则要精简可靠

Laravel 官方自带的 .htaccess（位于 public/ 目录下）基本可用，但需确认两点：

• 第一行必须是：RewriteEngine On
• 关键规则应类似：RewriteRule ^(.*)$ index.php [L] 或更安全的 Laravel 9+ 推荐写法：RewriteRule ^ index.php [L]
• 如果项目不在 htdocs 根目录（例如放在 htdocs/myapp），必须加 RewriteBase /myapp/，否则所有重写都会 404
• 不要盲目复制网上“万能规则”，尤其避免带 RewriteCond %{REQUEST_FILENAME} !-f 等判断的冗余逻辑 —— Laravel 的入口统一走 index.php，这些条件反而容易因路径解析出错

浏览器看到 404 或 500？真因藏在 error.log 里

别猜。打开 XAMPP\apache\logs\error.log，用文本编辑器搜索关键词：rewrite、htaccess、Invalid command 'RewriteEngine'。

典型线索：

• Invalid command 'RewriteEngine' → mod_rewrite 没加载（回到第一步）
• Options not allowed here → AllowOverride All 没生效，或写在了错误的 <Directory> 块里
• File does not exist: C:/xampp/htdocs/index.php → RewriteBase 缺失或写错，导致重写路径错位

最易忽略的是：XAMPP 安装路径含空格或中文（如 C:\Program Files\xampp 或 D:\我的项目\xampp），会导致 Apache 启动失败或模块加载异常 —— 建议始终安装在纯英文无空格路径下，比如 C:\xampp。