EasyAdminBundle实现基于创建者的CRUD权限控制

背景介绍

在开发后台管理系统时，经常需要根据不同用户角色来限制数据访问范围。EasyAdminBundle作为Symfony的优秀后台管理组件，提供了灵活的权限控制机制。本文将详细介绍如何实现一个常见需求：让普通用户只能查看和操作自己创建的数据记录，而管理员可以访问所有数据。

核心实现原理

EasyAdminBundle通过重写Crud控制器的createIndexQueryBuilder方法，可以自定义数据查询逻辑。这是实现数据过滤的最佳切入点，因为它允许我们在数据查询阶段就进行权限过滤。

具体实现步骤

1. 创建自定义Crud控制器

首先需要为你的实体创建一个自定义的Crud控制器，继承自EasyAdminBundle的基础控制器。

use EasyCorp\Bundle\EasyAdminBundle\Controller\AbstractCrudController;

class YourEntityCrudController extends AbstractCrudController
{
    // 控制器内容
}

2. 重写查询构建方法

在控制器中重写createIndexQueryBuilder方法，添加权限过滤逻辑：

use Doctrine\ORM\QueryBuilder;
use EasyCorp\Bundle\EasyAdminBundle\Collection\FieldCollection;
use EasyCorp\Bundle\EasyAdminBundle\Collection\FilterCollection;
use EasyCorp\Bundle\EasyAdminBundle\Dto\EntityDto;
use EasyCorp\Bundle\EasyAdminBundle\Dto\SearchDto;

public function createIndexQueryBuilder(
    SearchDto $searchDto,
    EntityDto $entityDto,
    FieldCollection $fields,
    FilterCollection $filters
): QueryBuilder {
    $queryBuilder = parent::createIndexQueryBuilder($searchDto, $entityDto, $fields, $filters);
    
    // 如果是管理员或审核员，不进行过滤
    if ($this->isGranted('ROLE_ADMIN') || $this->isGranted('ROLE_MODERATOR')) {
        return $queryBuilder;
    }
    
    // 普通用户只能看到自己创建的记录
    $queryBuilder
        ->andWhere('entity.createdBy = :userId')
        ->setParameter('userId', $this->getUser()->getId());
    
    return $queryBuilder;
}

3. 实体设计要求

要实现这种过滤，你的实体需要有一个createdBy字段(或类似字段)来记录创建者信息。这个字段通常与用户实体关联：

#[ORM\ManyToOne(targetEntity: User::class)]
#[ORM\JoinColumn(nullable: false)]
private ?User $createdBy = null;

进阶考虑

1. 性能优化

这种过滤在数据库查询层面完成，性能最佳。相比获取所有数据后再在PHP中过滤，这种方法显著减少了内存使用和网络传输。

2. 一致性保障

确保所有创建实体的操作都正确设置了createdBy字段。可以在实体构造函数或生命周期回调中自动设置：

#[ORM\PrePersist]
public function setCreatedByValue(): void
{
    $this->createdBy = $this->getUser();
}

3. 其他操作的限制

除了列表视图，还应该考虑对编辑、删除等操作进行类似的权限控制。可以通过EasyAdminBundle的权限系统或自定义Security Voter来实现。

总结

通过重写createIndexQueryBuilder方法，我们实现了一个简洁而高效的数据过滤方案。这种模式不仅适用于创建者过滤，还可以扩展用于各种基于组织、部门或其他业务规则的数据隔离需求。EasyAdminBundle的这种灵活性使其成为构建复杂权限管理系统后台的理想选择。