XAMPP环境下多端口部署Webasyst-php教程-PHP中文网

webasyst 在 xampp 中需配置独立端口（如 8081）、启用 httpd-vhosts.conf 和 rewrite 模块，documentroot 必须指向 public 子目录，allowoverride all 不可少，并检查全局 directory 权限、文件夹安全设置及防火墙放行。

xampp环境下多端口部署webasyst

XAMPP 默认只监听 80 端口，Webasyst 若需独立运行（尤其配合多环境、本地调试或避免与 WordPress 冲突），必须显式配置额外端口，且不能只改 Listen —— 虚拟主机、目录权限、Apache 模块三者缺一不可。

修改 `httpd.conf` 添加监听端口并启用虚拟主机支持

不改这个，httpd-vhosts.conf 文件压根不会被加载。打开 D:\xampp\apache\conf\httpd.conf（Windows）或 /opt/lampp/etc/httpd.conf（Linux），确认两处关键配置已启用：

Include conf/extra/httpd-vhosts.conf 这行前面不能有 #（即必须取消注释）
搜索 Listen 80，在其下方新增一行，例如：Listen 8081（Webasyst 建议避开 8080/8082 等常用端口，防止与前端 dev server 冲突）
顺手检查 LoadModule rewrite_module modules/mod_rewrite.so 是否已启用（Webasyst 依赖 URL 重写）

在 `httpd-vhosts.conf` 中为 Webasyst 单独定义 `<virtualhost></virtualhost>`

Webasyst 对 DocumentRoot 路径敏感，必须指向其 public 子目录（不是项目根目录），否则会报 403 或白屏。示例配置如下：

<virtualhost>
    DocumentRoot "D:/xampp/htdocs/webasyst/public"
    ServerName localhost
    <directory>
        AllowOverride All
        Require all granted
    </directory></virtualhost>

注意点：

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

下载

AllowOverride All 是必须的，否则 Webasyst 的 .htaccess 无法生效，路由全部 404
路径中不能漏掉 /public —— Webasyst 从 6.x 开始强制入口隔离，直接指向根目录会暴露敏感文件
如果同时跑多个 Webasyst 实例（如测试版/正式版），每个 <virtualhost></virtualhost> 必须用不同端口，且 DocumentRoot 和 <directory></directory> 路径要一一对应

解决常见 403 Forbidden 错误的三个实际检查点

配完重启 Apache 仍 403？大概率卡在这三处：

httpd.conf 中全局 <directory></directory> 段落里，Require all denied 没注释掉（XAMPP 新版本默认是 deny，老教程常忽略这点）
Windows 下文件夹权限：右键 webasyst 文件夹 → 属性 → 安全 → 编辑 → 给 Everyone 或 IUSR 添加「读取和执行」权限（Linux 下则需 chmod -R 755 webasyst）
Webasyst 的 public/.htaccess 文件是否被意外删除或损坏 —— 可从官方 GitHub 仓库重新下载一份覆盖

访问前务必关闭 Windows 防火墙临时规则或放行端口

即使 Apache 启动成功、配置无误，Windows 防火墙默认会拦截非 80/443 的入站连接。执行以下任一操作：

控制面板 → Windows Defender 防火墙 → 允许应用通过防火墙 → 勾选 Apache HTTP Server 并确保「专用」和「公用」都打勾
命令行快速放行：netsh advfirewall firewall add rule name="XAMPP Webasyst 8081" dir=in action=allow protocol=TCP localport=8081
Linux 用户注意：sudo ufw allow 8081（若启用 ufw）或检查 iptables 规则

端口冲突比想象中更隐蔽——比如 Skype 旧版默认劫持 80/443，VS Code 的 Live Server 插件可能占着 5500，Chrome 扩展有时也会监听随机端口。启动前用 netstat -ano | findstr :8081（Windows）或 lsof -i :8081（Linux/macOS）确认端口空闲。