amis-admin 基于amis 的 admin CRUD

v2.2.2 版本
2024-02-27 版本更新时间
320 安装
8 star

为了后期更好的维护,最新 2.0 版本已修改包名,请注意切换

webman-tech/amis-admin

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中)修改默认配置参数

多应用支持

  1. 复制一份 config/plugin/webman-tech/amis-admin/amis.phpconfig/plugin/webman-tech/amis-admin/amis-user.php

  2. 继承 AmisModuleChangeMiddleware 实现一个无 __construct 的中间件(因为 webman 目前还不支持中间件注册使用 __construct),例如:

<?php

namespace app\middleware;

use WebmanTech\AmisAdmin\Middleware\AmisModuleChangeMiddleware;

class AmisModuleChange2User extends AmisModuleChangeMiddleware
{
    public function __construct()
    {
        parent::__construct('amis-user');
    }
}
  1. 在响应的路由或全局中间件中引入 AmisModuleChange2User