webman-admin后台管理必备增强组件

基于webmam-admin开发

低代码、后台直接配置、安装即用

和web-admin零耦合 卸载后无任何代码侵入

• 所有功能均使用中间件开发，和admin无任何耦合，admin代码零修改。
• 在plugin/admin/config/middleware.php中调用plugin\iadminer\app\middleware\IadminerAdminPlus::class即可

环境要求

• 理论上支持php7.4.以上，实际已测试PHP环境7.4/8.1/8.2（如果发生部分错误可尝试切换PHP版本）
• 理论上支持mysql5.7以上 实际测试环境5.7
• 理论上支持redis3以上 实际测试环境3.2/5.0/7.2

安装使用

• 第一步：安装插件并修改plugin/admin/config/middleware.php配置文件调用本插件中间件plugin\iadminer\app\middleware\IadminerAdminPlus::class
  代码如下（其他插件调用等同）：

<?php 
use plugin\admin\app\middleware\AccessControl;
return [
    '' => [
        AccessControl::class,
        plugin\iadminer\app\middleware\IadminerAdminPlus::class, //iadminer增强组件支持
    ]
];

• 第二步：使用各组件安装响应依赖，不使用某组件均可不安装，具体组件使用说明内置于组件中组件说明页面
• 第三步：检查是否安装成功，如未发现后台新增管理菜单（增强组件），可能是插件安装异常导致，请在根目录执行安装命令 php webman app-plugin:install iadminer
• 第四步：浏览各页面功能是否正常，如发现有异常报错，请尝试切换系统环境、切换php版本、检查PHP所需扩展及配置、是否缺少composer包等，或直接联系我们。

更新说明

• 在更新admin插件后,请务必执行 php webman app-plugin:uninstall iadminer和php webman app-plugin:install
  iadminer两条命令重新安装本插件以保证curd功能组件正常
• 如果你在本插件中未做任何代码变更也可以在后台插件管理中执行卸载安装

功能特性：各组件均支持开关

• CRUD八大增强组件
• 配置字典多控件版增强组件（同CRUD控件）
• 独立进程/共享进程、多类型版增强计划任务
• 多驱动文件/图片云存储增强组件
• 多驱动文件缓存增强组件
• 多驱动业务锁增强组件
• 集成同步/异步请求HTTP客户端增强版
• 集成操作日志增强版
• 集成浏览器调试打印增强组件
• 集成注释解析器增强组件

CRUD增强特性

• 支持生成树状表格
• 字段类型增强，支持多图上传、多文件上传、下拉单选分页、下拉多选分页字段类型，同时支持上传进度显示
• 支持服务端验证增强
• 增加字段回调方法
• 按钮扩展设置
• 一键菜单数据保存
• 增加表单帮助信息显示
• 支持控制器方法前后置钩子
• 以上功能均支持table（view/insert/update）及一键生成的页面

计划任务增强特性

• 支持独立进程和共享进程及进程配置；
• 支持选择阻塞或不阻塞进程；
• 支持业务并发锁；
• 支持多任务类型：webman命令、指定类方法、访问指定网站、php原生代码、shell命令；
• 支持phar方式运行时编辑任务配置时无需重新编译，config/process.php进程配置代码已写活。

多驱动缓存增强类型：

• array
• file
• redis
• memcached
• apcu
• database
• 内置助手方法方便调用

多驱动云存储增强支持：

• 本地服务器存储
• 七牛云存储
• 阿里OSS存储
• 腾讯COS存储
• 亚马逊S3存储
• FTP存储
• 内存储存
• 内置助手方法方便调用

多驱动缓存增强支持：

• file缓存
• redis缓存

组件详细说明

以上增强功能组件均有详细的使用说明，内置于组件当中，见下图：

安装问题使用集锦

已知问题 2024.05.27

• webman-admin官方最近对curd的有一些调整，prepareProps方法导致本组件xm-select下拉菜单出现奇怪的双引号，部分curd的中间组件同时也收到影响，根据github描述增加了一些拖拽排序之类，但好像也未发现该功能，猜测可能调整开发中尚不够稳定
• 鉴于以上情况同时如果您主要使用本组件的curd功能，请下载市场这里0.6.20版或保持现有版本（用命令行创建，也就是拉取github的虽然也是0.6.20，但和市场里的0.6.20代码是不同的，在此也建议官网的版本号能略作调整）
• 如果你不主要使用本组件的curd功能，请在plugin/admin/common/Layui.php约726行临时过滤那奇怪的双引号代码导致下拉菜单报错，代码如下

  if (is_array($item)) {
     foreach ($item as $k => $v) {
       $item[$k] = str_replace('"', '', $v);
     }
  .......
  }

• 之所以未及时跟进更新，本着不入侵官方代码的原则，待观察一段时间官方对webman-admin的更新请款再作跟上，喜欢本组件的可以下载市场0.6.20版或保持现有版本
• 官方对layui的调整貌似影响想直接继承layui表单组件的功能使用者，不知道其他开发者有无这样的烦恼（官方能否在这里也像user插件那样内置一个渲染钩子）

安装sql包位置问题及安装问题 请详细阅读该文顶部安装四步曲

• 可使用插件安装卸载命令检查
• 安装命令 php webman app-plugin:install iadminer
• 卸载命令 php webman app-plugin:uninstall iadminer
• 注意卸载命令会删除相关数据表
• sql安装文件位于plugin/iadminer/app/install目录中
• bug反应请添加微信号holdfreelife（请备注webman订单购买账号），（如不允许展示联系方式请管理审核员把该行删除） 我们将第一时间为您解决问题

评论区PHP8.2环境报错Creation of dynamic property

• 请升级版本，不想升级可调整php版本至8.2以下，理论上已支持7.4-8.3