XAMPP支持多端口,需手动在httpd.conf中添加Listen指令并修改httpd-vhosts.conf配置VirtualHost块;漏改权限或路径错误将导致403 Forbidden或Apache启动失败。

直接说结论:XAMPP 支持多端口,但必须手动改 httpd.conf 和 httpd-vhosts.conf,且每个端口对应一个 <virtualhost></virtualhost> 块;漏掉权限配置或路径写错,90% 会遇到 403 Forbidden 或 Apache failed to start。
怎么在 httpd.conf 中添加新端口监听
Apache 不会自动监听除 80 以外的端口,必须显式声明。打开 XAMPPpacheconfhttpd.conf,找到 Listen 80 这一行,在它下方新增你要用的端口(如 8001、8002):
Listen 80 Listen 8001 Listen 8002
注意:Listen 后面不能有冒号(:)或斜杠,只写纯数字;若本机已有其他服务占用了该端口(比如 Skype、IIS),Apache 启动会失败,错误日志里会提示 Address already in use;可先用 netstat -ano | findstr :8001 检查端口占用情况。
为什么加了端口还是 403 Forbidden
根本原因是 Apache 默认拒绝所有目录访问,尤其对非 htdocs 的自定义路径。必须在 httpd.conf 中放开全局基础权限(否则 httpd-vhosts.conf 里的配置根本没机会生效):
立即学习“PHP免费学习笔记(深入)”;
找到这段默认配置(通常在第 210–230 行左右):
<Directory />
AllowOverride none
Require all denied
</Directory>
把它改成:
<Directory />
#AllowOverride none
#Require all denied
AllowOverride All
Require all granted
</Directory>
- 不要只改
Require all granted而保留AllowOverride none—— 这会导致 .htaccess 失效,部分 PHP 框架(如 Laravel、ThinkPHP)路由无法工作 - 不要用过时的
Order deny,allow写法(Apache 2.4+ 已弃用),否则启动时报语法错误 - 改完务必运行
httpd -t验证配置语法是否正确(在 XAMPP 控制面板里点 “Shell” 打开命令行执行)
如何让每个端口指向不同 PHP 项目目录
端口监听只是第一步,真正路由到项目靠的是 httpd-vhosts.conf 里的 <virtualhost></virtualhost> 块。打开 XAMPPpacheconfextrahttpd-vhosts.conf,在文件末尾追加(以 8001 端口为例):
<VirtualHost *:8001>
DocumentRoot "C:/xampp/htdocs/project-a"
ServerName localhost:8001
<Directory "C:/xampp/htdocs/project-a">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
关键点:
-
DocumentRoot和<directory></directory>路径必须完全一致,且使用正斜杠/或双反斜杠\(单反斜杠在 Windows 下会被误解析为转义字符) - 路径不能以斜杠结尾(
"C:/xampp/htdocs/project-a/"是错的) - 如果项目是 Laravel、Symfony 等框架,
DocumentRoot应指向public/子目录,不是项目根目录 - 多个端口就复制多份
<virtualhost></virtualhost>,每份改端口号、路径、ServerName
Windows 防火墙和 hosts 文件要不要动
本地开发一般不用动防火墙:只要 Apache 能启动成功,localhost:8001 就能访问;只有当你想让局域网其他设备通过 IP 访问(比如手机调试),才需要在 Windows 防火墙里放行对应端口。
hosts 文件也无需修改 —— 因为你用的是 localhost:8001 这种带端口的地址,DNS 解析不经过 hosts;只有当你配二级域名(如 project-a.test)时,才需要在 C:WindowsSystem32driversetchosts 里加 127.0.0.1 project-a.test。
最容易被忽略的是:每次改完配置,必须重启 Apache(不是重启 XAMPP 整体),而且要等控制面板状态栏显示 “Running” 才算生效;如果改错某处导致 Apache 启动失败,控制面板会立刻变红,这时候别盲目重装,先看 logs/error.log 里最后一行报什么错 —— 90% 都是路径拼错、少括号、或权限没放开。



















