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

winter cms 多实例需用端口隔离+虚拟主机：启用httpd-vhosts.conf、为各端口配独立virtualhost指向public目录、保持rewritebase/、php扩展启用、数据库及权限独立配置。

xampp环境下多端口部署winter cms

Winter CMS 是基于 Laravel 的轻量级 CMS，部署在 XAMPP 上时，若需多端口运行多个实例（比如开发、测试、预发环境隔离），不能只靠改 htdocs 子目录——它依赖 Laravel 的路由和 PHP 环境配置，对 Apache 的虚拟主机与端口监听有明确要求。直接放多个 Winter CMS 到不同子目录下、用 localhost:8080/winter1 这种路径访问，大概率会触发 404 或路由错乱，因为其 public/index.php 是入口，且重写规则（.htaccess）默认只适配根路径。

必须开启 httpd-vhosts.conf 并启用 NameVirtualHost

XAMPP 默认不启用虚拟主机配置，即使你改了 httpd.conf 中的 Include conf/extra/httpd-vhosts.conf，也得确认两件事： - httpd-vhosts.conf 文件里没有被注释掉的 NameVirtualHost *:80（新版 Apache 2.4+ 已废弃该指令，但 XAMPP 7.x 及以下仍依赖它） - 若你新增了 Listen 8080，对应也要加 NameVirtualHost *:8080，否则 Apache 不会把该端口的请求交由 <virtualhost></virtualhost> 处理

常见错误现象：浏览器访问 @#@#@#@#@#@#@#@#@#@0 直接跳转到 XAMPP 默认页，或返回 403 Forbidden
解决办法是检查 httpd-vhosts.conf 开头是否包含：

NameVirtualHost *:80
NameVirtualHost *:8080
NameVirtualHost *:8081

然后每个端口配一个独立 <virtualhost></virtualhost> 块，且 DocumentRoot 必须指向对应 Winter CMS 的 public/ 目录，不是项目根目录。

每个 Winter CMS 实例必须独立 DocumentRoot + RewriteBase

Winter CMS 的 .htaccess 文件在 public/ 下，默认 RewriteBase /。如果强行用子路径（如 localhost:8080/winter-test）而不改这个值，所有静态资源和路由都会 404。

正确做法是：

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

下载

每个实例单独建文件夹，例如：D:/xampp/htdocs/winter-dev、D:/xampp/htdocs/winter-staging

在 httpd-vhosts.conf 中为每个端口指定完整路径：

<virtualhost>
  DocumentRoot "D:/xampp/htdocs/winter-dev/public"
  ServerName localhost
  <directory>
      AllowOverride All
      Require all granted
  </directory></virtualhost>

确保每个 public/.htaccess 里的 RewriteBase 保持为 /（因为它是根访问）

若你坚持用子路径而非端口隔离，就必须手动修改每个 .htaccess 的 RewriteBase /winter-dev/，并同步调整 config/app.php 中的 'url' 和 public/index.php 的 require <strong>DIR</strong>.'/../bootstrap/autoload.php'; 路径——这极易出错，不推荐。

PHP 扩展与权限问题常被忽略

Winter CMS 依赖 mbstring、openssl、gd、curl 和 xml 扩展，XAMPP 自带的 PHP 通常已启用，但： - 若你升级过 XAMPP 或手动替换了 PHP 版本，需检查 php.ini 中这些扩展是否取消了分号注释 - Windows 下若 public/ 目录权限被继承限制（尤其从 ZIP 解压后），Apache 可能无法读取 .env 或写入 storage/，表现是安装页卡住、后台无法上传图片、报错 file_put_contents(): failed to open stream: Permission denied - 解决方法：右键 public 和 storage 文件夹 → 属性 → 安全 → 编辑 → 添加 Everyone 或 IIS_IUSRS（取决于 Apache 运行用户），赋予“修改”权限

数据库配置必须按实例隔离

Winter CMS 的 .env 文件中，DB_DATABASE、DB_USERNAME、DB_PASSWORD 必须为每个实例单独设置，不能共用同一个库名： - 推荐方式：用 phpMyAdmin 为每个 Winter CMS 创建独立数据库（如 winter_dev、winter_staging） - .env 中不要留空密码字段，哪怕本地开发也显式写 DB_PASSWORD=（XAMPP 默认 root 密码为空，但 Laravel 会把空字符串当 null 处理，导致连接失败） - 若改过 MySQL 端口（如 3307），还需在 .env 中加 DB_PORT=3307

Windows 下最容易被忽略的一点：XAMPP 控制面板启动 Apache 后，它默认以服务方式运行，而服务账户（Local System）对某些用户目录（如 C:\Users\XXX\ 下的项目）无读取权限。所以 Winter CMS 最好放在 D:/xampp/htdocs/ 下，而不是桌面或文档路径。