xampp支持多端口部署microweber，但必须手动配置apache监听端口、虚拟主机及hosts映射，且documentroot须指向microweber项目根目录（含index.php和public），否则易出现403/500错误；必须启用httpd-vhosts.conf（取消include注释），并确保servername、listen端口、documentroot、hosts域名四者严格对齐。
直接说结论：XAMPP 支持多端口部署 Microweber，但必须手动配置 Apache 监听端口 + 虚拟主机 + 系统 hosts，且 DocumentRoot 必须指向 Microweber 项目根目录（含 index.php 和 public 目录结构），否则 403 或 500 错误几乎必然出现。
必须启用 httpd-vhosts.conf 并取消注释 Include
默认 XAMPP 的 Apache 不加载虚拟主机配置，哪怕你改了 httpd-vhosts.conf 也没用。打开 D:\xampp\apache\conf\httpd.conf（Windows）或 /opt/lampp/etc/httpd.conf（Linux），找到这一行：
#Include conf/extra/httpd-vhosts.conf
删掉开头的 #，保存。漏这步是“配了却没生效”的第一大原因。
顺带检查：ServerName 应为 localhost:80 或对应端口（如 localhost:8080），不能写成 localhost:8080/ 或带路径，否则 Apache 启动失败。
Listen 多端口 + VirtualHost 绑定要严格对应
Microweber 是 PHP 应用，依赖 mod_rewrite 和正确的文档根路径。不能只靠 Listen 就完事——必须为每个端口定义独立的 <virtualhost></virtualhost> 块。
- 在
httpd.conf顶部加监听（避开 1–1024 系统端口）：Listen 8080<br>Listen 8081
- 在
httpd-vhosts.conf中配两个站点，例如：<virtualhost><br> ServerName mw-dev.local<br> DocumentRoot "D:/xampp/htdocs/mw1"<br><directory><br> Require all granted<br> AllowOverride All<br></directory><br></virtualhost><br><br><virtualhost><br> ServerName mw-test.local<br> DocumentRoot "D:/xampp/htdocs/mw2"<br><directory><br> Require all granted<br> AllowOverride All<br></directory><br></virtualhost>
-
DocumentRoot必须是 Microweber 解压后的**最外层目录**（即含index.php、public/、vendor/的那一层），不是public/子目录；否则重写规则失效，CSS/JS 404，后台打不开。
hosts 文件映射和浏览器访问方式
Microweber 内部路由依赖域名（如 mw-dev.local），不支持纯端口访问（localhost:8080 会进默认站点或报错）。必须做本地 DNS 映射：
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
用管理员权限打开 C:\Windows\System32\drivers\etc\hosts（Windows）或 /etc/hosts（Linux），追加：
127.0.0.1 mw-dev.local<br>127.0.0.1 mw-test.local
保存后，**不要用 localhost:8080 访问**，而要用：http://mw-dev.local:8080http://mw-test.local:8081
首次安装时，Microweber 会自动检测域名并生成 config/database.php，如果用错地址（比如用了 127.0.0.1:8080），后续迁移或换域名会出问题。
常见错误与绕不过去的坑
以下错误基本都卡在配置链某一环断掉：
-
403 Forbidden：多数是
<directory></directory>块里没写Require all granted，或AllowOverride All没开，导致 .htaccess 不生效； -
500 Internal Server Error：检查
php_error_log（在D:\xampp\apache\logs\或/opt/lampp/logs/），大概率是 Microweber 的storage/目录无写权限，或 PHP 版本低于 7.4（XAMPP 8.2+ 默认带 PHP 8.2，没问题）； -
空白页 / CSS 加载失败：确认
DocumentRoot指向的是 Microweber 项目根，不是public/；同时检查public/.htaccess是否存在且未被 Windows 隐藏； -
Apache 启动失败：运行
httpd -t（Windows 下进D:\xampp\apache\bin\执行）验证配置语法，比盲目重启更省时间。
真正麻烦的从来不是“怎么加端口”，而是三处路径和域名必须咬死对齐：hosts 里的域名 → vhosts 里的 ServerName → vhosts 里的 DocumentRoot。错一个，整个链就断。
