Symfony多语言实体优化：如何按Locale快速获取描述？

我正在将JSON数据聚合转换为Symfony对象。Ontology（分类）拥有类型（如泳池、餐厅），且其描述支持多语言。我希望能通过getDescription('fr')获取法语描述、getDescription('en')获取英语描述。目前我通过Repository实现，但逻辑比较复杂：

我的Ontology类：

class Ontology
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column]
    private ?int $id = null;

    #[ORM\Column(length: 255)]
    private ?string $idOntology = null;

    #[ORM\OneToMany(mappedBy: 'ontology', targetEntity: Label::class, cascade: ['persist', 'remove'], fetch:'EAGER')]
    private Collection $descriptions;
}

Label类（存储描述字段）：

#[ORM\Entity(repositoryClass: LabelRepository::class)]
class Label
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column]
    private ?int $id = null;

    #[ORM\Column(type: Types::TEXT)]
    private ?string $label = null;

    #[ORM\ManyToOne(inversedBy: 'descriptions')]
    private ?Ontology $ontology = null;

    #[ORM\ManyToOne(inversedBy: 'labels', fetch:'EAGER')]
    private ?Lang $lang = null;
}

Lang类：

#[ORM\Entity(repositoryClass: LangRepository::class)]
class Lang
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column]
    private ?int $id = null;

    #[ORM\Column(length: 10)]
    private ?string $labelLang = null; // 存储如'en'、'fr'的语言代码

    #[ORM\OneToMany(mappedBy: 'lang', targetEntity: Label::class)]
    private Collection $labels;
}

测试中我使用了fetch:'EAGER'加载，但不确定这是否正确，毕竟设置EAGER加载和在控制器编写复杂查询的效果相近。之前在Java中我通过Map实现了ontology.description.get(lang)的方式，在模板中传入Locale即可获取对应语言的描述。我希望能避免EAGER加载以提升Twig的渲染速度，同时需要判断访问者Locale对应的翻译是否存在，若不存在则显示默认语言（英语或法语）。请问是否有更简洁的实现方式？或者我的思路是否有误？

1. 实体层添加语言映射与获取方法 #

在Ontology类中添加方法，将$descriptions集合转换为以语言代码为键的关联数组，同时集成fallback逻辑，无需依赖EAGER加载：

use Doctrine\Common\Collections\Collection;
use Doctrine\Common\Collections\ArrayCollection;

class Ontology
{
    // ... 原有属性

    public function __construct()
    {
        $this->descriptions = new ArrayCollection();
    }

    /**
     * 获取指定语言的描述，不存在则返回默认语言（优先en，其次fr）
     */
    public function getDescription(string $langCode): string
    {
        // 先尝试目标语言
        $label = $this->descriptions->filter(function(Label $label) use ($langCode) {
            return $label->getLang()?->getLabelLang() === $langCode;
        })->first();

        if ($label instanceof Label) {
            return $label->getLabel();
        }

        // Fallback到英语
        $enLabel = $this->descriptions->filter(function(Label $label) {
            return $label->getLang()?->getLabelLang() === 'en';
        })->first();
        if ($enLabel instanceof Label) {
            return $enLabel->getLabel();
        }

        // 最后Fallback到法语
        $frLabel = $this->descriptions->filter(function(Label $label) {
            return $label->getLang()?->getLabelLang() === 'fr';
        })->first();
        return $frLabel instanceof Label ? $frLabel->getLabel() : '';
    }

    // 可选：缓存语言映射，避免重复遍历集合
    private ?array $descriptionMap = null;

    private function getDescriptionMap(): array
    {
        if ($this->descriptionMap === null) {
            $this->descriptionMap = [];
            foreach ($this->descriptions as $label) {
                $langCode = $label->getLang()?->getLabelLang();
                if ($langCode) {
                    $this->descriptionMap[$langCode] = $label->getLabel();
                }
            }
        }
        return $this->descriptionMap;
    }

    // 基于缓存Map的简化版获取方法
    public function getCachedDescription(string $langCode): string
    {
        $map = $this->getDescriptionMap();
        return $map[$langCode] ?? $map['en'] ?? $map['fr'] ?? '';
    }
}

2. 优化查询，移除EAGER加载 #

删除实体上的fetch:'EAGER'配置，改为在Repository中通过JOIN FETCH按需加载关联数据，减少不必要的查询：

在OntologyRepository中添加自定义查询方法：

use Doctrine\ORM\QueryBuilder;

class OntologyRepository extends ServiceEntityRepository
{
    // ... 原有方法

    /**
     * 获取指定ID的Ontology，并加载其所有描述（含关联的Lang）
     */
    public function findOneWithDescriptions(int $id): ?Ontology
    {
        return $this->createQueryBuilder('o')
            ->leftJoin('o.descriptions', 'd')
            ->leftJoin('d.lang', 'l')
            ->addSelect('d', 'l')
            ->where('o.id = :id')
            ->setParameter('id', $id)
            ->getQuery()
            ->getOneOrNullResult();
    }

    /**
     * 批量获取Ontology并加载描述，适合列表场景
     */
    public function findAllWithDescriptions(): array
    {
        return $this->createQueryBuilder('o')
            ->leftJoin('o.descriptions', 'd')
            ->leftJoin('d.lang', 'l')
            ->addSelect('d', 'l')
            ->getQuery()
            ->getResult();
    }

    /**
     * 按需加载指定语言的描述，进一步优化性能
     */
    public function findOneWithSpecificLang(int $id, string $langCode): ?Ontology
    {
        return $this->createQueryBuilder('o')
            ->leftJoin('o.descriptions', 'd', 'WITH', 'd.lang.labelLang = :lang')
            ->leftJoin('d.lang', 'l')
            ->addSelect('d', 'l')
            ->where('o.id = :id')
            ->setParameters([
                'id' => $id,
                'lang' => $langCode
            ])
            ->getQuery()
            ->getOneOrNullResult();
    }
}

3. Twig模板中的使用 #

在控制器中获取当前请求的Locale，传递给Ontology的方法即可：

// 控制器代码
use Symfony\Component\HttpFoundation\Request;

public function show(Request $request, OntologyRepository $repo)
{
    $ontology = $repo->findOneWithDescriptions(1);
    $currentLang = $request->getLocale(); // 自动获取当前请求的语言，如'en'、'fr'

    return $this->render('ontology/show.html.twig', [
        'ontology' => $ontology,
        'currentLang' => $currentLang
    ]);
}

Twig模板直接调用方法：

<p>{{ ontology.getDescription(currentLang) }}</p>
{# 或者使用缓存版方法 #}
<p>{{ ontology.getCachedDescription(currentLang) }}</p>

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