XAMPP环境部署ThinkPHP5项目 XAMPP去除index.php后缀

XAMPP环境部署ThinkPHP5项目：彻底解决.htaccess不生效问题

在XAMPP环境下部署ThinkPHP5，绝大多数人遇到的第一个拦路虎，就是.htaccess文件完全不起作用。问题根源其实很明确，但新手往往会在代码层面反复折腾，忽略了服务器配置这个基础环节。

XAMPP中ThinkPHP5的.htaccess不生效的根本原因是mod_rewrite未启用且AllowOverride为None；需在httpd.conf中取消LoadModule rewrite_module注释、将对应Directory的AllowOverride设为All，并重启Apache。

为什么 ThinkPHP5 的 .htaccess 在 XAMPP 里不生效

首先得明确一点：ThinkPHP5官方提供的.htaccess规则本身是标准且正确的。问题不出在规则上，而在于Apache服务器是否“愿意”去读取和执行它。要让Apache听话，必须同时满足两个前置条件，缺一不可：

• 模块未启用：默认情况下，XAMPP的mod_rewrite模块是关闭的。这意味着，即便你写了再完美的重写规则，Apache也根本不认识RewriteEngine这些指令。
• 权限被禁止：Apache的AllowOverride指令如果被设置为None，它会直接忽略项目目录下的.htaccess文件，导致文件形同虚设。
• 还有一个常见的配置错位：有些开发者修改了DocumentRoot（网站根目录），却忘了同步更新对应配置块里的路径，导致配置无法应用到正确的目录上。

必须改的两个 httpd.conf 配置项

解决方案的核心，就在于修改Apache的主配置文件——httpd.conf。通常它位于C:\xampp\apache\conf\目录下。请用文本编辑器（如Notepad++）打开它，并找到以下两处关键配置：

• 启用重写模块：在文件中搜索“LoadModule rewrite_module”。你会找到一行前面带有#号的注释。直接删除这个#号，确保该行显示为：LoadModule rewrite_module modules/mod_rewrite.so。
• 允许覆盖配置：接下来，搜索你的项目目录路径，例如“”。在这个配置块内部，找到AllowOverride None这一行，将其修改为AllowOverride All。这步操作是授权Apache读取该目录下的.htaccess文件。
• 如果你的项目没有放在默认的htdocs里，而是放在了其他路径（比如D:\myapp），那么你需要找到或添加对应的配置块，并同样进行AllowOverride All的设置。

完成上述修改并保存文件后，切记一定要重启Apache服务。仅仅刷新浏览器页面是无效的，必须通过XAMPP控制面板或系统服务彻底重启Apache，才能使配置生效。

立即学习“PHP免费学习笔记（深入）”；

ThinkPHP5 的 .htaccess 写法与常见陷阱

服务器配置搞定后，.htaccess文件的内容就至关重要了。将以下标准规则保存到你的项目根目录（即与public文件夹同级的目录）下，并命名为.htaccess：

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]

这里有几个极易出错的细节，需要特别警惕：

• 避免使用简化规则：网上有些教程会使用RewriteRule ^(.*)$ index.php [L]这样的规则。这个规则会丢失PATH_INFO信息，直接导致ThinkPHP5的路由系统无法正确解析URL。
• 斜杠是关键：规则中index.php/$1里的那个斜杠/不是多余的，它是ThinkPHP在PATH_INFO模式下识别参数的关键分隔符。如果误写成index.php?$1或其他形式，路由就会失效。
• 文件位置要对：根据ThinkPHP5的官方目录结构，.htaccess文件应该放置在public目录下，而这个public目录就是你的网站Web访问入口。

还要检查 ThinkPHP5 自身配置

服务器和重写规则都正确后，最后一道关卡就是ThinkPHP5应用本身的配置了。请检查application目录下的config.php配置文件（或根据版本查看对应位置），确保以下几个关键项设置无误：

• 'url_route_on' => true：确保路由功能已经开启。
• 'url_html_suffix' => ''：最好将URL后缀设为空，避免.html等后缀对路由解析造成干扰。
• 'url_common_param' => false：关闭普通URL模式，强制系统使用PATH_INFO模式来解析参数，这与.htaccess的规则是配套的。
• 如果你是从其他环境（如Nginx）迁移过来的，注意检查'url_convert' => true（是否自动转换URL中的大小写）这个配置项是否被意外关闭。

最后，分享一个高效排错的方法：养成查看日志的习惯。打开XAMPP的apache\logs\error.log文件。如果里面出现“Invalid command 'RewriteEngine'”的错误，那铁定是mod_rewrite模块没启用成功。如果看到“File does not exist: .../index.php/xxx”这类提示，则说明.htaccess文件根本没有被加载，此时你应该立刻回头去复查AllowOverride的配置，而不是继续在代码里打转。