能否通过注解等方式为Doctrine实体自动生成翻译配套额外属性？

你之前踩的自定义注解拿不到属性上下文的坑，本质是分层错了：注解本身只是个纯标记的数据容器，实例化的时候完全不知道自己被打在哪个类、哪个属性上，把逻辑写在注解类里自然拿不到有效信息。完全不用改实体手写冗余字段，通过Doctrine的元数据加载事件就能实现完全自动的效果。

核心实现步骤 #

1. 做个纯标记的注解 #

这个注解不带任何业务逻辑，只用来标识哪个属性需要开启多语言扩展：

// src/Annotation/Translatable.php
namespace App\Annotation;

/**
 * @Annotation
 * @Target("PROPERTY")
 */
class Translatable
{
    // 空类，仅做标记使用
}

对应的实体写法就只需要在原来的$text属性上多加一行注解：

/**
     * @ORM\Column(type="text")
     * @Translatable
     */
    private $text;

2. 挂载元数据加载监听器 #

Doctrine在加载实体映射信息的时候，会触发loadClassMetadata事件，这个节点能拿到完整的当前实体反射信息、所有属性名、原有字段类型，完全不存在拿不到属性名的问题。
监听器的核心逻辑就是遍历当前实体的所有属性，找到打了@Translatable标记的字段，按照命名规则动态把需要的三个字段加到Doctrine的类映射元数据里：

// src/EventListener/TranslatableMetadataListener.php
namespace App\EventListener;

use App\Annotation\Translatable;
use Doctrine\ORM\Event\LoadClassMetadataEventArgs;
use Doctrine\ORM\Mapping\Builder\ClassMetadataBuilder;

class TranslatableMetadataListener
{
    public function loadClassMetadata(LoadClassMetadataEventArgs $eventArgs)
    {
        $classMetadata = $eventArgs->getClassMetadata();
        $builder = new ClassMetadataBuilder($classMetadata);

        // 遍历当前类声明的所有属性
        foreach ($classMetadata->getReflectionClass()->getProperties() as $property) {
            // 跳过继承来的属性，只处理当前类自己声明的
            if ($property->getDeclaringClass()->getName() !== $classMetadata->getName()) {
                continue;
            }

            // 检查属性上有没有Translatable标记
            $hasTranslatable = false;
            $propertyAnnotations = $eventArgs->getAnnotationReader()->getPropertyAnnotations($property);
            foreach ($propertyAnnotations as $annot) {
                if ($annot instanceof Translatable) {
                    $hasTranslatable = true;
                    break;
                }
            }
            if (!$hasTranslatable) {
                continue;
            }

            $baseName = $property->getName();
            // 拿到原属性的映射配置，复用类型参数
            $originalMapping = $classMetadata->getFieldMapping($baseName);

            // 动态加第一个字段：原属性对应的更新时间
            $builder->addField("{$baseName}UpdatedAt", 'datetime', [
                'nullable' => false,
                'columnName' => "{$baseName}_updated_at"
            ]);

            // 动态加第二个字段：英文翻译值，和原属性保持同类型
            $engOptions = [
                'nullable' => true,
                'columnName' => "{$baseName}_eng"
            ];
            // 原字段是字符串类型的话，把长度参数透传，避免映射不匹配
            if ($originalMapping['type'] === 'string' && isset($originalMapping['length'])) {
                $engOptions['length'] = $originalMapping['length'];
            }
            $builder->addField("{$baseName}Eng", $originalMapping['type'], $engOptions);

            // 动态加第三个字段：英文翻译的更新时间
            $builder->addField("{$baseName}EngUpdatedAt", 'datetime', [
                'nullable' => true,
                'columnName' => "{$baseName}_eng_updated_at"
            ]);
        }
    }
}

3. 注册事件监听 #

把这个监听器挂载到Doctrine的事件流上，比如Symfony环境下在服务配置里加标签就行：

App\EventListener\TranslatableMetadataListener:
    tags:
        - { name: doctrine.event_listener, event: loadClassMetadata }

配置完之后，只要是带@Translatable标记的属性，Doctrine加载实体的时候就会自动生成你想要的那三个关联字段，和手写的实体映射效果完全一致——不管你是在$text、$title还是$content属性上打标记，生成的字段名都会自动跟着当前属性名走，不会出现写死字段名的问题。

配套的时间戳自动更新逻辑 #

光加字段映射还不够，时间戳需要在对应字段变更的时候自动写入。可以在刚才的监听器里补充Doctrine的生命周期回调：

• 检测原属性值发生变化时，自动给{属性名}UpdatedAt赋值当前时间
• 检测英文翻译字段值发生变化时，自动给{属性名}EngUpdatedAt赋值当前时间
  这个逻辑只需要在prePersist、preUpdate事件里对比实体的原始状态和当前状态就能实现，不需要手动在每个setter方法里写赋值逻辑。

和Trait方案的对比 #

如果用Trait实现，本质是写死固定的属性名，比如Trait里定义的textUpdatedAt、textEng，换个$title属性用的时候，根本没法自动匹配命名，每个要翻译的字段都得写专属Trait，实体多了维护成本极高。这种元数据监听的方式，完全不用改实体代码，只要加个标记就行，扩展性和灵活度都高很多。

避坑提醒：动态加到元数据里的字段，实体类本身没有对应的属性定义，如果需要直接通过$this->xxx的方式读写这些字段，可以在监听器里通过反射给实体类动态加上对应属性和getter/setter方法，体验和手写实体完全没有区别。

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