XAMPP如何开启多端口监听模式-php教程-PHP中文网

apache必须显式配置listen指令才能监听非80端口，仅修改httpd-vhosts.conf中的virtualhost而未在httpd.conf中添加对应listen会导致端口不绑定；同时需启用vhosts配置、正确设置directory权限（require all granted）、避免语法错误，并重启服务后通过netstat或lsof验证监听状态。

xampp如何开启多端口监听模式

Listen 指令必须显式添加，Apache 不会自动监听额外端口；只改 httpd-vhosts.conf 而不改 httpd.conf 中的 Listen，端口根本不会被绑定。

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` 中添加多个 `Listen` 指令

Apache 启动时只监听配置中明确声明的端口，Listen 80 是默认项，其他端口必须手动追加。常见错误是只在 httpd-vhosts.conf 里写 <virtualhost></virtualhost>，但没在 httpd.conf 里加 Listen 8081，结果浏览器连不上，netstat -an | grep 8081 也看不到监听状态。

Windows 路径：C:\xampp\apache\conf\httpd.conf
macOS 路径：/Applications/XAMPP/etc/httpd.conf
找到 Listen 80 行，在其下方新增行，例如：
```
Listen 8080
Listen 8081
Listen 8443
```
端口号不能冲突：用 lsof -i :8080（macOS）或 netstat -ano | findstr :8080（Windows）确认端口空闲
不要写成 Listen: 8080 或 Listen 8080: —— 冒号和多余空格会导致 Apache 启动失败，错误日志里会报 Invalid argument: AH00527

确保 `httpd-vhosts.conf` 已启用且语法正确

XAMPP 默认注释掉了虚拟主机配置，不解除注释，<virtualhost></virtualhost> 块完全不生效。

打开 httpd.conf，搜索 Include conf/extra/httpd-vhosts.conf
确保该行前面没有 #；如果被注释了，删掉 # 和前后空格

编辑 conf/extra/httpd-vhosts.conf，在文件末尾添加完整块（注意路径、端口、ServerName 三者一致）：

<virtualhost>
  ServerName localhost:8080
  DocumentRoot "C:/xampp/htdocs/project-a"
  <directory>
      Require all granted
  </directory></virtualhost>

ServerName 推荐写成 localhost:8080，避免和默认 localhost（端口 80）混淆
Windows 路径用正斜杠 / 或双反斜杠 \，单反斜杠 \ 会被 Apache 解析为转义符，导致路径错误

绕过 403 Forbidden 的关键权限配置

即使端口监听成功、虚拟主机匹配，仍可能返回 Access forbidden! —— 这几乎全是 <directory></directory> 权限控制惹的祸。

XAMPP 默认在 httpd.conf 底部有一段全局 <directory></directory> 配置，内容类似：
```
<directory></directory>
  AllowOverride none
  Require all denied
```
它会拒绝所有根目录访问，覆盖你 httpd-vhosts.conf 里的授权。

正确做法是注释掉或修改这段全局配置，改为：

<directory></directory>
  AllowOverride none
  Require all granted

或更稳妥：不在全局改，而是在每个 <virtualhost></virtualhost> 内显式定义 <directory></directory> 块（如上例），并确保含 Require all granted
旧版 Apache（2.2）用 Order allow,deny + Allow from all，新版（2.4+）必须用 Require all granted，混用会导致启动失败或 403

重启与验证顺序不能错

改完配置不重启 = 白改；重启后不验证 = 不知道哪步错了。

必须先停止 Apache，再启动 —— XAMPP 控制面板点 “Stop” 再点 “Start”，不要只点 “Restart”（有时状态不同步）
启动后立刻检查 Apache 错误日志：tail -f /Applications/XAMPP/logs/error_log（macOS）或打开 C:\xampp\apache\logs\error.log（Windows），重点看是否有：
Address already in use: AH00072（端口被占）
Syntax error on line XX（配置语法错）
Cannot load modules/mod_access_compat.so（模块缺失，说明用了 2.2 语法但跑在 2.4 上）
验证监听：终端执行 lsof -i :8080 或 netstat -ano | findstr :8080，看到 LISTEN 状态才算成功
最后才用浏览器访问 @#@#@#@#@#@#@#@#@#@0；如果页面空白或 404，优先查日志，而不是反复重启