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

xampp环境下多端口部署shopnc

直接说结论：XAMPP 下用多端口部署多个 ShopNC 实例完全可行，但必须手动配置 Apache 端口监听 + 虚拟主机 + hosts 映射，且每个实例的 DocumentRoot 和 ServerName 必须严格隔离；否则会出现 403、空白页或数据库连接复用错误。

Listen 指令必须显式添加多个端口

Apache 默认只监听 80，不加声明就不会响应 :8080 或 :8081 请求。光改 httpd-vhosts.conf 没用。

打开 C:\xampp\apache\conf\httpd.conf
在已有 Listen 80 行下方，**逐行添加**（不能写成 Listen 8080 8081）：
Listen 8080
Listen 8081
确保没有重复 Listen 行，否则 Apache 启动失败，XAMPP 控制面板显示 “Apache shutdown unexpectedly”

每个 ShopNC 实例需独立 `<virtualhost></virtualhost>` 块

ShopNC 依赖 .htaccess 和 URL 重写（如商品详情页 /goods-123.html），所以 AllowOverride All 和 Require all granted 是硬性要求；漏掉任一者，访问首页就 500 或 403。

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

下载

编辑 C:\xampp\apache\conf\extra\httpd-vhosts.conf

为每个 ShopNC 实例写一个完整块，例如：

<virtualhost><br>    ServerName shopnc-a.test<br>    DocumentRoot "C:/xampp/htdocs/shopnc_a"<br><directory><br>        Options Indexes FollowSymLinks<br>        AllowOverride All<br>        Require all granted<br></directory><br></virtualhost>

DocumentRoot 必须是绝对路径，结尾**不能有斜杠**；ServerName 必须和后续 hosts 文件里写的域名完全一致（大小写敏感）
不要复用同一个 ServerName 绑多个端口——Apache 不支持，会取第一个匹配项

Windows hosts 文件必须为每个端口配独立域名

浏览器不认 localhost:8080 这种带端口的“域名”，它只是 IP+端口组合；而 ShopNC 的伪静态规则、后台登录跳转、图片资源路径都基于完整域名生成，所以必须用真实域名（哪怕只是本地解析）。

以管理员身份用记事本打开 C:\Windows\System32\drivers\etc\hosts
追加对应行（IP 固定用 127.0.0.1，别写 localhost）：
127.0.0.1 shopnc-a.test
127.0.0.1 shopnc-b.test
保存后无需重启系统，但 Chrome/Firefox 可能缓存 DNS，建议用无痕窗口测试，或运行 ipconfig /flushdns
如果仍打不开，检查是否误把 shopnc-a.test 写成 shopnc-a.test:8080 —— hosts 里**不能带端口**

ShopNC 自身配置要避开端口冲突和 session 混淆

ShopNC 的 data/config/config.php 里有 BASE_URL 和 COOKIE_DOMAIN，若多个实例共用同一套配置或没清理缓存，会导致登录态串、JS/CSS 404、后台跳转错乱。

每个 ShopNC 实例解压后，必须单独修改 data/config/config.php：
'base_url' => 'http://shopnc-a.test/',
'cookie_domain' => '.shopnc-a.test',
安装完成后，清空 data/cache/ 下所有文件（尤其是 system_cache.php），否则旧配置残留
MySQL 数据库名、表前缀必须不同（如 shopnc_a_ 和 shopnc_b_），否则两个后台操作会互相覆盖数据
PHP session 默认存在 C:\xampp\tmp，多个实例共享该目录易出错；可为每个实例在 php.ini 中设独立 session.save_path，但更简单做法是：确保各实例用不同浏览器或无痕窗口访问

最易被忽略的是：改完所有配置后，一定要先运行 httpd -t（在 C:\xampp\apache\bin 目录下执行）验证语法，再点 XAMPP 控制面板里的 Start。Apache 配置错一条，服务就起不来，而错误日志（C:\xampp\apache\logs\error.log）里第一行通常就是真正原因。