4.6.x module.inc module_invoke_all()
4.7.x module.inc module_invoke_all()
5.x module.inc module_invoke_all()
6.x module.inc module_invoke_all()
7.x module.inc module_invoke_all($hook)

Invokes a hook in all enabled modules that implement it.

All arguments are passed by value. Use drupal_alter() if you need to pass arguments by reference.


$hook: The name of the hook to invoke.

...: Arguments to pass to the hook.

Return value

An array of return values of the hook implementations. If modules return arrays from their implementations, those are merged into one array recursively. Note: integer keys in arrays will be lost, as the merge is done using array_merge_recursive().

See also


Related topics

138 calls to module_invoke_all()
actions_delete in includes/actions.inc
Deletes a single action from the database.
actions_list in includes/actions.inc
Discovers all available actions by invoking hook_action_info().
aggregator_remove in modules/aggregator/aggregator.module
Removes all items from a feed.
ajax_footer in includes/ajax.inc
Performs end-of-Ajax-request tasks.
archiver_get_info in includes/common.inc
Retrieves a list of all available archivers.

... See full list


includes/module.inc, line 949
API for loading and interacting with Drupal modules.


function module_invoke_all($hook) {
  $args = func_get_args();

  // Remove $hook from the arguments.
  $return = array();
  foreach (module_implements($hook) as $module) {
    $function = $module . '_' . $hook;
    if (function_exists($function)) {
      $result = call_user_func_array($function, $args);
      if (isset($result) && is_array($result)) {
        $return = array_merge_recursive($return, $result);
      elseif (isset($result)) {
        $return[] = $result;
  return $return;


dwieeb’s picture

Unfortunately this function and module_invoke() do not allow passing variables by reference.

To work around this, you can do something like this:

foreach (module_implements('my_hook') as $module) {
  $function = $module . '_my_hook';
  $function($var1, $var2);

And, make sure to have the ampersand in the hook declaration:

function my_module_my_hook(&$var1, &$var2) {
  $var1 = 'do';
  $var2 = 'stuff';
dalin’s picture

If you want to pass things by reference, it's likely that you want to do
$modified_data = drupal_alter('my_type', $data);

aron.beal’s picture

I'm not disagreeing with the above, but take care; `drupal_alter` hook implementations typically do not return a value (because the data is passed by reference, it is modified in place without returning).

drclaw’s picture

There is an exception to passing by reference. If the arguments for the hook are Objects, then they are passed by reference. This is default behaviour of php:

http://php.net/manual/en/language.oop5.references.php .

An example of this in action is with the feeds hook hook_feeds_after_parse()


The hook is called using module_invoke_all, but you can, for example, remove all the


and the feeds import won't do anything.

ronyclau’s picture

If you really want to avoid a hook from altering your object, you may clone the object first as described in drupal_alter.

module_invoke_all('mydata_insert', clone $data_object);

Dubs’s picture

But again, be careful here. This is not a deep clone, so any child objects in objects, arrays, etc. could be altered.

alberto56’s picture

aaronbauman’s picture


module_invoke_all('node_view', $entity, $display, $entity_view_mode, $langcode);


\Drupal::moduleHandler()->invokeAll($view_hook, array($entity, $display, $entity_view_mode, $langcode));