萌次元商城

萌次元商城系统基于异次元店铺系统3.0 全新重构，历时两年精心打磨，初心不改。我们采用纯原生PHP打造了一款极具潜力的个人创业型商城系统。数据库底层经过对hyperf/database 的深度优化，感谢hyperf开发团队提供的强大ORM组件。模版渲染引擎采用世界著名symfony团队开发的twig ，安全且高性能。以下为系统主要功能介绍，更多细节等待您亲自下载体验。

• 自主研发底层框架，支持多种部署环境：兼容FPM 和 CLI双架构，构建从零到一的纯原生底层框架，适用于虚拟主机、虚拟VPS和高性能云服务器，支持超大型负载均衡部署，能够处理百万级并发。
• 全新内容安全过滤系统：确保用户输入内容到数据库的安全性，不再强制过滤用户输入的HTML 代码（如分站公告、商品介绍等需要HTML展示的内容），保证100%安全过滤用户提交的内容。
• 全站API二进制加密通讯：使用AES加密，对所有API接口数据进行二进制加密传输，大幅提升数据传输的安全性和私密性。
• 插件系统 ：支持多种插件开发模式，包括控制器（API/VIEW）、管理菜单（后台/用户）、控制台命令（命令式插件开发）、进程（定时/后台任务等插件开发）、WebSocket（即时通讯类插件开发）、支付（支付插件开发）、货源（发货插件开发）、HOOK（页面/API钩子类插件开发）。
• 模板系统：提供高扩展性的模板HOOK，支持控制器（API/VIEW）开发，方便开发者快速构建高性能、功能强大的插件及模板。
• 国际化支持：完全支持i18n国际化，支持自定义显示国家货币及翻译内容。
• 丰富的用户角色设计：适用于构建小型个人创业商城、及中大型货源平台及第三方经销商网站，包含平台（主站）、供货商、商家（分站/经销商）、顾客（会员）等多种角色。
• 分站独立插件/模板：分站即主站，商家开通分站后，几乎拥有与主站相同的功能，可自主安装插件和模板，包括自定义支付接口，无需依赖主站的支付接口。
• 多样化的发货方式：通过安装不同的发货插件，如虚拟卡密、游戏账号、实体商品实时物流、游戏充值业务、账号充值业务等，满足各种业务需求。

环境要求

注意：CLI架构仅支持在Linux服务器上进行安装(支持多个网站部署)，不支持虚拟空间，如需要在虚拟空间或windows上进行安装，请选择FPM架构

安装程序之前，需要您服务器支持以下环境：

• Mysql >= 5.6
• Nginx（任意发行版）

开始安装

1. 将安装包，上传到你的服务器，并且解压出来，比如解压到：/www/wwwroot/mcy-shop目录
2. 进入解压出来的目录，执行SSH命令：cd /www/wwwroot/mcy-shop
3. 给主程序777权限，执行SSH命令：chmod 777 bin console.sh注意，这里必须是777权限，不要擅自修改权限
4. 准备开始安装，执行SSH命令：./bin index.php准备安装，**值得注意的是，SSH命令窗口是不能关闭的，如果你执行完这个命令后就关掉SSH窗口，那么你就等于关闭了安装程序 **
5. 根据SSH命令窗口中的提示，使用浏览器访问http://IP地址:端口进行安装，注意：如果访问不了，请检查防火墙是否放行对应端口
6. 根据安装完成后的网页提示（SSH命令窗口也会提示），拿到反向代理地址 然后开始配置Nginx反向代理，根据下方教程配置完成后，访问：http://你的域名/admin即可进入后台

注意，刚安装完成后立即访问首页会提示域名未绑定此时你已经成功安装，只需要进后台绑定主站域名，就可以访问首页了。

Nginx反向代理（宝塔例子）

1. 通过宝塔添加网站

2. 添加网站后，进入刚才你添加的网站的网站设置，找到反向代理点击添加反向代理

3. 增加https自动识别header到Nginx配置文件：proxy_set_header Scheme $scheme;

注意，通过宝塔申请SSL证书时，必须暂时关闭反向代理，申请成功后，再开启反向代理

迁移数据

当你将旧的网站迁移至新的服务器时，你需要看这个注意事项

• 数据库地址数据库账号数据库密码数据库名称数据库前缀均不能改变，需要在迁移数据库时，一比一迁移至新的服务器
• 原网站程序路径不可改变，比如你原来在程序在/www/wwwroot/shop这个路径下， 新的服务器中，也需要在此路径下

如果迁移未能达到预期，插件数据将无法迁移成功，但不会影响其他功能，仅对以下内容产生影响：插件状态 和 插件配置数据

当你完成了数据库以及程序文件的迁移，已经做好所有的工作后，按照下面的教程，完成最后的工作：

