【fastadmin】自定义批量操作与Excel导入：高效管理多管理员分组策略

1. 为什么需要批量操作与Excel导入功能

在实际的后台管理系统开发中，管理员账号的管理往往是个头疼的问题。想象一下，新学期开始，学校需要为50位新入职的教师创建管理员账号，如果一个个手动添加，不仅耗时耗力，还容易出错。这就是为什么我们需要批量操作和Excel导入功能。

我在一个教育类项目中就遇到过类似场景。当时客户要求在开学前一次性导入200多个教师账号，还要将他们分配到不同的教研组。如果手动操作，至少需要一整天时间，而使用FastAdmin的批量处理功能，整个过程只用了不到10分钟。

FastAdmin作为一款优秀的后台开发框架，本身就提供了强大的批量操作和Excel导入功能。但很多开发者不知道如何充分利用这些功能，或者不清楚如何根据实际需求进行自定义开发。接下来，我将详细介绍如何实现这些功能。

2. 准备工作与环境配置

2.1 确保FastAdmin环境正确配置

在开始之前，我们需要确保开发环境已经正确配置。我建议使用以下环境：

• PHP 7.2+
• MySQL 5.7+
• FastAdmin 1.3.0+

首先检查FastAdmin是否已经安装并正常运行。我遇到过不少开发者因为环境配置问题导致后续功能无法正常使用。特别是PHP的扩展，需要确保以下扩展已经安装并启用：

• pdo_mysql
• mbstring
• zip（用于Excel文件处理）
• gd（用于验证码生成）

2.2 数据库表结构准备

我们需要两个核心表来支持这个功能：

1. admin表：存储管理员基本信息
2. auth_group_access表：记录管理员与用户组的关联关系

确保这两个表已经存在并且字段完整。特别是auth_group_access表，需要有uid和group_id字段，分别对应管理员ID和用户组ID。

3. 实现Excel批量导入管理员

3.1 启用FastAdmin内置导入功能

FastAdmin已经内置了强大的Excel导入功能，我们只需要进行简单配置就能使用。在管理员的控制器中，添加以下代码：

public function import() { return parent::import(); }

然后在对应的JS文件中配置导入URL：

import_url: 'auth/admin/import'

最后在模板文件中添加导入按钮：

{:build_toolbar('refresh,add,delete,import')}

3.2 准备Excel导入模板

Excel文件的格式非常重要。第一行应该是字段的备注名，后续行是对应的数据。例如：

这里有个小技巧：密码字段可以使用FastAdmin的默认加密方式。比如上面的密码和密码盐组合，实际密码就是"123456"。

3.3 处理导入数据

在导入过程中，我们可能需要对数据进行额外处理。可以在模型的importBefore方法中添加自定义逻辑：

