# webman-amis-admin

**Repository Path**: my_forks/webman-amis-admin

## Basic Information

- **Project Name**: webman-amis-admin
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-05-21
- **Last Updated**: 2024-05-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# webman-tech/amis-admin

[amis](https://github.com/baidu/amis) For webman quick use ~

## 简介

借用 amis 的 json 配置化能力，提供给 webman 快速搭建管理后台的能力

只做最基础的增删改查封装，具体的业务都不实现

特性：

- 无依赖：不依赖第三方组件，Laravel 系和 TP 系都能用（目前建议 laravel，tp 的实现未做）
- 无侵入：不设定任何初始 sql，业务无关
- 无前端：基本不需要考虑前端，熟悉 amis 和 php 即可
- 高扩展：amis 的各种组件支持全局控制和页面级控制
- 支持多应用模式：可以支持作用于类似 admin/agent/user 多后台形式

局限：

- 功能简单：没有admin帐号体系，没有菜单管理，没有权限管理

## 安装

```bash
composer require webman-tech/amis-admin
```

要求 webman > 1.4 且关闭了 controller_reuse（原因：controller_reuse 导致成员变量会被缓存，AmisSourceController 需要使用到成员做单个请求的缓存）

## 使用

参考使用：[https://github.com/krissss/webman-basic](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. 如果使用 LaravelValidator，校验 file 时需要安装依赖：`webman-tech/polyfill`

## 其他

- [多应用支持](./docs/multi_app.md)
- [常用配置](./docs/common_usage.md)

## 不使用 cdn

配合使用 [kriss/composer-assets-plugin](https://github.com/krissss/composer-assets-plugin)