抱歉,这里没有不误导或混淆事物的简短答案。
要点 #1:Magento 核心团队不愿意从源代码树中删除或重命名方法。创业文化意味着他们避开测试,而且作为一个公共项目意味着他们无法控制人们对他们的产品做了什么。他们不会删除方法并冒险破坏事物,而是将调用新方法的方法留在原处。这样,即使有调用该方法的旧代码,它们也会被覆盖。
重要点#2:集合继承链是扭曲的,并且在代码库的某些部分应用不一致。这正在清理中,但它仍然很容易让您陷入困境。
重要点#3:我在推测这其中有多少是要被使用和发生的。我不是这里的最终权威,我只是试图理解它的人。以下细节参考 1.6,但概念适用于所有版本
所有集合都继承自类Varien_Data_Collection_Db。这是模拟“收集从数据库加载的一系列对象”的基本概念的类。这个类有一个方法addFieldToFilter。
public function addFieldToFilter($field, $condition=null)
{
$field = $this->_getMappedField($field);
$this->_select->where($this->_getConditionSql($field, $condition), null, Varien_Db_Select::TYPE_CONDITION);
return $this;
}
这是一个简单的实现,它在理论查询中添加了 where 子句。
接下来,有 两个 抽象类以 Varien_Data_Collection_Db 作为祖先。 Mage_Core_Model_Resource_Db_Collection_Abstract 和 Mage_Eav_Model_Entity_Collection_Abstract。
Mage_Core_Model_Resource_Db_Collection_Abstract 是“常规、非 EAV 模型”的集合类。它既没有addFieldToFilter 方法也没有addAttributeToFilter 方法。它依赖于基类 Varien_Data_Collection_Db 的实现。
Mage_Eav_Model_Entity_Collection_Abstract 是 EAV 模型的集合类。它有一个更复杂的addAttributeToFilter 方法。
public function addAttributeToFilter($attribute, $condition = null, $joinType = 'inner')
{
if ($attribute === null) {
$this->getSelect();
return $this;
}
if (is_numeric($attribute)) {
$attribute = $this->getEntity()->getAttribute($attribute)->getAttributeCode();
} else if ($attribute instanceof Mage_Eav_Model_Entity_Attribute_Interface) {
$attribute = $attribute->getAttributeCode();
}
if (is_array($attribute)) {
$sqlArr = array();
foreach ($attribute as $condition) {
$sqlArr[] = $this->_getAttributeConditionSql($condition['attribute'], $condition, $joinType);
}
$conditionSql = '('.implode(') OR (', $sqlArr).')';
} else if (is_string($attribute)) {
if ($condition === null) {
$condition = '';
}
$conditionSql = $this->_getAttributeConditionSql($attribute, $condition, $joinType);
}
if (!empty($conditionSql)) {
$this->getSelect()->where($conditionSql, null, Varien_Db_Select::TYPE_CONDITION);
} else {
Mage::throwException('Invalid attribute identifier for filter ('.get_class($attribute).')');
}
return $this;
}
这是因为属性查询不是直接的“位置”查询。此外,此方法被设计为采用属性名称、或属性数据库 ID、或实例化属性对象。您不是向过滤器添加字段,而是向过滤器添加属性。因此,根据 EAV 的实现以及属性存储在哪个表中,您需要添加不同的 SQL 代码位(主表上的直接 where 查询,添加连接表之一的 where 等)
这会产生问题。因为此 EAV 集合对象继承自基本集合对象,所以 addFieldToFilter 仍然存在,并且仍会向 EAV 查询添加基本的 where 条件,这可能会使最终用户感到困惑,因为他们没有按照他们的想法去做。所以EAV集合类也有这个
public function addFieldToFilter($attribute, $condition = null)
{
return $this->addAttributeToFilter($attribute, $condition);
}
它将对addFieldToFilter 的任何调用封装到addAttributeToFilter(同样,在 EAV 模型上)。因此,如果您有 EAV 模型,则可以使用 addFieldToFilter 或 addAttributeToFilter。如果您使用的是常规模型,您可以仅调用addFieldToFilter,addAttributeToFilter 不存在。
理想情况下,方法名称应该从一开始就统一,但是一旦拆分发生,Magento 团队选择继续支持拆分以支持向后兼容性。
等等,还有更多
代码库中有两个集合直接从 Varien_Data_Collection_Db 继承。它们是Mage_Sales_Model_Resource_Sale_Collection 和Mage_Review_Model_Resource_Review_Summary_Collection。这个数字在 Magento CE 1.6 之前的版本中更高。虽然这不会影响过滤问题,但它确实会混淆继承链,因此您应该注意它。
许多非 EAV 集合将实现自己的 addFieldToFilter 来对变量进行完整性检查,或者如果他们正在做一些不标准的事情,则稍微调整查询参数。
EAV 集合也通过重新定义addAttributeToFilter 参与了这一行动。同样,这样做是为了添加不适合基本 Magento 集合加载的自定义逻辑。