XAMPP配置多端口实现微服务本地模拟-php教程-PHP中文网

xampp本身不是为微服务架构设计的，但可通过配置多端口（如8080、8081）+独立virtualhost绑定目录+正确权限控制（require local、路径无中文、hosts映射域名）来模拟多个本地服务端点，本质是手动隔离而非原生微服务支持。

xampp配置多端口实现微服务本地模拟

直接说结论：XAMPP 本身不是为微服务架构设计的，但你可以用它模拟多个本地服务端点（比如 localhost:8080、localhost:8081、localhost:8082），前提是 Apache 能监听多个端口 + 每个端口绑定独立目录 + 正确处理权限。这不是“开箱即用”的微服务，而是靠手动隔离路径和端口来逼近效果。

修改 `httpd.conf` 添加监听端口

Apache 默认只监听 Listen 80，必须显式添加你要用的额外端口。别只改一行 —— 否则新端口根本不会被 Apache 接收请求。

打开 XAMPP\apache\conf\httpd.conf
在 Listen 80 下方追加多行，例如：
```
Listen 8080<br>Listen 8081<br>Listen 8082
```
确保没有重复 Listen 行，也不要用 Listen 0.0.0.0:8080 这类写法（XAMPP 旧版不认）
Windows 上若提示端口被占用，用 netstat -ano | findstr :8080 查 PID，再用任务管理器结束对应进程

启用并配置 `httpd-vhosts.conf` 绑定端口与目录

光开监听端口没用，Apache 不知道该把请求交给谁。必须通过虚拟主机把每个端口映射到具体目录，否则所有端口都 fallback 到 htdocs 或直接 404/403。

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

→ 改成

Include conf/extra/httpd-vhosts.conf

编辑 XAMPP\apache\conf\extra\httpd-vhosts.conf，在末尾添加类似结构（注意每段 <virtualhost></virtualhost> 的端口号要和 Listen 一致）：

<virtualhost><br>    DocumentRoot "D:/xampp/htdocs/service-auth"<br>    ServerName localhost<br><directory><br>        Options Indexes FollowSymLinks<br>        AllowOverride All<br>        Require local<br></directory><br></virtualhost>

Apache 2.4+ 必须用 Require local（不是旧版的 Allow from all），否则 403 错误必现
每个 DocumentRoot 目录必须真实存在，且至少含一个可访问文件（如 index.php），否则浏览器会报 “Forbidden” 或 “No input file specified”

为什么访问时总出现 403 Forbidden？

这是 XAMPP 多端口配置里最常卡住的地方，90% 不是端口问题，而是 Apache 对根目录或子目录的默认拒绝策略生效了。

检查 httpd.conf 中全局 <directory></directory> 块 —— XAMPP 默认是 Require all denied，这会直接封杀所有未显式授权的路径
不要全局放开 <directory></directory>，而应在每个 <virtualhost></virtualhost> 内的 <directory></directory> 中单独配 Require local
路径中不能有中文、空格或特殊符号（如 D:\My Projects\api 会失败），推荐用纯英文短路径，例如 D:/xampp/htdocs/svc-user
Windows 下若仍 403，请右键目录 → 属性 → 安全 → 编辑 → 给 Everyone 或 IIS_IUSRS 添加“读取和执行”权限（仅限本地开发环境）

hosts 文件不是必须的，但域名绑定需同步处理

如果你只是用 localhost:8080 访问，hosts 文件完全不用动。但一旦想用 auth.local、user.local 这类域名模拟微服务通信，就必须双管齐下：

在系统 hosts 文件（Windows 是 C:\Windows\System32\drivers\etc\hosts，macOS/Linux 是 /etc/hosts）末尾加：
```
127.0.0.1 auth.local<br>127.0.0.1 user.local
```
同时在 httpd-vhosts.conf 中对应 <virtualhost></virtualhost> 里写 ServerName auth.local 和 ServerName user.local
注意：浏览器地址栏输 auth.local:8080 才能命中，只输 auth.local 会走默认 80 端口，而你未必开了 *:80 的虚拟主机
Chrome/Firefox 有时缓存 DNS，改完 hosts 后可尝试 chrome://net-internals/#dns 清除 DNS 缓存

真正难的不是加端口，而是让每个端口下的 PHP 服务互不干扰 —— 比如 session 共享、数据库连接池、跨域头设置。XAMPP 不提供服务发现或负载均衡，这些得靠你在代码里硬编码或用 Nginx 做反向代理补位。如果项目真走到需要稳定微服务本地调试那步，建议直接切 Docker Compose。