XAMPP配置多端口实现本地高可用方案模拟-php教程-PHP中文网

xampp本身不提供高可用能力，所谓“本地高可用方案模拟”实为多端口+多虚拟主机+手动故障转移；真生产级ha需keepalived+nginx+健康检查。

xampp配置多端口实现本地高可用方案模拟

XAMPP 本身不提供高可用（HA）能力，所谓“本地高可用方案模拟”，本质是用多端口 + 多虚拟主机 + 手动故障转移逻辑，来逼近 HA 的部分行为——比如服务隔离、快速切换、跨域调试。真要跑生产级 HA，得上 Keepalived + Nginx + 后端健康检查，XAMPP 不适合。

Listen 指令必须显式添加，不能只靠 VirtualHost

Apache 不会自动监听未声明的端口。哪怕你在 httpd-vhosts.conf 里写了 <virtualhost></virtualhost>，如果 httpd.conf 里没加 Listen 8081，Apache 启动时根本不会绑定该端口，浏览器访问直接 Connection refused。

打开 D:\xampp\apache\conf\httpd.conf（路径按你实际安装位置调整）
搜索 Listen 80，在其下方新增行：Listen 8081、Listen 8082 等
避免使用 1024 以下端口（如 80、443），除非你以管理员身份运行 XAMPP 控制面板
Windows 下若提示端口被占用，用 netstat -ano | findstr :8081 查进程 ID，再用 tasklist | findstr "PID" 定位程序

httpd-vhosts.conf 必须启用且含完整 Directory 权限块

只写 <virtualhost></virtualhost> 而不配 <directory></directory>，99% 触发 403 错误。XAMPP 默认全局禁止目录访问，每个 DocumentRoot 都要单独放行。

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

下载

确认 httpd.conf 中这行已取消注释：Include conf/extra/httpd-vhosts.conf
在 httpd-vhosts.conf 底部添加完整块（注意路径斜杠方向与引号）：

<virtualhost>
    ServerName localhost:8081
    DocumentRoot "D:/xampp/htdocs/project-a"
    <directory>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </directory></virtualhost>

Require all granted 是 Apache 2.4+ 的权限语法，别混用旧版 Order/Allow
路径中反斜杠 \ 在 Windows 下可能被误解析，统一用正斜杠 /
目录末尾不要加斜杠，"D:/xampp/htdocs/project-a/" 会导致 403

hosts 文件绑定域名后，ServerName 必须严格匹配

如果你在 C:\Windows\System32\drivers\etc\hosts 加了 127.0.0.1 api.local，但 httpd-vhosts.conf 里写的是 ServerName localhost:8081，请求会落到默认虚拟主机（通常是第一个定义的），而非你预期的站点。

为每个端口配独立域名更可控，例如：
127.0.0.1 api.local → ServerName api.local + Listen 8081
127.0.0.1 admin.local → ServerName admin.local + Listen 8082
若仍想用 localhost:8081 访问，ServerName 就必须写成 localhost:8081，不能省略端口
多个域名指向同一目录？用 ServerAlias，如 ServerAlias api.test api.dev

重启 Apache 前务必验证配置语法

改完配置直接点重启，失败了只看到红色错误灯，根本不知道哪错了。Apache 提供命令行校验工具，比盲试高效十倍。

打开命令行（CMD 或 PowerShell），cd 到 D:\xampp\apache\bin
执行：httpd.exe -t
返回 Syntax OK 才安全；否则会明确指出哪一行、哪个文件出错（比如拼错或路径引号不闭合）
若提示 Invalid command 'Require'，说明你用了 Apache 2.2 语法但实际是 2.4+，换用 Require all granted
XAMPP 控制面板里 Apache 的“Config” → “Apache (httpd.conf)” 只能编辑主配置，httpd-vhosts.conf 得手动找路径打开

最容易被忽略的是：XAMPP 的 Apache 默认关闭 mod_rewrite 和 mod_headers，而跨域调试、伪静态路由、自定义响应头等场景全依赖它们。需要进 httpd.conf 解开对应 #LoadModule rewrite_module modules/mod_rewrite.so 这类行的注释——这不是多端口专属问题，但一并配错，整个模拟就卡在第一步。