Drupal: когда-нибудь вызывались функции hook_ в *.api.php?

Question

В Drupal 7 каждый основной модуль имеет *.api.php файл, где * - имя модуля. Например

modules/node/node.api.php
modules/path/path.api.php

Для чего эти файлы? Они содержат функции, которые начинаются с hook_и имя хука, который (я думаю) вызывает модуль. Например

modules/system/system.api

имеет

function hook_entity_view($entity, $type, $view_mode, $langcode) {
  $entity->content['my_additional_field'] = array(
    '#markup' => $additional_field,
    '#weight' => 10,
    '#theme' => 'mymodule_my_additional_field',
  );
}

Там есть entity_view хук, который вызывается системой, которую вы можете реализовать в своих собственных модулях, но (она не появляется), что hook_entity_view когда-либо называется.

Для чего эти функции? Они когда-либо вызваны системой? Если да, то когда? Если нет, то почему они там?

Answer 1

Нет, это просто файлы документации, которые описывают хуки по модулям. О hook_entity_view: вы можете добавить его в пользовательский модуль: YOURMODULENAME_entity_view(...).