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 (...).