1. 通过cd命令进入到你的程序根目录，比如SSH命令例子cd /www/wwwroot/shop
2. 给程序赋予权限，执行SSH命令：chmod 777 bin console.sh
3. 安装MCY服务执行SSH命令：./console.sh service.install

完成所有工作后，检查你的域名解析以及反向代理，即可正常运作

卸载程序

在需要卸载的程序根目录执行：mcy service.uninstall

控制台指令

在程序根目录执行SSH命令：mcy可以查看指令菜单，如重启程序指令：mcy service.restart

V3数据迁移V4

1. 会员数据：mcy migration.v3.user test.sql其中test.sql是你V3的数据库文件，通过宝塔或者phpmyadmin 都可以备份此文件，如果是压缩包记得将.sql后缀的文件解压出来再进行导入。
2. 商品数据：需要自行安装V3.O货源插件，将自己网站的货源全部拉取到V4中，然后在货源管理中一键本地化即可。

环境要求

注意：FPM架构适合新手或学生、无服务器的人群使用，性能远不如CLI架构，但功能无差异，如有条件，请尽量选择CLI架构

安装程序之前，需要您服务器支持以下环境：

• PHP >= 8.1
• Mysql >= 5.6
• Nginx/Apache

注意，FPM架构支持全系统兼容，你可以将本系统安装在任意操作系统。

开始安装

如果使用过异次元(V3.0)版本的，下面步骤基本和之前一致，但是要值得注意的是伪静态规则不同。

1. 将安装包，上传到你的服务器，并且解压出来，然后给所有文件755权限，必须给权限，否则无法正常使用
2. 将Nginx重启或启动权限授权给PHP-FPM，在你的Linux 服务器任意地方执行此命令：sudo echo "www ALL=(ALL) NOPASSWD: /usr/bin/nginx" | sudo tee -a /etc/sudoers
   • 【虚拟主机/空间用户直接忽略此步骤】如果不需要开分站可以跳过此步骤
3. 【重要】将Composer执行权限授权给PHP-FPM ，注意，需要在你刚才解压出来的程序根目录执行此命令：sudo echo "www ALL=(ALL) NOPASSWD: $(pwd)/bin" | sudo tee -a /etc/sudoers ，重要的事情再讲一遍：这个命令需要在我们的程序根目录执行，怎么判断是不是我们的程序根目录，只要这个根目录下面有个bin 文件，此文件没有任何后缀，代表你已经到达程序根目录。
   • 【虚拟主机/空间用户直接忽略此步骤】此步骤是为了完成安装极少部分需Composer依赖的插件，就算你不完成此步骤，在启动插件的时候，缺少依赖，也会告诉你手动安装插件依赖的方法
4. 通过Nginx创建网站（如宝塔这样的可视化服务器面板可实现一键建网站），然后将目录指向你解压出来的目录
5. 设置伪静态规则
   • Nginx 伪静态规则：

     if ( $uri ~ "^/(LICENSE|README.md|config|kernel|runtime|vendor)" ) {
         return 404;
     }
     location / {
         if (!-e $request_filename){
             rewrite  ^(.*)$  /index.php?_route=  last;   break;
         }
     }

   • Apache 伪静态规则：无需配置，Apache会自动读取根目录.htaccess文件
6. 访问你的网址，进行安装，安装完成后，访问：http://你的域名/admin，即可进入后台。

注意，刚安装完成后立即访问首页会提示域名未绑定，此时你已经成功安装，只需要进后台绑定主站域名，就可以访问首页了。

迁移数据

当你将旧的网站迁移至新的服务器时，你需要看这个注意事项

• 数据库地址数据库账号数据库密码数据库名称数据库前缀，均不能改变，需要在迁移数据库时，一比一迁移至新的服务器
• 原网站程序路径不可改变，比如你原来在程序在/www/wwwroot/shop这个路径下， 新的服务器中，也需要在此路径下

如果迁移未能达到预期，插件数据将无法迁移成功，但不会影响其他功能，仅对以下内容产生影响：插件状态 和 插件配置数据

当你完成了数据库以及程序文件的迁移，已经做好所有的工作后，按照下面的教程，完成最后的工作：

1. 通过cd命令进入到你的程序根目录，比如(SSH命令例子)：cd /www/wwwroot/shop
2. 【分站独立域名功能】赋予Nginx重启权限，执行SSH命令：sudo echo "www ALL=(ALL) NOPASSWD: /usr/bin/nginx" | sudo tee -a /etc/sudoers
3. 【重要】将Composer执行权限授权给PHP-FPM ，执行SSH命令：sudo echo "www ALL=(ALL) NOPASSWD: $(pwd)/bin" | sudo tee -a /etc/sudoers ，重要的事情再讲一遍：这个命令需要在我们的程序根目录执行，怎么判断是不是我们的程序根目录，只要这个根目录下面有个bin

完成所有工作后，检查你的域名解析是否正常，即可正常运作