Symfony4+EasyAdmin3如何添加关联字段并调用关联实体指定字段？

假设你的Payment实体关联Debt实体（通过debt_id外键），要调用Debt的paid字段，按以下步骤配置：

1. 确保实体关联关系正确 #

首先确认Payment和Debt实体的ORM关联配置无误，且包含对应字段的getter方法：

Payment.php 关键代码 #

// src/Entity/Payment.php
use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity
 */
class Payment
{
    // ...其他字段
    
    /**
     * @ORM\ManyToOne(targetEntity=Debt::class)
     * @ORM\JoinColumn(name="debt_id", referencedColumnName="id", nullable=false)
     */
    private $debt;

    // 必须提供getter方法
    public function getDebt(): ?Debt
    {
        return $this->debt;
    }
}

Debt.php 关键代码 #

// src/Entity/Debt.php
use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity
 */
class Debt
{
    // ...其他字段
    
    /**
     * @ORM\Column(type="boolean")
     */
    private $paid = false;

    // 必须提供getter方法
    public function isPaid(): bool
    {
        return $this->paid;
    }
}

2. 在CrudController中配置字段 #

根据不同页面（列表、表单、详情）的需求，有几种配置方式：

方式一：列表页直接显示关联实体的字段 #

如果只是在列表页展示Debt的paid状态，可以直接用实体属性路径debt.paid创建字段，无需依赖AssociationField：

// src/Controller/Admin/PaymentCrudController.php
use EasyCorp\Bundle\EasyAdminBundle\Field\BooleanField;

public function configureFields(string $pageName): iterable
{
    // ...其他字段
    if ($pageName === 'index') {
        yield BooleanField::new('debt.paid')
            ->setLabel('Debt Paid Status'); // 自定义显示标签
    }
}

方式二：关联字段中嵌入目标字段信息 #

如果需要保留关联实体的选择/跳转功能，同时显示paid字段，可通过formatValue方法自定义AssociationField的显示内容：

// src/Controller/Admin/PaymentCrudController.php
use EasyCorp\Bundle\EasyAdminBundle\Field\AssociationField;

public function configureFields(string $pageName): iterable
{
    // ...其他字段
    yield AssociationField::new('debt')
        ->setLabel('Related Debt')
        ->formatValue(function ($value, $entity) {
            // 处理空关联的情况
            if (!$entity->getDebt()) {
                return '-';
            }
            // 拼接关联实体ID和paid状态
            return sprintf('Debt #%d (Paid: %s)', 
                $entity->getDebt()->getId(), 
                $entity->getDebt()->isPaid() ? 'Yes' : 'No'
            );
        });
}

方式三：表单页中自定义关联选项的显示 #

在新增/编辑页面的关联选择框中，把paid状态加入选项标签，方便用户识别：

// src/Controller/Admin/PaymentCrudController.php
use EasyCorp\Bundle\EasyAdminBundle\Field\AssociationField;

public function configureFields(string $pageName): iterable
{
    // ...其他字段
    if ($pageName === 'new' || $pageName === 'edit') {
        yield AssociationField::new('debt')
            ->setFormTypeOption('choice_label', function (\App\Entity\Debt $debt) {
                return sprintf('#%d - Paid: %s', 
                    $debt->getId(), 
                    $debt->isPaid() ? 'Yes' : 'No'
                );
            });
    }
}

方式四：详情页展示关联字段 #

在详情页同时展示关联实体和其paid状态：

// src/Controller/Admin/PaymentCrudController.php
use EasyCorp\Bundle\EasyAdminBundle\Field\AssociationField;
use EasyCorp\Bundle\EasyAdminBundle\Field\BooleanField;

public function configureFields(string $pageName): iterable
{
    // ...其他字段
    if ($pageName === 'detail') {
        yield AssociationField::new('debt');
        yield BooleanField::new('debt.paid')
            ->setLabel('Debt Paid Status');
    }
}

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