XAMPP Apache多端口虚拟主机配置教程

想在XAMPP中轻松实现多端口虚拟主机（如localhost:8080跑ZendFramework、localhost:8081跑测试站）？关键就两点：必须在httpd.conf中显式添加Listen指令（如Listen 8080），同时在httpd-vhosts.conf里为每个端口单独配置完整的VirtualHost块——二者缺一不可，否则不是请求进不来，就是报404或403错误；配置时还要注意Apache 2.4+必需的Require all granted、DocumentRoot指向public目录、避免路径中的中文与空格，并通过httpd.exe -t验证语法后彻底重启服务，才能让多端口开发环境稳定高效运行。

直接说结论：XAMPP 默认只监听 80 端口，要支持 8080、8081 等多端口虚拟主机，必须手动在 httpd.conf 中添加 Listen 指令，并在 httpd-vhosts.conf 中为每个端口写独立的 块——缺一不可，否则访问会 404 或直接拒绝连接。

必须先在 httpd.conf 中显式声明监听端口

Apache 不会自动响应未声明的端口。即使你在 httpd-vhosts.conf 里写了 ，如果 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

不能复用同一个 块绑定多个端口；每个端口对应一个块，且 ServerName 可以相同也可以不同，取决于你想要的路由逻辑。

• 示例：让 localhost:8080 指向 ZendFramework 项目，localhost:8081 指向测试站
• 在 XAMPP\apache\conf\extra\httpd-vhosts.conf 末尾添加：

    DocumentRoot "D:/xampp/htdocs/zf2public"
    ServerName localhost
    
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    



    DocumentRoot "D:/xampp/htdocs/testsite"
    ServerName localhost
    
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    

• 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 + ——这会导致匹配失败，因为请求 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/ 子目录，而非项目根目录，否则路由和资源路径全错

到这里，我们也就讲完了《XAMPP Apache多端口虚拟主机配置教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于XAMPP的知识点！