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

xampp 能运行 peepso，但多端口部署易致白屏、404、ajax 失败等；根本原因是 peepso 强依赖 wp_home/wp_siteurl，而 apache 多端口下 host 头与协议判断失准，需同步配置 wp-config.php 常量、virtualhost servername 和数据库 siteurl/home 值。

xampp环境下多端口部署peepso

直接说结论：XAMPP 能跑 PeepSo，但用多端口方式部署（比如 http://localhost:8080 和 http://localhost:8081）极易触发 WordPress 核心的重定向逻辑或 URL 生成异常，导致后台白屏、AJAX 失败、资源 404 或登录循环——这不是配置遗漏，而是 PeepSo 对 WP_HOME/WP_SITEURL 的强依赖和 Apache 多端口下 Host 头/协议判断失准共同导致的。

为什么 PeepSo 在多端口下容易出 500/404/白屏

PeepSo 是重度依赖 WordPress 网站地址（siteurl 和 home）的插件，它在生成前端路由、API 路径、WebSocket 连接、图片上传路径时，全部基于数据库里的 wp_options 值或 WP_HOME 常量。当你用不同端口访问时：

Apache 的 VirtualHost *:8080 并不会自动改写 PHP 的 $_SERVER['HTTP_HOST'] 为 localhost:8080，而 WordPress 默认只从 $_SERVER['HTTP_HOST'] + $_SERVER['REQUEST_URI'] 构建完整 URL，不带端口
如果数据库里 siteurl 是 http://localhost（默认值），那么 PeepSo 生成的 JS 加载地址就是 http://localhost/wp-content/plugins/peepso/...，浏览器会忽略端口直接请求 :80，结果 404
PeepSo 的 AJAX 接口（如 /wp-admin/admin-ajax.php）被硬编码进 JS，若当前页是 localhost:8081 但 JS 请求发往 localhost（无端口），就会跨端口失败，触发 CORS 或 403
某些 PeepSo 功能（如实时通知、视频通话）会尝试建立 WebSocket 连接，而 ws://localhost/... 无法匹配 localhost:8081，直接断连

必须修改的三个关键位置

要让 PeepSo 在非标准端口下工作，以下三处缺一不可，且顺序不能错：

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

下载

在 wp-config.php 顶部（define('ABSPATH', ...) 之前）强制定义常量：

define('WP_HOME', 'http://localhost:8080');<br>define('WP_SITEURL', 'http://localhost:8080');

确保 httpd-vhosts.conf 中每个 <virtualhost></virtualhost> 块内，ServerName 明确写成 localhost:8080（不是仅 localhost），否则 Apache 不会把该端口的 Host 头正确传给 PHP
检查 MySQL 数据库中 wp_options 表的 siteurl 和 home 字段值，必须与上面两个常量完全一致；如果已安装过 PeepSo，建议先清空 wp_options 中所有 peepso_% 开头的缓存行（如 peepso_cache），避免旧 URL 残留

比多端口更稳的替代方案

如果你只是想并行开发/测试多个 PeepSo 实例（比如中日双语版），多端口不是最优解。推荐用域名+单端口方式，更贴近生产环境且规避绝大多数 URL 问题：

在系统 C:\Windows\System32\drivers\etc\hosts 中添加两行：
127.0.0.1 cn.peepso.test
127.0.0.1 jp.peepso.test
在 httpd-vhosts.conf 中配两个 <virtualhost></virtualhost>，分别绑定不同 DocumentRoot 和 ServerName cn.peepso.test / jp.peepso.test
每个站点的 wp-config.php 单独设 WP_HOME，例如 cn.peepso.test 对应 http://cn.peepso.test
这样所有 PeepSo 内部链接、资源路径、AJAX 目标都天然带正确域名，无需额外 hack

多端口配置本身不难，难的是让 WordPress 生态（尤其是 PeepSo 这类深度集成插件）接受“同一域名不同端口=不同站点”这个事实。它本质上是把 HTTP 层的端口差异，强行映射到应用层的站点隔离，而 PeepSo 并未为此做适配。真要压测或调试，优先走域名方案；非要端口，务必逐项核对 WP_HOME、ServerName、数据库值三者是否严格一致——漏掉任何一个，都会在某个看似无关的交互点上突然崩掉。