XAMPP配置多端口实现自动化测试环境-php教程-PHP中文网

apache监听端口必须在httpd.conf中显式声明listen指令，仅在httpd-vhosts.conf中配置*:8080无效；virtualhost需配权限块并设require all granted；须启用include conf/extra/httpd-vhosts.conf且重启服务。

xampp配置多端口实现自动化测试环境

Apache监听端口必须显式声明 `Listen`

不加 Listen 8080 这类语句，哪怕 httpd-vhosts.conf 里写了 *:8080，Apache 启动时也不会监听该端口，访问直接超时或拒绝连接。

操作上：打开 D:\xampp\apache\conf\httpd.conf，找到已有 Listen 80 行，在其下方新增你需要的端口，例如：

Listen 80
Listen 8080
Listen 8081
Listen 9000

注意点：

端口不能被其他进程占用（netstat -ano | findstr :8080 可查）
Windows 下避免使用 1–1023 的保留端口（如 80、443、21），尤其自动化脚本频繁启停时易触发系统权限限制
若改了非标准端口（比如 8080），所有测试用例里的 URL 必须同步更新为 http://localhost:8080/，否则 Selenium 或 Requests 请求会失败

`httpd-vhosts.conf` 中每个 `VirtualHost` 必须配 `<directory></directory>` 权限块

只写 DocumentRoot 和 ServerName 是不够的。Apache 2.4 默认拒绝所有目录访问，没配 <directory></directory> 就会返回 403 Forbidden。

正确写法示例（以端口 8080 为例）：

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

关键细节：

Require all granted 是 Apache 2.4 的写法，别写成旧版的 Order allow,deny + Allow from all，否则启动报错
AllowOverride All 才能让 .htaccess 生效，对 Laravel、ThinkPHP 等框架路由重写很关键
路径中的反斜杠 \ 在 Windows 下要统一换成正斜杠 /，否则 Apache 解析失败

必须启用 `httpd-vhosts.conf` 的全局包含

默认情况下 httpd.conf 里这行是被注释掉的：

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

下载

#Include conf/extra/httpd-vhosts.conf

如果不取消注释，你往 httpd-vhosts.conf 里加多少个 VirtualHost 都不会生效。

检查并修改为：

Include conf/extra/httpd-vhosts.conf

常见疏漏：

改完后忘记重启 Apache（仅重启控制面板里的服务不够，有时需手动 stop → start）
误删了 httpd-vhosts.conf 开头的注释说明块，导致语法解析出错（其实不影响，但建议保留）
多个 VirtualHost 块之间没空行，某些版本 Apache 会把下一块识别为上一块的延续，造成配置错乱

自动化测试中端口冲突的真实来源常被误判

你以为是 Skype 或 IIS 占了 80？其实更可能是 Python 测试脚本本身在跑 flask.run(port=8080) 或 pytest --tb=short 启动了临时服务，没退出干净就去启 XAMPP，结果端口被占。

排查建议：

运行 netstat -ano | findstr :8080，记下 PID，再用 tasklist | findstr <pid></pid> 查进程名
CI/CD 脚本中若用 subprocess.Popen 启动 XAMPP 控制台，记得加 shell=True 并捕获 stdout/stderr，否则后台进程残留难发现
本地调试时，浏览器标签页开着 http://localhost:8080，有时会“保持连接”，关掉所有标签再试

最麻烦的是 Windows Hyper-V 或 WSL2 默认启用 NAT 网关，会悄悄监听 53/80/443 端口——这时得进 PowerShell 执行 Get-NetTCPConnection -LocalPort 8080 | Format-List * 看 OwningProcess 是否为 svchost，再结合 Get-Process -Id <pid></pid> 定位真实服务。