作者:老葛,北京亚艾元软件有限责任公司,http://www.yaiyuan.com
还可以为查询添加一些元数据,从而为alter钩子提供附加的上下文信息。元数据可以是任意的PHP变量,也可以用一个字符串作为键。
<?php
$node = node_load($nid);
// ... Create a $query object here.
$query->addMetaData('node', $node);
?>
元数据没有内在的意义,它本身对查询对象没有任何影响。它的存在仅仅是为了向alter钩子提供附加信息,并且通常只有当查询具有特定标签时才起作用。
为了访问一个查询上的给定元数据,使用getMetaData()方法。
<?php
$node = $query->getMetaData('node');
?>
如果没有为该键指定元数据,那么将会返回NULL。