function hook_hook_info

Same name in other branches
  1. 9 core/lib/Drupal/Core/Extension/module.api.php \hook_hook_info()
  2. 8.9.x core/lib/Drupal/Core/Extension/module.api.php \hook_hook_info()
  3. 10 core/lib/Drupal/Core/Extension/module.api.php \hook_hook_info()
  4. 11.x core/lib/Drupal/Core/Extension/module.api.php \hook_hook_info()

Defines one or more hooks that are exposed by a module.

Normally hooks do not need to be explicitly defined. However, by declaring a hook explicitly, a module may define a "group" for it. Modules that implement a hook may then place their implementation in either $module.module or in $module.$group.inc. If the hook is located in $module.$group.inc, then that file will be automatically loaded when needed. In general, hooks that are rarely invoked and/or are very large should be placed in a separate include file, while hooks that are very short or very frequently called should be left in the main module file so that they are always available.

Return value

An associative array whose keys are hook names and whose values are an associative array containing:

  • group: A string defining the group to which the hook belongs. The module system will determine whether a file with the name $module.$group.inc exists, and automatically load it when required.

See system_hook_info() for all hook groups defined by Drupal core.

See also

hook_hook_info_alter().

Related topics

3 functions implement hook_hook_info()

Note: this list is generated by pattern matching, so it may include some functions that are not actually implementations of this hook.

module_hook_info in includes/module.inc
Retrieves a list of hooks that are declared through hook_hook_info().
module_test_hook_info in modules/simpletest/tests/module_test.module
Implements hook_hook_info().
system_hook_info in modules/system/system.module
Implements hook_hook_info().

File

modules/system/system.api.php, line 37

Code

function hook_hook_info() {
    $hooks['token_info'] = array(
        'group' => 'tokens',
    );
    $hooks['tokens'] = array(
        'group' => 'tokens',
    );
    return $hooks;
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.