webman-tech / amis-admin
Webman plugin webman-tech/amis-admin
v2.2.2
2024-02-27 02:18 UTC
Requires
- php: >=7.4
- ext-json: *
Requires (Dev)
- illuminate/database: ^8.83
- illuminate/pagination: ^8.83
- illuminate/validation: ^8.83
- webman-tech/polyfill: ^1.0
- workerman/webman-framework: ^1.3
README
amis For webman quick use ~
简介
借用 amis 的 json 配置化能力,提供给 webman 快速搭建管理后台的能力
只做最基础的增删改查封装,具体的业务都不实现
特性:
- 无依赖:不依赖第三方组件,Laravel 系和 TP 系都能用(目前建议 laravel,tp 的实现未做)
- 无侵入:不设定任何初始 sql,业务无关
- 无前端:基本不需要考虑前端,熟悉 amis 和 php 即可
- 高扩展:amis 的各种组件支持全局控制和页面级控制
- 支持多应用模式:可以支持作用于类似 admin/agent/user 多后台形式
局限:
- 功能简单:没有admin帐号体系,没有菜单管理,没有权限管理
安装
composer require webman-tech/amis-admin
要求 webman > 1.4 且关闭了 controller_reuse(原因:controller_reuse 导致成员变量会被缓存,AmisSourceController 需要使用到成员做单个请求的缓存)
使用
参考使用:https://github.com/krissss/webman-basic
注意: Amis 实际上是前后端分离的框架,即数据接口是数据接口,页面配置(json)是页面配置, 因此不能用常规的 PHP 框架下的 admin 框架(如 laravel-admin 等)来思考
AmisSourceController
是一个基础的 CRUD 资源控制器基类,负责控制页面结构,操作按钮权限等
Repository
AmisSourceController 中使用的 repository 的方法封装,负责提供对数据的增删改
Component
Amis 组件的封装,目前仅封装了常用的组件类型和属性, 但 amis 的所有组件都可以通过 Component::make(['type' => 'xxx'])
来配置
所有组件也都支持 schema()
方法来覆盖(支持嵌套覆盖)参数
组件支持 Controller 级别和全局(config中)修改默认配置参数
注意点
- 如果使用 LaravelValidator,校验 file 时需要安装依赖:
webman-tech/polyfill