XAMPP环境下多端口部署CmsWing

XAMPP环境下多端口部署CmsWing

XAMPP默认仅监听80端口，需手动在httpd.conf中添加Listen指令（如Listen 8080）并配置httpd-vhosts.conf中的VirtualHost，同时启用AllowOverride All及Require all granted，才能使CMSWing等多站点共存。

开门见山地说，想让CMSWing在XAMPP里和其他站点和平共处，核心就一点：必须手动为它开个专属通道。XAMPP默认只认80端口，不额外配置的话，所有指向其他端口的请求都会被Apache直接挡在门外——结果不是404找不到，就是403没权限，甚至连接都会被拒绝。

修改 httpd.conf 添加监听端口

Apache可不会猜你想用什么端口，得明确告诉它。找到你的D:\xampp\apache\conf\httpd.conf文件（安装路径不同请自行调整），定位到Listen 80这一行，在下面为CMSWing新增一个监听端口，比如常用的8080：

Listen 80
Listen 8080

这里有个细节需要注意：8080端口虽然常用，但如果你的电脑上已经运行了Docker、VS Code Server之类的服务，最好先用命令netstat -ano | findstr :8080检查一下端口是否被占用。另外，在Windows系统里，使用1024以下的端口（像80、443）需要管理员权限，非必要就别去折腾了。

• 切记保留Listen 80：这一行要是删了，XAMPP的控制面板首页（http://localhost）可就打不开了。
• 端口单独成行：每个端口写一行，别图省事写成Listen 80, 8080，Apache不认这种格式。
• 先别急着重启：改完保存就好，等会儿把虚拟主机配置也搞定后，再统一重启Apache，效率更高。

启用并编辑 httpd-vhosts.conf

接下来是虚拟主机配置。XAMPP默认把这部分功能注释掉了。打开D:\xampp\apache\conf\extra\httpd-vhosts.conf文件，首先确保文件顶部这行指令前面的注释符号（#）已经被去掉：

Include conf/extra/httpd-vhosts.conf

确认启用后，在文件末尾为CMSWing添加一个专属的虚拟主机配置块：

    DocumentRoot "D:/xampp/htdocs/cmswing"
    ServerName localhost:8080
    
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    

几个关键配置，一个都马虎不得：

• DocumentRoot路径要写全：这里必须指向CMSWing项目文件夹的完整绝对路径。如果你把它解压到了htdocs下的cmswing文件夹里，路径就得写完整。
• ServerName的用意：这里写localhost:8080是为了和访问地址匹配。当然，如果你后期想用cmswing.test这样的自定义域名来访问，这里就改成域名，同时别忘了去修改系统的hosts文件。
• 权限写法别搞错：Require all granted是Apache 2.4及以上版本的标配。如果你参考了一些老教程，里面写的Allow from all在新版本里会直接导致500内部服务器错误。

检查 hosts 文件和目录权限

在兴冲冲地打开浏览器输入http://localhost:8080之前，还有两件“小事”必须确认：

• 检查hosts文件：用管理员身份运行记事本，打开C:\Windows\System32\drivers\etc\hosts，确保里面有127.0.0.1 localhost这一行。XAMPP安装后通常会自带，但保不齐哪天就被杀毒软件给“优化”掉了。
• 规避路径陷阱：存放CMSWing的目录路径里，千万不要出现中文或空格。否则，Apache很可能无法正确加载.htaccess文件，导致各种路由解析失败。
• 遇到403怎么办：如果访问时蹦出403 Forbidden错误，十有八九是虚拟主机配置里区块漏掉了Require all granted，或者Apache根本没加载到你的虚拟主机配置文件（回去检查httpd.conf里Include那行是否生效了）。

最后，也是最重要的一步：所有文件修改完毕后，务必通过XAMPP控制面板先完全停止Apache服务，然后再启动。简单的重启按钮可能无法让所有配置生效。

CMSWing 特有的 .htaccess 兼容问题

CMSWing这类框架通常依赖.htaccess文件来实现URL重写（比如让后台地址/admin能正常访问），但XAMPP默认是关闭这个功能的。我们需要再次打开httpd.conf文件，搜索AllowOverride，找到类似下面这段配置：

    Options Indexes FollowSymLinks Includes ExecCGI
    AllowOverride None
    Require all granted

把其中的AllowOverride None改成AllowOverride All。不改的话，就算前面虚拟主机配得再完美，CMSWing的后台路由照样会报404错误。

不过，这个设置是全局生效的。如果你的htdocs目录下还运行着其他老项目，它们的.htaccess规则也会被激活，有可能引起冲突。如果真遇到这种情况，就别偷懒了，更稳妥的做法是为CMSWing的目录单独配置一个块，实现精准控制。