讲师中心 微信公众号
AI工具推荐 视频效率加速

XAMPP环境下配置ThinkPHP项目 XAMPP修改Apache重写规则

阿枫姑娘_3822

阿枫姑娘_3822

发布时间:2026-05-03 08:03:16

|

881人浏览过

|

来源于php中文网

原创

ThinkPHP在XAMPP下伪静态404的主因是mod_rewrite未启用或.htaccess被忽略:需取消httpd.conf中LoadModule rewrite_module注释、设AllowOverride All并覆盖项目目录、.htaccess置于项目根目录且用兼容规则,最后确保端口空闲并重启Apache。

xampp环境下配置thinkphp项目 xampp修改apache重写规则

ThinkPHP 项目在 XAMPP 下跑不起来伪静态(比如访问 /index/user/login 报 404),不是代码问题,大概率是 Apache 的 mod_rewrite 没真正启用,或 .htaccess 被忽略 —— 这两个环节必须同时满足,缺一不可。

确认 mod_rewrite 模块已加载且未被注释

很多人改了 httpd.conf 却没生效,第一关就卡在这儿。Apache 启动时不会报错提示模块加载失败,但 mod_rewrite 若未启用,所有重写规则都等于废纸。

  • 打开 XAMPP\apache\conf\httpd.conf(Windows)或 /opt/lampp/etc/httpd.conf(Linux)
  • 搜索 #LoadModule rewrite_module modules/mod_rewrite.so,确保这行前面的 # 已删除,变成 LoadModule rewrite_module modules/mod_rewrite.so
  • 保存后重启 Apache —— 不重启等于没改
  • 可访问 http://localhost/xampp/phpinfo.php,Ctrl+F 搜 mod_rewrite,若出现在 “Loaded Modules” 列表里才算成功

AllowOverride 必须设为 All,且作用域要覆盖你的项目目录

ThinkPHP 的 .htaccess 文件只在 Apache 明确允许的情况下才会被读取。常见错误是只改了默认的 <directory></directory> 段,但你的项目实际放在 htdocs/thinkphp6 或其他子目录下,而该子目录没被包含在配置段里。

  • 在 httpd.conf 中找到你项目所在的 <directory></directory> 块(例如 <directory></directory>)
  • 确认其中包含 AllowOverride All(不是 None,也不是 FileInfo 等子集)
  • 同时检查是否启用了 Options FollowSymLinks —— ThinkPHP 规则依赖此选项,否则会报 500 错误
  • 如果项目在虚拟主机下(如用 project.test 域名),则必须在 httpd-vhosts.conf 对应的 <virtualhost></virtualhost> 内再写一遍 AllowOverride All

ThinkPHP 自带的 .htaccess 规则需适配 XAMPP 默认配置

ThinkPHP 官方生成的 .htaccess 在部分 XAMPP 版本中会因 MultiViews 冲突或路径解析差异导致 500 错误。直接照搬不一定能用。

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

立即学习“PHP免费学习笔记(深入)”;

  • 确保 .htaccess 放在项目根目录(即包含 public/ 子目录的那层,不是 public/ 里面)
  • 推荐使用 ThinkPHP 6.1+ 官方精简版规则(兼容性更强):
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ public/index.php [L,E=PATH_INFO:$1]
  • 避免使用 RewriteBase / —— XAMPP 本地开发一般不需要,加了反而容易出错
  • 若仍报 500,临时在 .htaccess 开头加 Options -MultiViews 关闭内容协商机制

测试时别用 localhost 根路径,要带项目子目录或域名

ThinkPHP 的路由解析依赖请求 URI 的路径层级。如果你把项目放在 htdocs/blog,却用 http://localhost/ 访问,Apache 找不到对应入口,.htaccess 也压根不会触发。

  • 正确访问方式是:http://localhost/blog/index/user/login(假设项目在 blog 目录)
  • 更稳妥的做法是配虚拟主机:在 httpd-vhosts.conf 中定义 blog.test,并在系统 hosts 文件添加 127.0.0.1 blog.test,然后访问 http://blog.test/index/user/login
  • 务必注意:浏览器地址栏显示的路径,就是 Apache 解析 .htaccess 和路由时看到的原始路径 —— 这个不能错

最容易被忽略的是:XAMPP 的 Apache 默认监听 80 端口,但 Windows 下 Skype、IIS、甚至某些杀毒软件会偷偷占着 80,导致你改完配置却启动失败,连日志都不报 —— 先检查 netstat -ano | findstr :80,确认端口空闲再折腾重写规则。

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

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

下载

相关标签:

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

热门AI工具

更多
Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

10204

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

6041

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2095

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

3788

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

4494

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

3531

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

5017

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

3942

2023.11.13

FrankenPHP集成Laravel详细教程
FrankenPHP集成Laravel详细教程

本专题提供FrankenPHP集成Laravel的详细配置指南,全面解析运行原理、开发环境搭建、Caddyfile配置、Octane工作模式、数据库连接、队列任务、定时任务和生产环境优化,解决部署过程中常见的报错与兼容性问题。

0

2026.10.08

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn