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

xampp 默认端口冲突因apache（80/443）和mysql（3306）常被iis、docker、skype等占用，导致启动失败；需改apache为8080/8888、mysql为3307/3308，并同步更新phpmyadmin、php连接、.env及thinkphp的server_port或app_url配置。

xampp环境下多端口部署niushop

为什么 XAMPP 默认端口会冲突，必须改？

因为 XAMPP 启动时默认占用 80（Apache）和 3306（MySQL），而本地可能已运行 IIS、Docker、其他 PHPStudy 实例或系统服务（如 Skype 会抢 80）。直接启动常报错：Address already in use: AH00072: make_sock: could not bind to address [::]:80 或 MySQL 启动失败。不改端口，Niushop 根本跑不起来。

实操建议：

Apache 端口改为 8080 或 8888（避免与宝塔面板默认端口撞车）
MySQL 端口改为 3307 或 3308（尤其当你同时用宝塔或 Docker 运行 MySQL 时）
改完后务必重启 Apache 和 MySQL 服务，否则配置不生效

如何在 XAMPP 中修改 Niushop 的多端口访问配置？

Niushop 本身不内置“多端口部署”逻辑，它依赖 Web 服务器路由。所谓“多端口部署”，本质是让同一台机器上多个 Niushop 实例（比如测试版、正式版、插件开发版）通过不同端口隔离运行。关键不是改 Niushop 代码，而是配好 Apache 虚拟主机 + 端口监听。

实操步骤：

编辑 /opt/lampp/etc/httpd.conf（Linux）或 XAMPP\apache\conf\httpd.conf（Windows），取消注释 Include etc/extra/httpd-vhosts.conf

打开 httpd-vhosts.conf，添加两个监听段：

<virtualhost>
    DocumentRoot "/opt/lampp/htdocs/niushop-test"
    ServerName localhost:8080
</virtualhost><virtualhost>
    DocumentRoot "/opt/lampp/htdocs/niushop-prod"
    ServerName localhost:8081
</virtualhost>

在 httpd.conf 中确认已启用监听：Listen 8080 和 Listen 8081
Niushop 的 .env 或数据库配置中，APP_URL 和后台图片路径等需对应写成 http://localhost:8080，否则资源 404 或跳转错乱

PHP 配置要同步改端口吗？

不用改 PHP 本身，但 Niushop 的数据库连接、Redis、CURL 请求等依赖环境变量或配置文件的地方，容易漏掉端口适配。

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

下载

重点检查：

.env 中的 DB_PORT=3307（必须和你改的 MySQL 端口一致）
config/database.php 中 'port' => env('DB_PORT', '3306') —— 如果没读取 .env，这里硬编码了 3306 就会连不上
若启用了 Redis 缓存，config/cache.php 和 config/database.php 中的 Redis host/port 也要核对，XAMPP 不自带 Redis，得单独装或换为 file 缓存
ThinkPHP6 的命令行执行（如 php think queue:work）也走相同 DB 配置，端口错会导致队列卡死

为什么改了端口，Niushop 后台登录后跳转回 `:80`？

这是最典型的坑：Niushop（基于 ThinkPHP6）在生成 URL 时，默认从 $_SERVER['HTTP_HOST'] 和 $_SERVER['SERVER_PORT'] 推断当前地址。XAMPP 在非标准端口下，SERVER_PORT 常被忽略或误判为 80，导致重定向、图片路径、AJAX 请求全指向 http://localhost 而非 http://localhost:8080。

解决方法只有两个：

在 public/index.php 顶部强制设置：

$_SERVER['SERVER_PORT'] = 8080;
$_SERVER['HTTP_HOST'] = 'localhost:8080';

或更稳妥地，在 .env 中设 APP_URL=http://localhost:8080，并确保所有 URL 构建都走 url() 辅助函数（Niushop V5.5.0 已基本遵循此规范）

不处理这个，前端 JS 报 CORS、上传失败、菜单点击 404，问题会分散且难定位。

XAMPP环境下多端口部署Niushop

为什么 XAMPP 默认端口会冲突，必须改？

如何在 XAMPP 中修改 Niushop 的多端口访问配置？

PHP 配置要同步改端口吗？

为什么改了端口，Niushop 后台登录后跳转回 :80？

为什么改了端口，Niushop 后台登录后跳转回 `:80`？