Pop PHP 在 XAMPP 多端口下报 404 的根本原因是 Apache 未启用 mod_rewrite 模块且虚拟主机配置中缺失 AllowOverride All 和 Require all granted，导致 .htaccess 重写规则失效，请求无法路由至 index.php 入口。
Pop PHP 不能直接靠 XAMPP 默认配置跑起来，必须显式启用 mod_rewrite 并配好端口路由规则，否则所有请求都会 404 或跳转到 dashboard。
为什么 Pop PHP 在 XAMPP 多端口下总报 404
Pop PHP 是基于前端控制器（index.php）的框架，依赖 Apache 的 URL 重写把请求统一代理过去。XAMPP 默认关闭 mod_rewrite，且多端口配置时容易漏掉 <directory></directory> 块里的 AllowOverride All —— 这会导致 .htaccess 文件被忽略，重写规则完全不生效。
- 现象：访问
http://localhost:8080/user/list显示 404，但http://localhost:8080/index.php/user/list能正常响应 - 根本原因：Apache 没把请求交给 Pop 的
index.php入口，而是按文件路径直接找/user/list这个不存在的子目录 - 检查方式：在项目根目录放一个
test.php，用http://localhost:8080/test.php能打开，说明 PHP 和端口本身没问题
配置 httpd-vhosts.conf 时必须加的三处关键项
只写 <virtualhost></virtualhost> 不够，Pop PHP 需要明确授权重写、放开目录访问、并指定入口点。以下是在 C:\XAMPP\apache\conf\extra\httpd-vhosts.conf 中添加的最小可行块：
<virtualhost>
ServerName pop.local
DocumentRoot "C:/xampp/htdocs/pop-project/public"
<directory>
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</directory></virtualhost>
-
DocumentRoot必须指向 Pop 项目的public/目录，不是项目根目录 -
AllowOverride All是启用.htaccess的开关，缺了它重写规则就失效 -
Require all granted替代旧版的Order Deny,Allow，XAMPP 5.6+ 必须用这个语法 - 别忘了在
C:\Windows\System32\drivers\etc\hosts加127.0.0.1 pop.local
httpd.conf 里两个常被忽略的启用项
即使 httpd-vhosts.conf 写对了，如果主配置没开关键模块，整个虚拟主机都加载不了：
- 确认
C:\XAMPP\apache\conf\httpd.conf中这行已取消注释：Include conf/extra/httpd-vhosts.conf - 确认这行未被注释：
LoadModule rewrite_module modules/mod_rewrite.so - 如果改过
Listen端口，比如新加了Listen 8080，必须确保它出现在httpd.conf的Listen列表里，且不能和已有端口冲突（如 Skype 占 8080） - 改完后务必运行
httpd -t验证语法，再重启 Apache —— 否则控制面板里 Start 按钮会瞬间变灰，无任何错误提示
Pop PHP 项目结构与 public/.htaccess 的适配要点
Pop PHP 官方生成器建的项目，public/.htaccess 默认内容是兼容标准 Apache 的，但 XAMPP Windows 下要注意两处：
- 确保
.htaccess文件真实存在且没被系统隐藏（Windows 资源管理器需勾选“显示隐藏的文件”） - 若遇到重写后 CSS/JS 404，检查
.htaccess里RewriteBase是否设对；Pop 项目通常应为：RewriteBase /（因为DocumentRoot已指向public/） - 不要在
httpd-vhosts.conf里重复写重写规则 —— Pop 自己的.htaccess已覆盖全部路由逻辑，额外加RewriteRule反而容易冲突
最易被忽略的是：XAMPP 控制面板启动 Apache 时默认不以管理员权限运行，导致某些端口（如 80）绑定失败却只报“Apache shutdown unexpectedly”，实际日志在 C:\XAMPP\apache\logs\error.log 里 —— 查不到具体原因就白调半天。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
