Symfony5+EasyAdmin3如何根据角色动态筛选AssociationField可选值

以下是针对该需求的3种可行实现方案，适配Symfony 5 + EasyAdmin 3技术栈：

方案1：直接使用AssociationField的setQueryBuilder方法 #

这是最简便的实现方案，适合仅单个/少数字段需要做权限筛选的场景

• 实现逻辑：AssociationField原生支持setQueryBuilder方法，可直接自定义关联数据的查询逻辑，效果和Symfony表单原生QueryBuilder完全一致
• 代码示例：

// 对应实体的Crud控制器文件
use EasyCorp\Bundle\EasyAdminBundle\Field\AssociationField;
use Symfony\Component\Security\Core\Security;

class YourEntityCrudController extends AbstractCrudController
{
    private $security;

    // 注入Symfony安全组件获取当前登录用户
    public function __construct(Security $security)
    {
        $this->security = $security;
    }

    public function configureFields(string $pageName): iterable
    {
        $currentUser = $this->security->getUser();
        
        yield AssociationField::new('relatedEntity', '关联字段名称')
            ->setQueryBuilder(function ($queryBuilder) use ($currentUser) {
                // 管理员角色可查看所有可选值
                if (in_array('ROLE_ADMIN', $currentUser->getRoles())) {
                    return $queryBuilder;
                }
                // 普通角色仅查看归属自己的关联数据，可根据业务修改筛选条件
                return $queryBuilder
                    ->andWhere('entity.owner = :currentUser')
                    ->setParameter('currentUser', $currentUser);
            });
    }
}

• 注意：闭包中的entity是EasyAdmin默认给关联实体设置的查询别名，不要自行修改。

方案2：通过Symfony表单事件动态修改字段配置 #

适合筛选逻辑复杂、需要在表单生命周期不同阶段动态调整的场景

• 实现思路：EasyAdmin表单本质是Symfony原生表单，通过监听PRE_SET_DATA事件可以动态覆盖字段的query_builder参数，同时保留EasyAdmin对字段的其他默认配置
• 代码示例：

// 对应实体的Crud控制器文件
use Symfony\Component\Form\FormEvent;
use Symfony\Component\Form\FormEvents;
use Symfony\Bridge\Doctrine\Form\Type\EntityType;
use App\Entity\RelatedEntity;

public function createEntityFormBuilder($entity, string $pageName): \Symfony\Component\Form\FormBuilderInterface
{
    $builder = parent::createEntityFormBuilder($entity, $pageName);
    $currentUser = $this->security->getUser();

    $builder->addEventListener(FormEvents::PRE_SET_DATA, function (FormEvent $event) use ($currentUser) {
        $form = $event->getForm();
        // 合并原有配置，仅替换query_builder参数
        $form->add('relatedEntity', EntityType::class, array_merge(
            $form->get('relatedEntity')->getConfig()->getOptions(),
            [
                'query_builder' => function (\App\Repository\RelatedEntityRepository $er) use ($currentUser) {
                    $qb = $er->createQueryBuilder('e');
                    // 非超级管理员仅查看已启用的关联数据
                    if (!in_array('ROLE_SUPER_ADMIN', $currentUser->getRoles())) {
                        $qb->andWhere('e.status = :validStatus')
                            ->setParameter('validStatus', 1);
                    }
                    return $qb;
                }
            ]
        ));
    });

    return $builder;
}

方案3：自定义Doctrine全局过滤器 #

适合所有用到该关联实体的场景都需要按角色过滤的需求，全局生效无需重复配置

• 实现逻辑：通过Doctrine的SQL过滤器功能，在所有对目标关联实体的查询中自动拼接权限过滤条件，不仅作用于AssociationField下拉选项，也会作用于列表、详情页等所有查询该实体的场景
• 适用场景：该关联实体全系统都需要按角色做数据隔离的场景
• 注意事项：个别场景需要跳过过滤时，需要手动临时关闭过滤器，操作相对繁琐

内容的提问来源于stack exchange，提问作者Radoslav Curcic