YiiFrame4框架
一、定位与理念
YiiFrame4采用Bootstrap4+adminlte3+yii2,基于 RageFrame 快速开发引擎,为「办公场景」而生的通用后台快速开发框架,采用「插件 + 模块 + 多入口」的微核架构,面向CMS、CRM、ERP、OA、电子商务、门户网站、社区等大型业务系统,可一键生成前后端代码、接口文档和插件包,真正做到「不写重复代码,只关注业务」。
二、核心特色
插件化微核
- 功能即插件,可独立安装/卸载/升级,不影响核心;
- 官方提供插件市场,支持在线一键更新。
多入口隔离
-Backend(总后台)
-Merchant(企业端/SaaS 子后台)
-Frontend(PC 前端)
-Html5(移动端)
-Console(定时任务)
-Api(内部接口)
-OAuth2 Server(开放接口)
-MerApi(企业接口)
各入口独立模块、独立主题、独立路由,代码隔离清晰。
一键生成代码
- 选择数据表 → 绑定表单控件 → 自动生成 Model + CRUD + API + 路由 + 菜单 + 权限节点;
- 表单控件(日期、上传、省市、富文本、经纬度等)勾选即用,无需手写视图。
企业级 RBAC
- 无限层级父子权限组;
- 按钮、链接、插件、字段级细粒度控制;
- 支持数据权限(按部门、按企业隔离)。
前后端分离友好
- 内置 RESTful 规范 + OAuth2 Server;
- 自动生成 Swagger/OpenAPI 文档;
- 提供 Uni-App 前端模板(一套代码编译到 H5、小程序、App)。
云存储一键切换
- 本地、阿里云 OSS、腾讯云 COS、七牛等通过配置切换;
- 统一 Flysystem 接口,新增存储只需写 1 个驱动类。
工作流引擎
- 可视化设计流程;
- 支持条件分支、表单权限;
- 与审批记录、消息、钉钉/企微提醒打通。
监控与日志
- 异常自动进数据库,可钉钉实时推送;
- 队列、Redis、SQL、内存占用一目了然。
三、技术栈
| 层级 | 选型 | 说明 |
| 后端框架 | Yii2 2.0.53 | 成熟稳定,支持懒加载、依赖注入 |
| 前端 UI | Bootstrap 4 + AdminLTE 3 | 响应式,PC/平板/手机自适应 |
| 数据库 | MySQL 5.7 | 支持 JSON、虚拟列,兼容 MariaDB |
| 缓存 | Redis / File | 内置缓存组件,可一键切换 |
| 队列 | Yii2-Queue + Redis | 异步发邮件、上链、生成报表 |
| 接口 | RESTful + OAuth2 | 官方提供 Uni-App、小程序 SDK |
| 语言包 | 简体中文、繁体、英语、日语 | 可后台在线翻译 |
| 包管理 | Composer 2.x | 全组件化,支持私有源 |
四、开箱即用功能
系统管理
- 菜单、部门、岗位、员工、角色、权限、字典、附件、日志、在线用户、定时任务、队列监控。
办公自动化(OA)
- 请假、加班、出差、报销、用章、用车、物品申领、合同审批;
- 表单设计器 + 流程设计器;
- 待办、已办、抄送、转交、加签、退回、委托。
人事考勤
- 员工档案、合同、奖惩、社保、培训、考核、履历;
- 班次、排班、打卡、补卡、外出、调休、年假自动计算。
CMS & 内容
- 文章、分类、标签、广告、留言、友情链接;
- 多语言、页面静态化、访问统计。
商城 & 支付
- 商品、SKU、优惠券、订单、物流、售后;
- 微信、支付宝、银联、PayPal、Stripe 统一网关;
- 支持分账、退款、对账、合并支付。
开发工具
- Gii 增强版:一键生成 Model/CURD/API/文档/菜单/权限;
- 代码在线编辑、SQL 在线执行、队列实时监控;
- 表单控件 16+、Excel 导入导出、二维码/条形码、图片裁剪/水印。
五、目录结构(典型安装后)
addon/ 插件目录
common/ 公共库
api/ 接口应用(REST入口)
backend/ 后台应用
merchant/ 企业端应用(SaaS)
frontend/ PC端应用 (官网)
html5/ 移动端应用(公众号)
console/ 定时任务 & 队列
vendor/ Composer 包
services/ 服务层(懒加载)
web/ 统一 入口
六、环境要求
- PHP ≥ 7.2(推荐 7.3)
- MySQL ≥ 5.7.34(或 MariaDB 10.2+)
- Redis ≥ 3.0(缓存 & 队列)
- Composer ≥ 2.0
- Nginx / Apache(含伪静态)
一键安装脚本(Linux):
git clone https://gitee.com/hjp0725/yiiframe4
cd yiiframe4
composer install
php init # 选择 dev/prod
php yii migrate/up
默认账号密码admin/123456
七、适用场景
| 场景 | 说明 |
| 企业 OA / 审批流 | 内置请假、报销、合同、用章等 20+ 流程,可视化设计 |
| SaaS 多租户 | 商户隔离、套餐计费、在线充值、套餐到期自动降级 |
| 商城 / 小程序 | 商品、订单、支付、物流、售后、分销、拼团、砍价 |
| 内容门户 | 文章、视频、图库、广告、评论、TAG、静态化 |
| 接口中台 | 统一对外 REST / OAuth2,前端可 Vue、React、Uni-App |
八、生态与文档
- 官方文档:http://doc.yiiframe.com
- 插件市场(内置)
- GitHub:https://github.com/hjp0725/yiiframe4
- Gitee:https://gitee.com/hjp0725/yiiframe4
- 示例项目:UniOA(UniApp + YiiFrame 办公系统)
九、一句话总结
YiiFrame = Yii2 的成熟稳定 + Bootstrap 的漂亮界面 + 插件化的高扩展 + 代码生成的极速开发,让你把精力花在业务创新,而不是重复造轮子。
十、免责声明
本软件是基于RageFrame二次开发的开源框架,仅作学习交流使用。
本软件按“现状”提供,作者与贡献者在法律允许的最大范围内不承担任何明示或暗示的担保责任,包括但不限于适销性、特定用途适用性、数据准确性或无侵权保证。
用户自行承担因使用、修改、分发本软件而产生的全部风险;因本软件导致的任何直接或间接损失(包括但不限于数据丢失、业务中断、信息泄露、第三方索赔),作者及贡献者不承担任何责任。
本软件所集成的第三方组件(含前端框架、支付 SDK、云存储驱动等)之版权、专利、商标、服务条款由其各自权利人负责,使用前应仔细阅读并遵守对应组件的授权协议与隐私政策;若产生纠纷,与本软件作者无关。
本软件非医疗、金融、执法、航空航天、核能等高风险领域专用系统,若将其用于上述场景或任何可能危害人身、财产安全的环境,所产生的一切后果由用户自行承担。
本软件内置的一键生成代码、工作流、表单设计器等功能仅为辅助开发工具,生成的业务逻辑、SQL 语句、权限规则等需经专业开发/审计人员二次确认后方可上线;因直接使用生成代码导致的性能、安全、合规问题,作者概不负责。
用户通过本软件插件市场下载或安装的第三方插件、主题、支付通道、短信网关等,均系独立开发者提供,其合法性、安全性、准确性由插件作者承担;请在安装前自行审查源码、权限与数据流向,并在测试环境充分验证。
本软件不提供永久维护承诺,社区版本更新、文档修正、漏洞响应时间取决于开源贡献者精力,建议商业项目购买官方或第三方技术支持服务,以获得 SLA 保障。
若您不同意本免责声明之任何条款,请立即停止使用并删除本软件及相关衍生作品;继续下载、安装、复制、修改、分发即视为完全理解并接受本声明全部内容。
特别鸣谢
感谢以下的项目,排名不分先后
Rageframe2:http://www.rageframe.com
Yii:http://www.yiiframework.com
EasyWechat:https://easywechat.com
Bootstrap:http://getbootstrap.com
AdminLTE:https://adminlte.io