protected function importBefore($data) { // 自动生成密码盐 $data['salt'] = Random::alnum(); // 加密密码 $data['password'] = md5(md5('123456').$data['salt']); return $data; }

这样即使Excel中没有提供密码和密码盐，系统也会自动生成默认密码。

4. 自定义批量操作按钮开发

4.1 添加批量操作按钮

在模板文件中添加自定义按钮：

<a href="javascript:;" class="btn btn-primary btn-changeteacher btn-disabled disabled" title="批量设置为教师"> <i class="fa fa-suitcase"></i> 批量设置为教师 </a>

注意按钮的class名称，我们后面会用到。我建议使用有意义的class名，比如这里的btn-changeteacher就明确表示了按钮的功能。

4.2 编写前端交互逻辑

在JS文件中添加以下代码来处理按钮点击事件：

// 获取选中的行ID function getIdSelections() { return $.map($("#table").bootstrapTable('getSelections'), function(row) { return row.id }); } $(".btn-changeteacher").on('click',function(){ var ids = getIdSelections(); if(ids.length == 0) { Toastr.error('请至少选择一条记录'); return; } Fast.api.ajax({ type: 'POST', url:'auth/admin/changeteacher?ids='+ids }, function (data, ret) { Toastr.success('操作成功'); location.reload(); }, function (data, ret) { Toastr.error(data.msg); }); })

这段代码做了几件事：

1. 获取用户选中的行
2. 检查是否至少选择了一条记录
3. 发送AJAX请求到后端
4. 处理成功或失败的响应

4.3 后端批量处理逻辑

在后端控制器中添加处理逻辑：

public function changeteacher() { $ids = $this->request->param('ids'); if(empty($ids)) { $this->error('请选择要操作的管理员'); } $ids = explode(',', $ids); $dataset = []; foreach ($ids as $id) { $dataset[] = [ 'uid' => $id, 'group_id' => 2 // 教师组的ID ]; } Db::startTrans(); try { // 先删除原有关系 model('AuthGroupAccess')->where('uid', 'in', $ids)->delete(); // 添加新关系 model('AuthGroupAccess')->saveAll($dataset); Db::commit(); $this->success('操作成功'); } catch (\Exception $e) { Db::rollback(); $this->error('操作失败：'.$e->getMessage()); } }

这里有几个关键点：

1. 使用事务确保数据一致性
2. 先删除原有分组关系，再添加新的关系
3. 完善的错误处理机制

5. 功能测试与常见问题排查

5.1 测试流程建议

在实际项目中，我建议按照以下步骤测试：

1. 先导入少量测试数据（3-5条）
2. 检查数据是否正确导入
3. 测试批量操作功能
4. 检查分组关系是否正确更新
5. 最后进行大批量数据测试

5.2 常见问题及解决方案

问题1：导入按钮不显示

• 检查模板中是否添加了import到工具栏
• 检查控制器是否继承了import方法
• 检查JS中是否配置了import_url

问题2：导入时密码不正确

• 检查Excel中的密码和密码盐格式
• 检查模型的importBefore方法是否被正确调用
• 确认数据库中的加密方式与代码一致

问题3：批量操作无效

• 检查前端是否获取到了正确的ID
• 检查后端接收到的参数是否正确
• 查看数据库事务是否正常提交

6. 功能扩展与优化建议

6.1 添加操作确认对话框

为了防止误操作，可以在点击批量操作按钮时添加确认对话框：

$(".btn-changeteacher").on('click',function(){ var ids = getIdSelections(); if(ids.length == 0) { Toastr.error('请至少选择一条记录'); return; } Layer.confirm('确定要将选中的'+ids.length+'个管理员设置为教师吗？', { title: '操作确认', btn: ['确定','取消'] }, function(){ // 用户点击确定后的逻辑 Fast.api.ajax({ type: 'POST', url:'auth/admin/changeteacher?ids='+ids }, function (data, ret) { Toastr.success('操作成功'); location.reload(); }, function (data, ret) { Toastr.error(data.msg); }); }); })

6.2 添加操作日志记录

为了便于追踪操作记录，可以在后端添加日志记录：

try { // 先删除原有关系 model('AuthGroupAccess')->where('uid', 'in', $ids)->delete(); // 添加新关系 model('AuthGroupAccess')->saveAll($dataset); // 记录操作日志 foreach ($ids as $id) { model('AdminLog')->record( '批量设置教师组', $this->auth->id, $this->request->module(), $this->request->url(true), json_encode(['uid'=>$id, 'group_id'=>2]) ); } Db::commit(); $this->success('操作成功'); } catch (\Exception $e) { Db::rollback(); $this->error('操作失败：'.$e->getMessage()); }

6.3 支持多种分组批量操作

我们可以扩展功能，支持多种分组的批量操作。首先在模板中添加更多按钮：

<a href="javascript:;" class="btn btn-info btn-changegroup btn-disabled disabled">$(".btn-changegroup").on('click',function(){ var ids = getIdSelections(); if(ids.length == 0) { Toastr.error('请至少选择一条记录'); return; } var groupId = $(this).data('group'); var groupName = $(this).attr('title').replace('批量设置为', ''); Layer.confirm('确定要将选中的'+ids.length+'个管理员设置为'+groupName+'吗？', { title: '操作确认', btn: ['确定','取消'] }, function(){ Fast.api.ajax({ type: 'POST', url:'auth/admin/changegroup?ids='+ids+'&group_id='+groupId }, function (data, ret) { Toastr.success('操作成功'); location.reload(); }, function (data, ret) { Toastr.error(data.msg); }); }); })

最后修改后端控制器：

public function changegroup() { $ids = $this->request->param('ids'); $groupId = $this->request->param('group_id'); if(empty($ids)) { $this->error('请选择要操作的管理员'); } if(empty($groupId)) { $this->error('请选择要设置的分组'); } $ids = explode(',', $ids); $dataset = []; foreach ($ids as $id) { $dataset[] = [ 'uid' => $id, 'group_id' => $groupId ]; } Db::startTrans(); try { model('AuthGroupAccess')->where('uid', 'in', $ids)->delete(); model('AuthGroupAccess')->saveAll($dataset); Db::commit(); $this->success('操作成功'); } catch (\Exception $e) { Db::rollback(); $this->error('操作失败：'.$e->getMessage()); } }