如何在Doctrine中创建不关联数据库列的虚拟属性fullName？

首先明确：Doctrine ORM没有内置支持无需手动调用方法的虚拟属性映射，你示例代码中给$fullName添加@ORM\Column注解的做法是错误的——这会让Doctrine将其视为数据库列，而你的表中并没有这个字段，运行时会抛出映射异常。另外你构造函数中的赋值逻辑也有问题（重复拼接了firstname，且初始化时firstname和lastname均为null，得到的结果无意义）。

如果你想实现不关联数据库列、直接通过属性名访问（无需手动调用getFullName()）、不依赖QueryBuilder的虚拟属性，可以通过PHP自身特性实现，以下是两种可行方案：

方案1：使用PHP魔术方法__get() #

通过魔术方法拦截属性访问，当访问$fullName时自动计算返回结果：

/**
 * @ORM\Entity()
 */
class Person
{
    /**
     * @ORM\Column(name="LASTNAME", type="string", length=100, nullable=true)
     */
    private ?string $lastname = null;

    /**
     * @ORM\Column(name="FIRSTNAME", type="string", length=100, nullable=true)
     */
    private ?string $firstname = null;

    // 虚拟属性，无需ORM注解
    private ?string $fullName = null;

    /**
     * 拦截属性访问
     */
    public function __get(string $name): mixed
    {
        if ($name === 'fullName') {
            // 拼接并去除首尾空格，避免空值导致的多余空格
            return trim(sprintf('%s %s', $this->firstname ?? '', $this->lastname ?? ''));
        }

        // 对其他未定义属性抛出异常，或根据需求处理
        throw new \RuntimeException(sprintf('Undefined property: %s::$%s', self::class, $name));
    }

    /**
     * 可选：支持isset($person->fullName)判断
     */
    public function __isset(string $name): bool
    {
        if ($name === 'fullName') {
            return true;
        }
        return property_exists($this, $name);
    }

    // 常规的getter/setter方法（按需保留）
    public function getFirstname(): ?string
    {
        return $this->firstname;
    }

    public function setFirstname(?string $firstname): self
    {
        $this->firstname = $firstname;
        return $this;
    }

    public function getLastname(): ?string
    {
        return $this->lastname;
    }

    public function setLastname(?string $lastname): self
    {
        $this->lastname = $lastname;
        return $this;
    }
}

使用时直接访问属性即可：

$person = new Person();
$person->setFirstname('John');
$person->setLastname('Doe');
echo $person->fullName; // 输出 "John Doe"

方案2：PHP 8.1+ 计算属性（推荐） #

利用PHP 8.1引入的只读计算属性，通过方法模拟属性访问，语法更直观：

/**
 * @ORM\Entity()
 */
class Person
{
    /**
     * @ORM\Column(name="LASTNAME", type="string", length=100, nullable=true)
     */
    private ?string $lastname = null;

    /**
     * @ORM\Column(name="FIRSTNAME", type="string", length=100, nullable=true)
     */
    private ?string $firstname = null;

    /**
     * 计算属性，直接通过$person->fullName访问
     */
    public function get fullName(): string
    {
        return trim(sprintf('%s %s', $this->firstname ?? '', $this->lastname ?? ''));
    }

    // 常规getter/setter
    public function getFirstname(): ?string
    {
        return $this->firstname;
    }

    public function setFirstname(?string $firstname): self
    {
        $this->firstname = $firstname;
        return $this;
    }

    public function getLastname(): ?string
    {
        return $this->lastname;
    }

    public function setLastname(?string $lastname): self
    {
        $this->lastname = $lastname;
        return $this;
    }
}

这种方式无需魔术方法，直接通过$person->fullName访问，符合PHP现代语法规范，代码可读性更高。

注意事项 #

• 以上方案均在内存中计算虚拟属性值，不会涉及数据库查询，完全不需要依赖QueryBuilder。
• 虚拟属性无法作为Doctrine查询的条件（比如WHERE fullName = 'xxx'），因为数据库中不存在该字段；如果需要基于虚拟属性查询，仍需手动拼接QueryBuilder条件（比如WHERE firstname || ' ' || lastname = 'xxx'），但这和你需求中的"不想自行通过QueryBuilder实现"不冲突——日常访问属性不需要QueryBuilder，只有查询时才会涉及。

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