XAMPP环境下多端口部署Z-Blog博客-php教程-PHP中文网

apache多端口监听需同步修改httpd.conf中的listen和servername，再在httpd-vhosts.conf中为每个端口配置独立virtualhost、documentroot及directory权限，并确保z-blog数据库名、表前缀、zb_users目录和cache完全隔离。

xampp环境下多端口部署z-blog博客

Apache多端口监听必须改`httpd.conf`里的`Listen`和`ServerName`

XAMPP默认只监听80端口，想用http://localhost:8080和http://localhost:8081同时跑两个Z-Blog站点，光加一行Listen 8080不够——ServerName也得同步更新，否则Apache启动时会报错或拒绝响应。

打开XAMPP\apache\conf\httpd.conf，找到这两处修改：

Listen 80 改成 Listen 80（保留原端口）、再新增 Listen 8080 和 Listen 8081
ServerName localhost:80 改为 ServerName localhost:80，再新增两行：ServerName localhost:8080 和 ServerName localhost:8081

不改ServerName会导致虚拟主机识别失败，浏览器访问:8080时可能直接跳转到XAMPP首页或返回404。

每个端口要对应独立的`DocumentRoot`和`Directory`权限配置

Z-Blog不是单入口程序，它依赖zb_users/cache等子目录写入权限。如果两个站点共用htdocs，缓存、插件、主题会互相污染；更糟的是，Directory权限没配对，会出现403或500错误。

在XAMPP\apache\conf\extra\httpd-vhosts.conf里添加两个<virtualhost></virtualhost>块：

<virtualhost>
    DocumentRoot "X:/XAMPP/htdocs/zblog-en"
    <directory>
        Require all granted
        AllowOverride All
    </directory></virtualhost><virtualhost>
    DocumentRoot "X:/XAMPP/htdocs/zblog-cn"
    <directory>
        Require all granted
        AllowOverride All
    </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

下载

路径中的盘符（如X:）必须和你实际安装路径一致，不能用C:写死后复制粘贴到D盘环境
Require all granted是Apache 2.4+必需项，漏掉就403；旧版Allow from all在XAMPP新版本中已失效
两个Z-Blog必须分别解压到zblog-en和zblog-cn这样的独立子目录，不能混放

数据库名、表前缀、`zb_system/config.php`三者必须一一对应

同一MySQL实例下跑多个Z-Blog，靠的不是端口隔离，而是数据库层面的区分。装第二个站点时，如果还用zblog库名+默认zbp_前缀，安装过程会提示“表已存在”，或者后台登录后文章全乱。

操作顺序不能错：

先用phpMyAdmin新建库zblog_en和zblog_cn，字符集选utf8mb4_unicode_ci
安装第一个站点时，在数据库配置页填库名zblog_en、表前缀留空或填en_
安装第二个站点时，库名填zblog_cn、表前缀填cn_（避免和第一个冲突）
装完立刻检查各自zb_system/config.php里的$zbp->option['ZC_DATABASE_NAME']和'ZC_TABLE_PREFIX'值是否匹配

常见错误：改了库名但忘了改config.php，导致后台打不开或前台显示空白页，错误日志里会出现Table 'zblog_cn.zbp_post' doesn't exist这类提示。

`zb_users`目录权限和`cache`清空时机容易被忽略

多端口部署后最隐蔽的问题，往往出在缓存和权限上。比如你在:8080站点后台更新了主题，:8081站点却还在用旧CSS——因为两个站点若共用zb_users/cache，缓存文件会互相覆盖。

正确做法是：

每个Z-Blog子目录下的zb_users必须是独立副本，不能硬链接或共享
Windows下右键zb_users → 属性 → 安全 → 编辑 → 给IIS_IUSRS或Everyone勾选“修改”权限（仅限开发环境）
Linux/macOS执行：chmod -R 755 zb_users，但zb_users/theme和zb_users/plugin若需上传，应补775
每次切换站点调试前，手动删掉对应zb_users/cache/*下的所有文件，避免旧缓存干扰