如果我已经有了 hook_mail，那么还有 hook_mail_alter 有什么意义呢？

Question

如果我已经有了 hook_mail，那么还有 hook_mail_alter 有什么意义呢？

例如，我看到 hook_mail_alter 用于向我的邮件消息添加页脚。但我可以使用 hook_mail() 来添加它，而不是使用 2 个函数……我错过了什么？

也许是在调用其他函数之后添加页脚？

Answer 1

应该从模块中使用 hook_mail() 来更改其自己的邮件消息，而应该从模块中使用 hook_mail_alter() 来更改其他模块发送的消息。

从 drupal_mail() 中获取的以下代码可以清楚地看出这一点：

// Build the e-mail (get subject and body, allow additional headers) by
// invoking hook_mail() on this module. We cannot use module_invoke() as
// we need to have $message by reference in hook_mail().
if (function_exists($function = $module .'_mail')) {
  $function($key, $message, $params);
}

// Invoke hook_mail_alter() to allow all modules to alter the resulting e-mail.
drupal_alter('mail', $message);

$module 是传递给 drupal_mail() 的第一个参数。
很明显，该函数不会调用实现它的每个模块的 hook_mail() 实现，但它仅为调用该函数的模块调用钩子。

还有其他差异，例如调用两个钩子时（hook_mail_alter() 无法设置消息的语言，该语言是在调用 hook_mail_alter() 之前设置的），以及它们获取的参数（hook_mail($key, &$message, $params) 与 hook_mail_alter(&$message)）。