讲师中心 微信公众号
AI工具推荐 视频效率加速

XAMPP环境下多端口部署Subrion CMS

轻墨同学_9825

轻墨同学_9825

发布时间:2026-05-05 17:08:59

|

272人浏览过

|

来源于php中文网

原创

XAMPP默认不支持Subrion的.htaccess重写规则,必须启用mod_rewrite并配置AllowOverride All,否则因重写失效导致安装页卡住、/admin等路径404或500错误。

xampp环境下多端口部署subrion cms

直接说结论:XAMPP 默认不支持 Subrion 的 .htaccess 重写规则,仅靠开多个端口无法让 Subrion 正常运行;必须启用 mod_rewrite 并正确配置 AllowOverride All,否则会卡在安装页或出现 404/500 错误。

为什么 Subrion 在 XAMPP 多端口下总跳转失败或报 404

Subrion 依赖 Apache 的 URL 重写(mod_rewrite)实现友好路径(如 /admin、/listing/123),而 XAMPP 默认关闭了虚拟主机目录的重写权限。即使你为 localhost:8080 和 localhost:8081 分别配了 <virtualhost></virtualhost>,只要 <directory></directory> 块里没放开 AllowOverride,.htaccess 就被无视——所有非 index.php 请求都会 404。

  • 常见现象:打开 http://subrion.test/admin 显示 404,但 http://subrion.test/index.php/admin 能进后台
  • 根本原因:XAMPP 的 httpd.conf 默认全局设了 AllowOverride None,且 httpd-vhosts.conf 里未覆盖
  • Subrion 安装检测页也会因重写不可用而提示 “Rewrite module is not enabled”

配置多端口 + Subrion 必须改的三处位置

不能只动 httpd-vhosts.conf。以下三处缺一不可,顺序也不能错:

BCMS Content
BCMS Content

通过命令行运行 BCMS 内容操作。一个轻薄的 CLI(封装官方 @thebcms/client SDK),供代理创建、更新、删除和列出条目。

下载
  • 确认 httpd.conf 已加载虚拟主机配置:
    找到 #Include conf/extra/httpd-vhosts.conf,删掉开头的 #
  • 确认 mod_rewrite 已启用:
    在 httpd.conf 中搜索 mod_rewrite.so,确保该行未被注释(即不是 #LoadModule rewrite_module modules/mod_rewrite.so)
  • 在 httpd-vhosts.conf 每个 <virtualhost></virtualhost> 块内,<directory></directory> 部分必须包含:
    AllowOverride All
    Require all granted
    (注意:不要写 Order Deny,Allow 这类旧语法,XAMPP 5.6+ 默认用 Require)

端口选择与 Subrion 实际部署示例

Subrion 推荐用域名访问(如 subrion.test),但若坚持用端口(比如调试两个不同版本),请避开 80/443/8080 这些易冲突端口,选 8082、8083 等,并确保 Windows 防火墙放行。

  • 在 httpd.conf 添加监听:
    Listen 8082
    Listen 8083
  • 在 httpd-vhosts.conf 添加对应块(以 8082 为例):
    <VirtualHost *:8082>
        ServerName localhost
        DocumentRoot "C:/xampp/htdocs/subrion-v4"
        <Directory "C:/xampp/htdocs/subrion-v4">
            Options Indexes FollowSymLinks
            AllowOverride All
            Require all granted
        </Directory>
    </VirtualHost>
  • Subrion 的 config.php 中,$config['url'] 应设为 http://localhost:8082/,否则后台链接仍走 80 端口

容易被忽略的 Subrion 权限与 PHP 扩展问题

即使 Apache 配置全对,Subrion 仍可能卡在安装页或上传失败——这不是端口的事,而是环境缺失:

  • PHP 扩展必须启用:gd、mbstring、xml、curl(XAMPP 默认开了前三个,curl 需手动取消 php.ini 中 ;extension=curl 的注释)
  • Windows 下 Subrion 的 cache/、uploads/ 目录需有写权限(右键文件夹 → 属性 → 安全 → 编辑 → 给 Users 组“修改”权限)
  • 若用 subrion.test 域名而非端口,hosts 文件必须加 127.0.0.1 subrion.test,且浏览器要清 DNS 缓存(chrome://net-internals/#dns → Clear host cache)

端口只是路由入口,Subrion 的真实瓶颈永远在重写能力、PHP 扩展和目录权限这三块。配完多端口后第一件事,不是打开浏览器,而是运行 xampp/apache/bin/httpd.exe -t 检查配置语法,再看 Apache error.log 里有没有 mod_rewrite 相关报错——这才是最常被跳过的验证动作。

热门AI工具

更多
二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

11464

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

6621

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2175

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

4208

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

4914

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

3851

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

5557

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4342

2023.11.13

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

60

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn