XAMPP配置多端口实现本地多级子域名-php教程-PHP中文网

xampp不支持多级子域名+多端口自动映射，须手动配置hosts、httpd.conf和httpd-vhosts.conf三处，apache 2.4+必须用require all granted否则403必现。

xampp配置多端口实现本地多级子域名

直接说结论：XAMPP 本身不支持“多级子域名 + 多端口”自动映射，必须手动组合 hosts + httpd.conf + httpd-vhosts.conf 三处配置，且 Apache 2.4+ 必须用 Require all granted 替代旧版权限指令，否则 403 错误必现。

为什么不能只靠改 `httpd-vhosts.conf` 就生效

Apache 不会自动把 www.dev.project.local 这种多级子域名解析到对应目录——它只认 ServerName 字符串是否完全匹配。你写 ServerName dev.project.local，浏览器输 www.dev.project.local 就 404；反过来也一样。所以每个多级子域名都得单独配一条 <virtualhost></virtualhost>，不能靠通配符偷懒（*.dev.project.local 在 Apache 2.4 默认不启用，需额外加 ServerAlias 或启用 mod_vhost_alias，但 XAMPP 默认没开）。

ServerName 必须和浏览器地址栏输入的**完整主机名**一字不差（包括 www. 前缀）
若想同时支持 dev.project.local 和 www.dev.project.local，得在同一个 <virtualhost></virtualhost> 块里加 ServerAlias dev.project.local www.dev.project.local
httpd-vhosts.conf 文件本身默认是被注释掉的，必须确认 httpd.conf 里这行没被注释：Include conf/extra/httpd-vhosts.conf

`hosts` 文件怎么填才不翻车

Windows 的 hosts 是纯文本映射，不支持通配符或正则。每个你要访问的多级子域名，都得单独写一行指向 127.0.0.1：

XAMPP 8.0.30

XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin

下载

错误写法：127.0.0.1 *.dev.project.local（会被当字面量，无效）
正确写法（三行）：127.0.0.1 dev.project.local、127.0.0.1 www.dev.project.local、127.0.0.1 api.dev.project.local
修改后必须以管理员身份运行记事本保存，否则 Windows 会静默失败（尤其 Win10/Win11）
改完别忘了清 DNS 缓存：ipconfig /flushdns，否则旧缓存可能让你白等几分钟

端口 + 子域名混搭的实际配置示例

假设你要让 admin.dev.project.local:8080 指向 D:\xampp\htdocs\project-admin，而 api.dev.project.local:8081 指向 D:\xampp\htdocs\project-api，操作顺序不能错：

第一步：在 httpd.conf 里添加监听端口（位置在已有 Listen 80 下方）：Listen 8080、Listen 8081

第二步：在 httpd-vhosts.conf 里分别写两个块（注意路径斜杠用正斜杠或双反斜杠）：

<virtualhost>
    ServerName admin.dev.project.local
    DocumentRoot "D:/xampp/htdocs/project-admin"
    <directory>
        Require all granted
        AllowOverride All
    </directory></virtualhost>

<virtualhost>
    ServerName api.dev.project.local
    DocumentRoot "D:/xampp/htdocs/project-api"
    <directory>
        Require all granted
        AllowOverride All
    </directory></virtualhost>

第三步：确保 hosts 已含这两行：127.0.0.1 admin.dev.project.local 和 127.0.0.1 api.dev.project.local

最容易被忽略的是权限模型切换——XAMPP 从 5.6 开始默认用 Apache 2.4，Order Deny,Allow 和 Allow from all 全部失效，不换成 Require all granted 就算路径全对，也只会返回 403 Forbidden。另外，端口号尽量避开 1024 以下（比如别用 80、443、21），否则可能被系统服务占用或需要管理员权限启动。