magento - 浏览 Magento 文档时遇到问题

Question

我是 Magento 的新手，文档(主要是 phpDocs)很难浏览。例如，

$attributeSet = Mage::getModel('eav/entity_attribute_set')->load($id);

在 Class Mage_Eav_Model_Entity_Attribute_Set 的 php 文档中无论是在继承方法中还是其他方法中都没有提及 getAttributeSetName() 方法，但这仍然有效。

$attributeSet = Mage::getModel('eav/entity_attribute_set')->load($id);
echo $attributeSet->getAttributeSetName();

所以我想我有几个问题。

1. 有人可以向我解释为什么文档是这样的吗？
2. 在 phpDocs 中哪里可以找到神秘的 getAttributeSetName() 方法？

我的理论是，存在一些我不理解的继承或设计模式实现，也许有人可以为我阐明这一点。

Answer 1

如果你真的想绞尽脑汁，请看一下Mage_Eav_Model_Entity_Attribute_Set的源代码，并沿着继承链一路往回走。您不会在任何地方找到定义的 getAttributeSetName 方法。

从 Varien_Object 继承的所有 Magento 对象都可以设置任意数据成员。试试这个。

$attributeSet = Mage::getModel('eav/entity_attribute_set')->load($id);
$attributeSet->setFooBazBar('Value');
var_dump($attributeSet->getFooBazBar());
var_dump($attributeSet->getData('foo_baz_bar'));
var_dump($attributeSet->setData('foo_baz_bar','New Value'));
var_dump($attributeSet->getFooBazBar());

您还可以使用

获取所有数据成员

var_dump($attributeSet->getData());

但要小心转储这些，因为如果有一个具有循环引用的数据对象，并且您没有使用 xDebug 之类的东西，那么 PHP 将尝试显示该对象。

Magento 将数据属性存储在特殊的 _data 数组属性中。您可以使用 getData 和 setData 获取/设置此数组中的值。 Magento 还实现了神奇的获取和设置方法，所以当你说类似

$object->getFooBazBar();

方法getFooBazBar被转换为数据属性foo_baz_bar。然后使用此属性调用 getData。理解起来有点困难，但是一旦理解了，您就会开始看到使用这种模式可以节省多少时间。

当然，这样做的一个副作用是，不可能通过查看对象的类文件来推断任何对象可能具有哪些数据属性，因此这些方法没有 phpDocs。