XAMPP默认仅监听80端口,要启用8080、8081等多端口虚拟主机,必须同时在httpd.conf中添加Listen指令(如Listen 8080)并在httpd-vhosts.conf中为每个端口配置独立的<VirtualHost *:8080>块,缺一不可,否则请求无法进入或返回404/403。

直接说结论:XAMPP 默认只监听 80 端口,要支持 8080、8081 等多端口虚拟主机,必须手动在 httpd.conf 中添加 Listen 指令,并在 httpd-vhosts.conf 中为每个端口写独立的 <VirtualHost *:8080> 块——缺一不可,否则访问会 404 或直接拒绝连接。
必须先在 httpd.conf 中显式声明监听端口
Apache 不会自动响应未声明的端口。即使你在 httpd-vhosts.conf 里写了 <VirtualHost *:8080>,如果 httpd.conf 没有 Listen 8080,请求根本进不来。
- 打开
XAMPP\apache\conf\httpd.conf - 搜索
Listen 80,在其下方新增行:Listen 8080、Listen 8081(按需) - 确认
Include conf/extra/httpd-vhosts.conf这一行前面没有#(即已启用虚拟主机配置) - 注意:Windows 下若 8080 被占用(如 Skype、IIS),Apache 启动会失败,可用
netstat -ano | findstr :8080查进程 PID
httpd-vhosts.conf 中每个端口要单独定义 VirtualHost
不能复用同一个 <VirtualHost> 块绑定多个端口;每个端口对应一个块,且 ServerName 可以相同也可以不同,取决于你想要的路由逻辑。
Apache Superset 是一个广泛采用的开源 BI 平台,用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时,此技能非常有用。
- 示例:让
localhost:8080指向 ZendFramework 项目,localhost:8081指向测试站 - 在
XAMPP\apache\conf\extra\httpd-vhosts.conf末尾添加:
<VirtualHost *:8080>
DocumentRoot "D:/xampp/htdocs/zf2public"
ServerName localhost
<Directory "D:/xampp/htdocs/zf2public">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
<VirtualHost *:8081>
DocumentRoot "D:/xampp/htdocs/testsite"
ServerName localhost
<Directory "D:/xampp/htdocs/testsite">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
-
Require all granted是 Apache 2.4+ 必须项,漏掉会导致 403 Forbidden -
AllowOverride All对 ZendFramework 等依赖 .htaccess 的框架是刚需 - 路径中避免中文、空格、盘符大小写混用(Windows 下虽不敏感,但 PHP 路径函数可能出错)
hosts 文件不用改,但浏览器访问必须带端口号
基于端口的虚拟主机不依赖域名解析,所以 C:\Windows\System32\drivers\etc\hosts 无需添加任何记录——只要 Apache 监听了该端口,且 VirtualHost 配置正确,http://localhost:8080 就能直达对应目录。
- 错误做法:在 hosts 里加
127.0.0.1 myapp.local,却在httpd-vhosts.conf里写ServerName myapp.local+<VirtualHost *:8080>——这会导致匹配失败,因为请求 Host 头是myapp.local:8080,而ServerName默认不认带端口的值 - 正确做法:要么全用
localhost:端口访问(最简),要么在ServerName显式写带端口的域名(不推荐,兼容性差) - 调试时可临时加
ServerAlias 127.0.0.1避免 Host 头不匹配问题
重启 Apache 前务必检查语法,否则服务起不来
Apache 对配置文件语法极其敏感,一个括号没闭合、路径少个引号,都会导致 httpd.exe 启动失败,XAMPP 控制面板显示 “Start” 按钮灰色或闪退。
- 命令行验证法:进
XAMPP\apache\bin,执行httpd.exe -t,输出Syntax OK才安全 - 常见报错:
Invalid command 'Require', perhaps misspelled→ Apache 版本低于 2.4,需换用Order allow,deny旧语法 - 修改后必须完全停止 Apache(不是“Restart”),再点 Start,否则旧配置可能缓存
- ZendFramework 项目要注意
DocumentRoot应指向public/子目录,而非项目根目录,否则路由和资源路径全错

















