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

xampp中为mybb配置新端口需同步修改三处：一、httpd.conf中追加listen 8080；二、httpd-vhosts.conf中添加对应virtualhost并设准documentroot；三、mybb的config.php中数据库端口与board url须匹配该端口，缺一则导致白屏、500或连接失败。

xampp环境下多端口部署mybb

直接在 XAMPP 里为 MyBB 开一个新端口（比如 8080）就能跑起来，但必须同步改三处：Apache 监听配置、虚拟主机定义、MyBB 的数据库连接设置。漏掉任意一项，访问时大概率是白屏、500 错误或数据库拒绝连接。

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

只改 Listen 80 不够——MyBB 需要独立入口，得让 Apache 主动“听”新端口。打开 D:\xampp\apache\conf\httpd.conf，在已有 Listen 80 行下方追加：

Listen 8080

注意：Listen 后面不能有冒号，写成 Listen: 8080 会启动失败；如果系统已有服务占了 8080（比如 Skype 或 Docker），换用 8081 或 8090 更稳妥。

在 `httpd-vhosts.conf` 中配 `<virtualhost></virtualhost>`

光监听不路由等于没开——必须把 8080 端口的请求明确指给 MyBB 的安装目录。编辑 D:\xampp\apache\conf\extra\httpd-vhosts.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

下载

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

关键点：

DocumentRoot 必须是绝对路径，结尾不带斜杠（D:/xampp/htdocs/mybb ✅，D:/xampp/htdocs/mybb/ ❌）
确保 httpd.conf 里这行没被注释：Include conf/extra/httpd-vhosts.conf
如果访问出现 403 Forbidden，检查 httpd.conf 中全局 <directory></directory> 块是否允许 Require all granted

MyBB 安装时填对数据库端口和 URL

MyBB 的安装向导默认连 localhost:3306，但如果你同时运行多个 MySQL 实例（比如另一个 XAMPP 改了 MySQL 端口为 3307），这里必须手动填准。安装过程中遇到数据库连接失败，优先确认：

MySQL 服务是否已启动（XAMPP 控制面板里 MySQL 显示 Running）
MyBB 的 inc/config.php 里 $config['database']['port'] 是否匹配实际 MySQL 端口（默认 3306，改过就填对应值）
$config['database']['hostname'] 别写成 127.0.0.1:8080——端口属于 Apache，数据库 hostname 只写 localhost 或 127.0.0.1
如果用域名访问（如 mybb.test），MyBB 后台 → Configuration → Site Details → Board URL 必须设为 http://mybb.test:8080，否则头像、CSS 路径全 404

最易被忽略的是：MyBB 某些插件或缓存机制会硬编码当前请求的端口，若后期把 8080 改成 80 或反向代理到 Nginx，不清理 cache/ 和 uploads/ 下的旧缓存文件，页面可能持续加载错误资源。动手前先备份 inc/config.php 和 cache/ 目录。