登录
首页 >  文章 >  php教程

XAMPP配置多端口指向不同的PHP项目

时间:2026-05-24 13:12:58 251浏览 收藏

本篇文章给大家分享《XAMPP配置多端口指向不同的PHP项目》,覆盖了文章的常见基础知识,其实一个语言的全部知识点一篇文章是不可能说完的,但希望通过这些问题,让读者对自己的掌握程度有一定的认识(B 数),从而弥补自己的不足,更好的掌握它。

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

XAMPP配置多端口指向不同的PHP项目

直接说结论:XAMPP 支持多端口,但必须手动改 httpd.confhttpd-vhosts.conf,且每个端口对应一个 块;漏掉权限配置或路径写错,90% 会遇到 403 ForbiddenApache failed to start

怎么在 httpd.conf 中添加新端口监听

Apache 不会自动监听除 80 以外的端口,必须显式声明。打开 XAMPP\apache\conf\httpd.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 里的配置根本没机会生效):

找到这段默认配置(通常在第 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 里的 块。打开 XAMPP\apache\conf\extra\httpd-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 路径必须完全一致,且使用正斜杠 / 或双反斜杠 \\(单反斜杠 \ 在 Windows 下会被误解析为转义字符)
  • 路径不能以斜杠结尾("C:/xampp/htdocs/project-a/" 是错的)
  • 如果项目是 Laravel、Symfony 等框架,DocumentRoot 应指向 public/ 子目录,不是项目根目录
  • 多个端口就复制多份 ,每份改端口号、路径、ServerName

Windows 防火墙和 hosts 文件要不要动

本地开发一般不用动防火墙:只要 Apache 能启动成功,localhost:8001 就能访问;只有当你想让局域网其他设备通过 IP 访问(比如手机调试),才需要在 Windows 防火墙里放行对应端口。

hosts 文件也无需修改 —— 因为你用的是 localhost:8001 这种带端口的地址,DNS 解析不经过 hosts;只有当你配二级域名(如 project-a.test)时,才需要在 C:\Windows\System32\drivers\etc\hosts 里加 127.0.0.1 project-a.test

最容易被忽略的是:每次改完配置,必须重启 Apache(不是重启 XAMPP 整体),而且要等控制面板状态栏显示 “Running” 才算生效;如果改错某处导致 Apache 启动失败,控制面板会立刻变红,这时候别盲目重装,先看 logs/error.log 里最后一行报什么错 —— 90% 都是路径拼错、少括号、或权限没放开。

以上就是《XAMPP配置多端口指向不同的PHP项目》的详细内容,更多关于XAMPP的资料请关注golang学习网公众号!

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>