教程02-微擎框架的介绍_eweishop 文档

微擎是一个PHP开发的公众号、微信小程序、支付宝小程序、熊掌号、PC建站和服务端管理的开源的管理系统，基于当前最稳定的WEB2.0系统（php+mysql）。

推荐系统环境：PHP5.6-PHP7.2+MySQL5.5-5.7

安装微擎需要Linux系统，公共镜像，CentOS 7.0以上的64位操作系统。开发测试学习可以使用windows及相关环境套件。

目录介绍

weiqing
├─ addons                                   插件安装目录(意为附加组件)
│  ├─ eweishop                              插件模块的名称(示例)
│  │  ├─ images                             建议 css 文件也放此目录.
│  │  ├─ template                           模板目录
│  │  │  ├─ mobile                          APP 端模板目录
│  │  │  │  └─ ... *.html                   APP 端模板文件
│  │  │  └─ ... *.html                      Web 端模板文件
│  │  ├─ inc                                引用的 php 文件目录（或者core文件夹）
│  │  │  ├─ mobile                          Mobile端目录
│  │  │  │  ├─ xxx.inc.php                  微站入口
│  │  │  │  └─ ...                          .
│  │  │  └─ web                             Web端模板目录
│  │  │      ├─ xxx.inc.php                 微站管理入口
│  │  │      └─ ...                         .
│  │  ├─ icon.jpg                           模块图标
│  │  ├─ preview.jpg                        模块预览
│  │  ├─ manifest.xml                       安装清单
│  │  ├─ module.php                         模块设置
│  │  ├─ processor.php                      消息处理
│  │  ├─ receiver.php                       消息订阅
│  │  ├─ webapp.php                         PC版页面功能
│  │  ├─ wxapp.php                          小程序接口功能
│  │  ├─ hook.php                           嵌入点
│  │  └─ site.php                           微站页面
│  └─ ...                                   其他扩展模块
├─ api                                      .
│  └─ accesstoken.php                        多系统共用accesstoken接口
├─ attachment                               附件文件夹
│  ├─ audios                                音频附件文件夹
│  └─ images                                图片附件文件夹
│      ├─ global                            系统公共文件夹
│      │  └─ 上传年份
│      │        └─上传月份
│      │             └─ 随机文件名
│      └─ $uniacid ...                      按公众号年月组织的图片文件
├─ app                                      微站(Mobile)入口
│  ├─ common                                .
│  │  ├─ bootstrap.app.inc.php              初始加载函数和常量
│  │  ├─ common.func.php                    公共函数
│  │  └─ template.func.php                  模板系统函数
│  │  └─ tpl.func.php                       页面常用模板插件函数
│  ├─ resource                              微站资源文件
│  │  ├─ css                                样式文件
│  │  ├─ fonts                              字体资源
│  │  └─ js                                 .
│  ├─ source                                控制器
│  ├─ themes                                微站皮肤
│  │  ├─ default                            系统默认
│  │  └─ ...                                自定义皮肤
│  └─ index.php                             微站入口
├─ data                                     .
│  ├─ config.php                            系统配置
│  └─ db.php                                .
├─ framework                                微擎系统通用的工具类和方法
│  ├─ builtin                               微擎内建模块
│  │  ├─ basic                              文字回复模块
│  │  ├─ core                               会话消息统计
│  │  │  └─ receiver.php                    .
│  │  ├─ cover                              通用封面回复
│  │  ├─ default                            默认回复模块
│  │  ├─ music                              音乐回复模块
│  │  ├─ news                               图文回复模块
│  │  ├─ userapi                            自定义接口回复模块
│  │  └─ ...                                .
│  ├─ class                                 系统功能类                            .
│  ├─ function                              系统功能函数
│  ├─ library                               其他函数库
│  ├─ model                                 业务功能model
│  ├─ table                                 数据库表model
│  ├─ bootstrap.inc.php                     .
│  ├─ const.inc.php                         .
│  └─ version.inc.php                       .
├─ payment                                  支付
├─ web                                      后台管理(Web)入口
│  ├─ common                                公用文件 
│  │  ├─ bootstrap.sys.inc.php              .
│  │  ├─ common.func.php                    .
│  │  ├─ frames.inc.php                     .
│  │  └─ permission.func.php                .
│  │  └─ template.func.php                  .
│  │  └─ tpl.func.php                       .
│  ├─ resource                              资源文件
│  │  ├─ components                         JS组件
│  │  ├─ css                                样式文件
│  │  ├─ fonts                              字体资源
│  │  ├─ home                               后台客户端资源文件
│  │  ├─ images                             图片文件
│  │  └─ js                                 .
│  │      ├─ app                            系统js功能
│  │      ├─ lib                            js第三方库文件
│  │      └─ require.js                     .
│  ├─ source                                后台管理控制器
│  ├─ themes                                后台管理视图
│  │  ├─ default                            内建后台管理样式
│  │  └─ ...                                定制界面样式
│  └─ index.php                             后台入口
├─ api.php                                  公众平台与微擎系统通信的接口
├─ index.php                                微擎入口
└─ install.php                              微擎安装程序

入口脚本

脚本是应用启动流程中的第一环，入口文件根据“系统配置文件”初始化了系统的持续性、入口启动及整体对象，标记终端用户的请求通过脚本将请求浏览到各自的功能模块中。
微擎系统中分为三个入口，分别为“ Web端入口”、“ App端入口”、“微信Api入口”

系统配置文件

系统配置文件举行重要微擎系统的启动数据，文件是“/data/config.php”。此文件禁止普通用户修改。

网页端入口

Web端入口主要功能重微擎系统的后台管理，入口文件是“/web/index.php”。访问此入口有严格的权限判断，需要用户进行登录。此入口主要完成以下工作：

• 登录用户的身份验证
• 初始化登录用户的身份信息，分派管理员权限
• 权限菜单划分及权限判断
• 加载系统配置
• 语音用户的请求

应用端入口

App端入口主要重点微启动系统的前端“微站”、“个人中心”及其他普通用户访问的功能。入口文件为“/app/index.php”。访问“微站”无需身份验证，访问“此入口主要完成以下工作：

• 初始化当前公众号的数据
• 初始化微站站点信息、风格、模板、导航等数据
• 初始化粉丝&会员的身份信息（如果有权限获取）
• 加载系统配置
• 语音用户的请求

微信API入口

微信Api入口主要重处理微信公众平台请求微擎系统的关键字、图片、语音等数据，入口文件为“api.php”。此入口仅用于公众平台访问。此入口完成以下工作：

• 初始化当前公众号的数据
• 解析公共平台发送过来的数据结构，转化为微擎消息结构
• 可知消息结构中的关键字事件匹配到相应的模块
• 调用模块的处理器类返回数据给微信公共平台