5

什么将 Drupal Hook 与特定模块联系起来?

在 Drupal 7 中,每个核心模块都有一个“api”文件

$ ls modules/*/*.api.php
modules/aggregator/aggregator.api.php   modules/openid/openid.api.php
modules/block/block.api.php             modules/overlay/overlay.api.php
modules/comment/comment.api.php         modules/path/path.api.php
modules/contextual/contextual.api.php   modules/rdf/rdf.api.php
modules/dashboard/dashboard.api.php     modules/search/search.api.php
modules/field/field.api.php             modules/shortcut/shortcut.api.php
modules/field_ui/field_ui.api.php       modules/simpletest/simpletest.api.php
modules/file/file.api.php               modules/system/system.api.php
modules/filter/filter.api.php           modules/system/theme.api.php
modules/help/help.api.php               modules/taxonomy/taxonomy.api.php
modules/image/image.api.php             modules/trigger/trigger.api.php
modules/locale/locale.api.php           modules/update/update.api.php
modules/menu/menu.api.php               modules/user/user.api.php
modules/node/node.api.php

这些文件中的每一个都包含一个从未(?)调用的函数,但记录了其他模块(包括第 3 方)可以实现的钩子的存在。

File: modules/path/path.api.php
function hook_path_delete($path) {
  db_delete('mytable')
    ->condition('pid', $path['pid'])
    ->execute();
}

我的问题:是什么将特定的钩子与特定的模块联系起来?为什么path_delete钩子包含在path.api.php文件中?为什么entity_view钩子包含在system.api.php文件中?在事实组织之后,这只是任意的,还是 Drupal 系统中的某些东西将特定的钩子与特定的模块联系起来?或者是其他东西?

4

2 回答 2

5

使用module_invoke()and调用钩子module_invoke_all():如果您查看这两个函数的代码,您可能能够拼凑出它是如何工作的,但基本上,如果我将它添加到我的模块代码中:

// Other code

$foo = module_invoke_all('foo_bar', $var1, $var2);

// More code

Drupal 将调用hook_foo_bar($var1, $var2)它在启用的模块中找到的每个实现。基于此,您应该看到将特定钩子与特定模块联系起来的唯一东西是命名约定:如果我调用我的模块foo,我的钩子函数应该以hook_foo_.

您对被调用的任何事情都是正确的*.api.php:由于模块调用只是一个函数调用,因此模块作者foo.api.php仅出于文档目的而包含,以告知实现者如何实现钩子。

例如,在上述情况下,foo.api.php将包含一个示例函数,如:

/**
 * Doxygen comments documenting the function goes here
 */
function hook_foo_bar($var1, $var2) {
  return $var1 + $var2;
}

但作为模块实现者,我可以hook_foo_bar()用不同的方式实现:

function mymodule_foo_bar($var1, $var2) {
  return $var1 - $var2;
}

module_invoke_all()被调用时,Drupal 将使用实现模块的短名称 ( mymodule) 和传递给module_invoke_all()( foo_bar) 的钩子名称制作一个函数,从而调用mymodule_foo_bar()我刚刚定义的函数。

system核心模块有点包罗万象:Drupal 8 的一项任务是杀死并将其功能委托给其他模块。

于 2011-02-15T05:52:32.763 回答
0


也许你可以尝试学习挂钩drupal?这很容易:
http

://api.drupal.org/api/drupal/includes--module.inc/group/hooks/7 关于 hook_path_delete:
查看 path.module,您会在某处看到 path_delete(...) 调用。
例如,在 path_node_update() - 这个函数调用然后你改变当前路径 - 它之前删除旧路径,而不是为节点创建新路径。
现在查看定义 path_delete() 函数的位置 - 它位于 path.inc 文件中:
在此函数中,您将看到: module_invoke_all('path_delete', $path); - 这个函数有什么作用?
它列出了定义 hook_path_delete 的所有模块(在 drupal 7 中它被缓存)(如我之前所示,对于 yiu 自定义模块,它定义为 YOURMODULENAME_path_delete,它也将包括在这里),并一一运行所有这些函数(运行顺序由模块的权重和文件名定义)。
那么现在您可以在自定义模块中做什么?您可以对此删除反应做出响应并执行一些其他操作 - 例如,删除可用于复制该节点路径的其他路径(这只是示例)。

ps 启动自定义模块的好点:http: //drupal.org/contributors-guide

于 2011-02-15T04:51:31.733 回答