webman-tech / amis-admin
Webman plugin webman-tech/amis-admin
v5.0.20
2026-04-21 01:39 UTC
Requires
- php: ^8.2
- webman-tech/common-utils: ^5.0 || dev-main
- dev-main
- v5.0.20
- v5.0.19
- v5.0.18
- v5.0.17
- v5.0.16
- v5.0.15
- v5.0.14
- v5.0.13
- v5.0.12
- v5.0.11
- v5.0.10
- v5.0.9
- v5.0.8
- v5.0.7
- v5.0.6
- v5.0.5
- v5.0.4
- v5.0.3
- v5.0.2
- v5.0.1
- v5.0.0
- v3.0.0
- v2.3.3
- v2.3.2
- v2.3.1
- v2.3.0
- v2.2.3
- v2.2.2
- v2.2.1
- v2.2.0
- v2.1.1
- v2.1.0
- v2.0.3
- v2.0.2
- v2.0.1
- v2.0.0
- v1.4.2
- v1.4.1
- v1.4.0
- v1.3.4
- v1.3.3
- v1.3.2
- v1.3.1
- v1.3.0
- v1.2.0
- v1.1.0
- v1.0.28
- v1.0.27
- v1.0.26
- v1.0.25
- v1.0.24
- v1.0.23
- v1.0.22
- v1.0.21
- v1.0.20
- v1.0.19
- v1.0.18
- v1.0.17
- v1.0.16
- v1.0.15
- v1.0.14
- v1.0.13
- v1.0.12
- v1.0.11
- v1.0.10
- v1.0.9
- v1.0.8
- v1.0.7
- v1.0.6
- v1.0.5
- v1.0.4
- v1.0.3
- v1.0.2
- v1.0.1
- v1.0.0
- v0.1.1
- v0.1.0
- dev-2.2.3-bk
- dev-dev-dynamic-page
- dev-amis-facade
- dev-issue-7
This package is auto-updated.
Last update: 2026-04-23 08:00:48 UTC
README
本项目是从 webman-tech/components-monorepo 自动 split 出来的,请勿直接修改
简介
借用 amis 的 JSON 配置化能力,提供给 webman 快速搭建管理后台的能力。
只做最基础的增删改查封装,具体的业务都不实现。
特性:
- 无依赖:不依赖第三方组件,Laravel 系和 TP 系都能用
- 无侵入:不设定任何初始 SQL,业务无关
- 无前端:基本不需要考虑前端,熟悉 amis 和 PHP 即可
- 高扩展:amis 的各种组件支持全局控制和页面级控制
- 支持多应用模式:可以支持类似 admin/agent/user 多后台形式
局限:没有 admin 帐号体系,没有菜单管理,没有权限管理。
安装
composer require webman-tech/amis-admin
要求 webman > 1.4,且需关闭 controller_reuse(原因:controller_reuse 会导致成员变量被缓存,而 AmisSourceController 需要使用成员变量做单个请求内的缓存)。
核心组件
AmisSourceController
基础的 CRUD 资源控制器基类,负责控制页面结构和操作按钮权限等。业务控制器继承该类后,通过实现对应方法来定义页面的列表、新增、编辑、删除等行为。
Repository
AmisSourceController 中使用的数据访问层封装,负责提供对数据的增删改查操作。支持多种实现方式,内置 EloquentRepository 用于与 Laravel Eloquent ORM 交互。
Component
amis 组件的封装,目前封装了常用的组件类型和属性。所有 amis 组件都可以通过 Component::make(['type' => 'xxx']) 来配置,并支持通过 schema() 方法覆盖(支持嵌套覆盖)参数。
PresetsHelper
用于简化 amis 管理后台字段配置的辅助工具,允许开发者通过预设的方式统一管理字段在不同场景(列表、表单、搜索等)下的展示和验证规则。
其他
- 参考使用:https://github.com/krissss/webman-basic
- 不使用 CDN:配合使用 kriss/composer-assets-plugin
AI 辅助
- 开发维护:AGENTS.md — 面向 AI 的代码结构和开发规范说明
- 使用指南:skills/webman-tech-amis-admin-best-practices/SKILL.md — 面向 AI 的最佳实践,可安装到 Claude Code 的 skills 目录使用