为什么我不能在理论实体中使用公共属性？

Question

假设我有一个非常简单的PHP CRUD系统来管理数据库。假设它有一个产品列表。使用Doctrine ORM，我想查询数据库并查看/编辑/添加记录。根据入门手册，

创建实体类时，所有字段都应该是受保护的或私有的（不是公共的），每个字段都有getter和setter方法（除了$id）。使用变异子可以让条令钩住调用，这些调用以一种如果直接使用entity#field=foo设置值就无法实现的方式操纵实体；

这是提供的样本：

// src/Product.php
class Product
{
    /**
     * @var int
     */
    protected $id;
    /**
     * @var string
     */
    protected $name;

    public function getId()
    {
        return $this->id;
    }

    public function getName()
    {
        return $this->name;
    }

    public function setName($name)
    {
        $this->name = $name;
    }
}

// Recording a new title
$product->setName("My new name");
$db->persist($product);
$db->flush();

// Echoing the title
echo $product->getName();

然而，这似乎过于复杂。假设我不需要钩住调用来操作实体，如手册中所述。我可以让这段代码更短，这样做：

// src/Product.php
class Product
{
    /**
     * @var int
     */
    public $id;
    /**
     * @var string
     */
    public $name;
}

这将允许这样的事情：

$product = $db->getRepository('Product')->find(1);

// Recording a new name
$product->name = "My new title";
$db->persist($product);
$db->flush();

// Echoing the title
echo $product->name;

优点是：

• 始终使用完全相同的名称

使用此选项的缺点是什么？我在这里是不是在冒险？

Answer 1

为什么不在条令中使用公共实体类？

实际上，你要问的是：

这个能手/二传手来自哪里？

它来自于OOP中的封装。

那么，什么是封装？

这是我们定义属性和方法可见性的方式。在创建类时，您必须问问自己在类之外可以访问哪些属性和方法。

假设我们有一个名为id的属性。如果一个类扩展了您的类，是否允许它直接操作和访问id？如果有人创建了你的类的实例呢？是否允许他们操纵和访问id？

不它们不应该能够直接访问id属性。

为什么不呢？

示例：如果您只接受以“IX”开头的发票标识，而其他类可以访问您的类，并且它们直接设置invoice_id，会发生什么？

如果他们不小心将发票id设置为“XX12345”，会发生什么情况？

当然，您不能做任何事情（比如验证输入），因为您使用的是公共属性，而没有setters。

但是如果你在你的类中有一个setter方法，你可以这样做

private $invoiceId;

public function setInvoiceId($invoiceId) 
{
    if (is_null($invoiceId) || preg_match("#^IX(.*)$#i", $invoiceId) === 0)
        return false;

    $this->invoiceId = $invoiceId;

    return $this;
}

我希望一切都很清楚。我将尝试扩展答案

Answer 2

假设我不需要挂接调用来操纵实体，如手册中所述。

您不需要挂接这些调用，但Doctrine确实需要。条令在内部覆盖这些getter和setter，以尽可能透明地实现ORM。

是的，它过于复杂，但这是PHP语言的错，而不是教义。使用公共属性本身没有什么问题，只是PHP语言不允许像其他一些语言（如静态编程语言、C#）那样创建自定义getters/setters。

学说到底是做什么的？它生成所谓的代理对象来实现延迟加载。这些对象扩展了类并覆盖了某些方法。

// src/Product.php
class Product
{
    /**
     * @var int
     */
    protected $id;
    /**
     * @var string
     */
    protected $name;

    public function getId()
    {
        return $this->id;
    }

    public function getName()
    {
        return $this->name;
    }

    public function setName($name)
    {
        $this->name = $name;
    }
}

学说可能会产生：

class Product extends \YourNamespace\Product implements \Doctrine\ORM\Proxy\Proxy
{

    // ... Lots of generated methods ...

    public function getId(): int
    {
        if ($this->__isInitialized__ === false) {
            return (int)  parent::getId();
        }


        $this->__initializer__ && $this->__initializer__->__invoke($this, 'getId', []);

        return parent::getId();
    }

    public function getName(): string
    {

        $this->__initializer__ && $this->__initializer__->__invoke($this, 'getName', []);

        return parent::getName();
    }

    // ... More generated methods ...
}

（这并不是重点，重点是条令必须能够覆盖getter和setter来实现ORM）

要亲自查看，请检查Doctrine代理目录中生成的代理对象。有关配置代理目录的更多信息，请参阅高级配置部分。另请参见使用对象，以了解有关代理对象以及Doctrine如何利用它们的更多信息。