|
1
|
<?php
|
|
2
|
|
|
3
|
/**
|
|
4
|
* @file
|
|
5
|
* API for loading and interacting with Drupal modules.
|
|
6
|
*/
|
|
7
|
|
|
8
|
/**
|
|
9
|
* Loads all the modules that have been enabled in the system table.
|
|
10
|
*
|
|
11
|
* @param $bootstrap
|
|
12
|
* Whether to load only the reduced set of modules loaded in "bootstrap mode"
|
|
13
|
* for cached pages. See bootstrap.inc.
|
|
14
|
*
|
|
15
|
* @return
|
|
16
|
* If $bootstrap is NULL, return a boolean indicating whether all modules
|
|
17
|
* have been loaded.
|
|
18
|
*/
|
|
19
|
function module_load_all($bootstrap = FALSE) {
|
|
20
|
static $has_run = FALSE;
|
|
21
|
|
|
22
|
if (isset($bootstrap)) {
|
|
23
|
foreach (module_list(TRUE, $bootstrap) as $module) {
|
|
24
|
drupal_load('module', $module);
|
|
25
|
}
|
|
26
|
// $has_run will be TRUE if $bootstrap is FALSE.
|
|
27
|
$has_run = !$bootstrap;
|
|
28
|
}
|
|
29
|
return $has_run;
|
|
30
|
}
|
|
31
|
|
|
32
|
|
|
33
|
/**
|
|
34
|
* Returns a list of currently active modules.
|
|
35
|
*
|
|
36
|
* Usually, this returns a list of all enabled modules. When called early on in
|
|
37
|
* the bootstrap, it will return a list of vital modules only (those needed to
|
|
38
|
* generate cached pages).
|
|
39
|
*
|
|
40
|
* All parameters to this function are optional and should generally not be
|
|
41
|
* changed from their defaults.
|
|
42
|
*
|
|
43
|
* @param $refresh
|
|
44
|
* (optional) Whether to force the module list to be regenerated (such as
|
|
45
|
* after the administrator has changed the system settings). Defaults to
|
|
46
|
* FALSE.
|
|
47
|
* @param $bootstrap_refresh
|
|
48
|
* (optional) When $refresh is TRUE, setting $bootstrap_refresh to TRUE forces
|
|
49
|
* the module list to be regenerated using the reduced set of modules loaded
|
|
50
|
* in "bootstrap mode" for cached pages. Otherwise, setting $refresh to TRUE
|
|
51
|
* generates the complete list of enabled modules.
|
|
52
|
* @param $sort
|
|
53
|
* (optional) By default, modules are ordered by weight and module name. Set
|
|
54
|
* this option to TRUE to return a module list ordered only by module name.
|
|
55
|
* @param $fixed_list
|
|
56
|
* (optional) If an array of module names is provided, this will override the
|
|
57
|
* module list with the given set of modules. This will persist until the next
|
|
58
|
* call with $refresh set to TRUE or with a new $fixed_list passed in. This
|
|
59
|
* parameter is primarily intended for internal use (e.g., in install.php and
|
|
60
|
* update.php).
|
|
61
|
*
|
|
62
|
* @return
|
|
63
|
* An associative array whose keys and values are the names of the modules in
|
|
64
|
* the list.
|
|
65
|
*/
|
|
66
|
function module_list($refresh = FALSE, $bootstrap_refresh = FALSE, $sort = FALSE, $fixed_list = NULL) {
|
|
67
|
static $list = array(), $sorted_list;
|
|
68
|
|
|
69
|
if (empty($list) || $refresh || $fixed_list) {
|
|
70
|
$list = array();
|
|
71
|
$sorted_list = NULL;
|
|
72
|
if ($fixed_list) {
|
|
73
|
foreach ($fixed_list as $name => $module) {
|
|
74
|
drupal_get_filename('module', $name, $module['filename']);
|
|
75
|
$list[$name] = $name;
|
|
76
|
}
|
|
77
|
}
|
|
78
|
else {
|
|
79
|
if ($refresh) {
|
|
80
|
// For the $refresh case, make sure that system_list() returns fresh
|
|
81
|
// data.
|
|
82
|
drupal_static_reset('system_list');
|
|
83
|
}
|
|
84
|
if ($bootstrap_refresh) {
|
|
85
|
$list = system_list('bootstrap');
|
|
86
|
}
|
|
87
|
else {
|
|
88
|
// Not using drupal_map_assoc() here as that requires common.inc.
|
|
89
|
$list = array_keys(system_list('module_enabled'));
|
|
90
|
$list = (!empty($list) ? array_combine($list, $list) : array());
|
|
91
|
}
|
|
92
|
}
|
|
93
|
}
|
|
94
|
if ($sort) {
|
|
95
|
if (!isset($sorted_list)) {
|
|
96
|
$sorted_list = $list;
|
|
97
|
ksort($sorted_list);
|
|
98
|
}
|
|
99
|
return $sorted_list;
|
|
100
|
}
|
|
101
|
return $list;
|
|
102
|
}
|
|
103
|
|
|
104
|
/**
|
|
105
|
* Builds a list of bootstrap modules and enabled modules and themes.
|
|
106
|
*
|
|
107
|
* @param $type
|
|
108
|
* The type of list to return:
|
|
109
|
* - module_enabled: All enabled modules.
|
|
110
|
* - bootstrap: All enabled modules required for bootstrap.
|
|
111
|
* - theme: All themes.
|
|
112
|
*
|
|
113
|
* @return
|
|
114
|
* An associative array of modules or themes, keyed by name. For $type
|
|
115
|
* 'bootstrap', the array values equal the keys. For $type 'module_enabled'
|
|
116
|
* or 'theme', the array values are objects representing the respective
|
|
117
|
* database row, with the 'info' property already unserialized.
|
|
118
|
*
|
|
119
|
* @see module_list()
|
|
120
|
* @see list_themes()
|
|
121
|
*/
|
|
122
|
function system_list($type) {
|
|
123
|
$lists = &drupal_static(__FUNCTION__);
|
|
124
|
|
|
125
|
// For bootstrap modules, attempt to fetch the list from cache if possible.
|
|
126
|
// if not fetch only the required information to fire bootstrap hooks
|
|
127
|
// in case we are going to serve the page from cache.
|
|
128
|
if ($type == 'bootstrap') {
|
|
129
|
if (isset($lists['bootstrap'])) {
|
|
130
|
return $lists['bootstrap'];
|
|
131
|
}
|
|
132
|
if ($cached = cache_get('bootstrap_modules', 'cache_bootstrap')) {
|
|
133
|
$bootstrap_list = $cached->data;
|
|
134
|
}
|
|
135
|
else {
|
|
136
|
$bootstrap_list = db_query("SELECT name, filename FROM {system} WHERE status = 1 AND bootstrap = 1 AND type = 'module' ORDER BY weight ASC, name ASC")->fetchAllAssoc('name');
|
|
137
|
cache_set('bootstrap_modules', $bootstrap_list, 'cache_bootstrap');
|
|
138
|
}
|
|
139
|
// To avoid a separate database lookup for the filepath, prime the
|
|
140
|
// drupal_get_filename() static cache for bootstrap modules only.
|
|
141
|
// The rest is stored separately to keep the bootstrap module cache small.
|
|
142
|
foreach ($bootstrap_list as $module) {
|
|
143
|
drupal_get_filename('module', $module->name, $module->filename);
|
|
144
|
}
|
|
145
|
// We only return the module names here since module_list() doesn't need
|
|
146
|
// the filename itself.
|
|
147
|
$lists['bootstrap'] = array_keys($bootstrap_list);
|
|
148
|
}
|
|
149
|
// Otherwise build the list for enabled modules and themes.
|
|
150
|
elseif (!isset($lists['module_enabled'])) {
|
|
151
|
if ($cached = cache_get('system_list', 'cache_bootstrap')) {
|
|
152
|
$lists = $cached->data;
|
|
153
|
}
|
|
154
|
else {
|
|
155
|
$lists = array(
|
|
156
|
'module_enabled' => array(),
|
|
157
|
'theme' => array(),
|
|
158
|
'filepaths' => array(),
|
|
159
|
);
|
|
160
|
// The module name (rather than the filename) is used as the fallback
|
|
161
|
// weighting in order to guarantee consistent behavior across different
|
|
162
|
// Drupal installations, which might have modules installed in different
|
|
163
|
// locations in the file system. The ordering here must also be
|
|
164
|
// consistent with the one used in module_implements().
|
|
165
|
$result = db_query("SELECT * FROM {system} WHERE type = 'theme' OR (type = 'module' AND status = 1) ORDER BY weight ASC, name ASC");
|
|
166
|
foreach ($result as $record) {
|
|
167
|
$record->info = unserialize($record->info);
|
|
168
|
// Build a list of all enabled modules.
|
|
169
|
if ($record->type == 'module') {
|
|
170
|
$lists['module_enabled'][$record->name] = $record;
|
|
171
|
}
|
|
172
|
// Build a list of themes.
|
|
173
|
if ($record->type == 'theme') {
|
|
174
|
$lists['theme'][$record->name] = $record;
|
|
175
|
}
|
|
176
|
// Build a list of filenames so drupal_get_filename can use it.
|
|
177
|
if ($record->status) {
|
|
178
|
$lists['filepaths'][] = array('type' => $record->type, 'name' => $record->name, 'filepath' => $record->filename);
|
|
179
|
}
|
|
180
|
}
|
|
181
|
foreach ($lists['theme'] as $key => $theme) {
|
|
182
|
if (!empty($theme->info['base theme'])) {
|
|
183
|
// Make a list of the theme's base themes.
|
|
184
|
require_once DRUPAL_ROOT . '/includes/theme.inc';
|
|
185
|
$lists['theme'][$key]->base_themes = drupal_find_base_themes($lists['theme'], $key);
|
|
186
|
// Don't proceed if there was a problem with the root base theme.
|
|
187
|
if (!current($lists['theme'][$key]->base_themes)) {
|
|
188
|
continue;
|
|
189
|
}
|
|
190
|
// Determine the root base theme.
|
|
191
|
$base_key = key($lists['theme'][$key]->base_themes);
|
|
192
|
// Add to the list of sub-themes for each of the theme's base themes.
|
|
193
|
foreach (array_keys($lists['theme'][$key]->base_themes) as $base_theme) {
|
|
194
|
$lists['theme'][$base_theme]->sub_themes[$key] = $lists['theme'][$key]->info['name'];
|
|
195
|
}
|
|
196
|
// Add the base theme's theme engine info.
|
|
197
|
$lists['theme'][$key]->info['engine'] = isset($lists['theme'][$base_key]->info['engine']) ? $lists['theme'][$base_key]->info['engine'] : 'theme';
|
|
198
|
}
|
|
199
|
else {
|
|
200
|
// A plain theme is its own engine.
|
|
201
|
$base_key = $key;
|
|
202
|
if (!isset($lists['theme'][$key]->info['engine'])) {
|
|
203
|
$lists['theme'][$key]->info['engine'] = 'theme';
|
|
204
|
}
|
|
205
|
}
|
|
206
|
// Set the theme engine prefix.
|
|
207
|
$lists['theme'][$key]->prefix = ($lists['theme'][$key]->info['engine'] == 'theme') ? $base_key : $lists['theme'][$key]->info['engine'];
|
|
208
|
}
|
|
209
|
cache_set('system_list', $lists, 'cache_bootstrap');
|
|
210
|
}
|
|
211
|
// To avoid a separate database lookup for the filepath, prime the
|
|
212
|
// drupal_get_filename() static cache with all enabled modules and themes.
|
|
213
|
foreach ($lists['filepaths'] as $item) {
|
|
214
|
drupal_get_filename($item['type'], $item['name'], $item['filepath']);
|
|
215
|
}
|
|
216
|
}
|
|
217
|
|
|
218
|
return $lists[$type];
|
|
219
|
}
|
|
220
|
|
|
221
|
/**
|
|
222
|
* Resets all system_list() caches.
|
|
223
|
*/
|
|
224
|
function system_list_reset() {
|
|
225
|
drupal_static_reset('system_list');
|
|
226
|
drupal_static_reset('system_rebuild_module_data');
|
|
227
|
drupal_static_reset('list_themes');
|
|
228
|
cache_clear_all('bootstrap_modules', 'cache_bootstrap');
|
|
229
|
cache_clear_all('system_list', 'cache_bootstrap');
|
|
230
|
}
|
|
231
|
|
|
232
|
/**
|
|
233
|
* Determines which modules require and are required by each module.
|
|
234
|
*
|
|
235
|
* @param $files
|
|
236
|
* The array of filesystem objects used to rebuild the cache.
|
|
237
|
*
|
|
238
|
* @return
|
|
239
|
* The same array with the new keys for each module:
|
|
240
|
* - requires: An array with the keys being the modules that this module
|
|
241
|
* requires.
|
|
242
|
* - required_by: An array with the keys being the modules that will not work
|
|
243
|
* without this module.
|
|
244
|
*/
|
|
245
|
function _module_build_dependencies($files) {
|
|
246
|
require_once DRUPAL_ROOT . '/includes/graph.inc';
|
|
247
|
foreach ($files as $filename => $file) {
|
|
248
|
$graph[$file->name]['edges'] = array();
|
|
249
|
if (isset($file->info['dependencies']) && is_array($file->info['dependencies'])) {
|
|
250
|
foreach ($file->info['dependencies'] as $dependency) {
|
|
251
|
$dependency_data = drupal_parse_dependency($dependency);
|
|
252
|
$graph[$file->name]['edges'][$dependency_data['name']] = $dependency_data;
|
|
253
|
}
|
|
254
|
}
|
|
255
|
}
|
|
256
|
drupal_depth_first_search($graph);
|
|
257
|
foreach ($graph as $module => $data) {
|
|
258
|
$files[$module]->required_by = isset($data['reverse_paths']) ? $data['reverse_paths'] : array();
|
|
259
|
$files[$module]->requires = isset($data['paths']) ? $data['paths'] : array();
|
|
260
|
$files[$module]->sort = $data['weight'];
|
|
261
|
}
|
|
262
|
return $files;
|
|
263
|
}
|
|
264
|
|
|
265
|
/**
|
|
266
|
* Determines whether a given module exists.
|
|
267
|
*
|
|
268
|
* @param string $module
|
|
269
|
* The name of the module (without the .module extension).
|
|
270
|
*
|
|
271
|
* @return bool
|
|
272
|
* TRUE if the module is both installed and enabled, FALSE otherwise.
|
|
273
|
*/
|
|
274
|
function module_exists($module) {
|
|
275
|
$list = module_list();
|
|
276
|
return isset($list[$module]);
|
|
277
|
}
|
|
278
|
|
|
279
|
/**
|
|
280
|
* Loads a module's installation hooks.
|
|
281
|
*
|
|
282
|
* @param $module
|
|
283
|
* The name of the module (without the .module extension).
|
|
284
|
*
|
|
285
|
* @return
|
|
286
|
* The name of the module's install file, if successful; FALSE otherwise.
|
|
287
|
*/
|
|
288
|
function module_load_install($module) {
|
|
289
|
// Make sure the installation API is available
|
|
290
|
include_once DRUPAL_ROOT . '/includes/install.inc';
|
|
291
|
|
|
292
|
return module_load_include('install', $module);
|
|
293
|
}
|
|
294
|
|
|
295
|
/**
|
|
296
|
* Loads a module include file.
|
|
297
|
*
|
|
298
|
* Examples:
|
|
299
|
* @code
|
|
300
|
* // Load node.admin.inc from the node module.
|
|
301
|
* module_load_include('inc', 'node', 'node.admin');
|
|
302
|
* // Load content_types.inc from the node module.
|
|
303
|
* module_load_include('inc', 'node', 'content_types');
|
|
304
|
* @endcode
|
|
305
|
*
|
|
306
|
* Do not use this function to load an install file, use module_load_install()
|
|
307
|
* instead. Do not use this function in a global context since it requires
|
|
308
|
* Drupal to be fully bootstrapped, use require_once DRUPAL_ROOT . '/path/file'
|
|
309
|
* instead.
|
|
310
|
*
|
|
311
|
* @param $type
|
|
312
|
* The include file's type (file extension).
|
|
313
|
* @param $module
|
|
314
|
* The module to which the include file belongs.
|
|
315
|
* @param $name
|
|
316
|
* (optional) The base file name (without the $type extension). If omitted,
|
|
317
|
* $module is used; i.e., resulting in "$module.$type" by default.
|
|
318
|
*
|
|
319
|
* @return
|
|
320
|
* The name of the included file, if successful; FALSE otherwise.
|
|
321
|
*/
|
|
322
|
function module_load_include($type, $module, $name = NULL) {
|
|
323
|
static $files = array();
|
|
324
|
|
|
325
|
if (!isset($name)) {
|
|
326
|
$name = $module;
|
|
327
|
}
|
|
328
|
|
|
329
|
$key = $type . ':' . $module . ':' . $name;
|
|
330
|
if (isset($files[$key])) {
|
|
331
|
return $files[$key];
|
|
332
|
}
|
|
333
|
|
|
334
|
if (function_exists('drupal_get_path')) {
|
|
335
|
$file = DRUPAL_ROOT . '/' . drupal_get_path('module', $module) . "/$name.$type";
|
|
336
|
if (is_file($file)) {
|
|
337
|
require_once $file;
|
|
338
|
$files[$key] = $file;
|
|
339
|
return $file;
|
|
340
|
}
|
|
341
|
else {
|
|
342
|
$files[$key] = FALSE;
|
|
343
|
}
|
|
344
|
}
|
|
345
|
return FALSE;
|
|
346
|
}
|
|
347
|
|
|
348
|
/**
|
|
349
|
* Loads an include file for each module enabled in the {system} table.
|
|
350
|
*/
|
|
351
|
function module_load_all_includes($type, $name = NULL) {
|
|
352
|
$modules = module_list();
|
|
353
|
foreach ($modules as $module) {
|
|
354
|
module_load_include($type, $module, $name);
|
|
355
|
}
|
|
356
|
}
|
|
357
|
|
|
358
|
/**
|
|
359
|
* Enables or installs a given list of modules.
|
|
360
|
*
|
|
361
|
* Definitions:
|
|
362
|
* - "Enabling" is the process of activating a module for use by Drupal.
|
|
363
|
* - "Disabling" is the process of deactivating a module.
|
|
364
|
* - "Installing" is the process of enabling it for the first time or after it
|
|
365
|
* has been uninstalled.
|
|
366
|
* - "Uninstalling" is the process of removing all traces of a module.
|
|
367
|
*
|
|
368
|
* Order of events:
|
|
369
|
* - Gather and add module dependencies to $module_list (if applicable).
|
|
370
|
* - For each module that is being enabled:
|
|
371
|
* - Install module schema and update system registries and caches.
|
|
372
|
* - If the module is being enabled for the first time or had been
|
|
373
|
* uninstalled, invoke hook_install() and add it to the list of installed
|
|
374
|
* modules.
|
|
375
|
* - Invoke hook_enable().
|
|
376
|
* - Invoke hook_modules_installed().
|
|
377
|
* - Invoke hook_modules_enabled().
|
|
378
|
*
|
|
379
|
* @param string[] $module_list
|
|
380
|
* An array of module names.
|
|
381
|
* @param bool $enable_dependencies
|
|
382
|
* If TRUE, dependencies will automatically be added and enabled in the
|
|
383
|
* correct order. This incurs a significant performance cost, so use FALSE
|
|
384
|
* if you know $module_list is already complete and in the correct order.
|
|
385
|
*
|
|
386
|
* @return bool
|
|
387
|
* FALSE if one or more dependencies are missing, TRUE otherwise.
|
|
388
|
*
|
|
389
|
* @see hook_install()
|
|
390
|
* @see hook_enable()
|
|
391
|
* @see hook_modules_installed()
|
|
392
|
* @see hook_modules_enabled()
|
|
393
|
* @see module_disable()
|
|
394
|
* @see drupal_uninstall_modules()
|
|
395
|
*/
|
|
396
|
function module_enable($module_list, $enable_dependencies = TRUE) {
|
|
397
|
if ($enable_dependencies) {
|
|
398
|
// Get all module data so we can find dependencies and sort.
|
|
399
|
$module_data = system_rebuild_module_data();
|
|
400
|
// Create an associative array with weights as values.
|
|
401
|
$module_list = array_flip(array_values($module_list));
|
|
402
|
|
|
403
|
while (list($module) = each($module_list)) {
|
|
404
|
if (!isset($module_data[$module])) {
|
|
405
|
// This module is not found in the filesystem, abort.
|
|
406
|
return FALSE;
|
|
407
|
}
|
|
408
|
if ($module_data[$module]->status) {
|
|
409
|
// Skip already enabled modules.
|
|
410
|
unset($module_list[$module]);
|
|
411
|
continue;
|
|
412
|
}
|
|
413
|
$module_list[$module] = $module_data[$module]->sort;
|
|
414
|
|
|
415
|
// Add dependencies to the list, with a placeholder weight.
|
|
416
|
// The new modules will be processed as the while loop continues.
|
|
417
|
foreach (array_keys($module_data[$module]->requires) as $dependency) {
|
|
418
|
if (!isset($module_list[$dependency])) {
|
|
419
|
$module_list[$dependency] = 0;
|
|
420
|
}
|
|
421
|
}
|
|
422
|
}
|
|
423
|
|
|
424
|
if (!$module_list) {
|
|
425
|
// Nothing to do. All modules already enabled.
|
|
426
|
return TRUE;
|
|
427
|
}
|
|
428
|
|
|
429
|
// Sort the module list by pre-calculated weights.
|
|
430
|
arsort($module_list);
|
|
431
|
$module_list = array_keys($module_list);
|
|
432
|
}
|
|
433
|
|
|
434
|
// Required for module installation checks.
|
|
435
|
include_once DRUPAL_ROOT . '/includes/install.inc';
|
|
436
|
|
|
437
|
$modules_installed = array();
|
|
438
|
$modules_enabled = array();
|
|
439
|
foreach ($module_list as $module) {
|
|
440
|
// Only process modules that are not already enabled.
|
|
441
|
$existing = db_query("SELECT status FROM {system} WHERE type = :type AND name = :name", array(
|
|
442
|
':type' => 'module',
|
|
443
|
':name' => $module))
|
|
444
|
->fetchObject();
|
|
445
|
if ($existing->status == 0) {
|
|
446
|
// Load the module's code.
|
|
447
|
drupal_load('module', $module);
|
|
448
|
module_load_install($module);
|
|
449
|
|
|
450
|
// Update the database and module list to reflect the new module. This
|
|
451
|
// needs to be done first so that the module's hook implementations,
|
|
452
|
// hook_schema() in particular, can be called while it is being
|
|
453
|
// installed.
|
|
454
|
db_update('system')
|
|
455
|
->fields(array('status' => 1))
|
|
456
|
->condition('type', 'module')
|
|
457
|
->condition('name', $module)
|
|
458
|
->execute();
|
|
459
|
// Refresh the module list to include it.
|
|
460
|
system_list_reset();
|
|
461
|
module_list(TRUE);
|
|
462
|
module_implements('', FALSE, TRUE);
|
|
463
|
_system_update_bootstrap_status();
|
|
464
|
// Update the registry to include it.
|
|
465
|
registry_update();
|
|
466
|
// Refresh the schema to include it.
|
|
467
|
drupal_get_schema(NULL, TRUE);
|
|
468
|
// Update the theme registry to include it.
|
|
469
|
drupal_theme_rebuild();
|
|
470
|
// Clear entity cache.
|
|
471
|
entity_info_cache_clear();
|
|
472
|
|
|
473
|
// Now install the module if necessary.
|
|
474
|
if (drupal_get_installed_schema_version($module, TRUE) == SCHEMA_UNINSTALLED) {
|
|
475
|
drupal_install_schema($module);
|
|
476
|
|
|
477
|
// Set the schema version to the number of the last update provided
|
|
478
|
// by the module.
|
|
479
|
$versions = drupal_get_schema_versions($module);
|
|
480
|
$version = $versions ? max($versions) : SCHEMA_INSTALLED;
|
|
481
|
|
|
482
|
// If the module has no current updates, but has some that were
|
|
483
|
// previously removed, set the version to the value of
|
|
484
|
// hook_update_last_removed().
|
|
485
|
if ($last_removed = module_invoke($module, 'update_last_removed')) {
|
|
486
|
$version = max($version, $last_removed);
|
|
487
|
}
|
|
488
|
drupal_set_installed_schema_version($module, $version);
|
|
489
|
// Allow the module to perform install tasks.
|
|
490
|
module_invoke($module, 'install');
|
|
491
|
// Record the fact that it was installed.
|
|
492
|
$modules_installed[] = $module;
|
|
493
|
watchdog('system', '%module module installed.', array('%module' => $module), WATCHDOG_INFO);
|
|
494
|
}
|
|
495
|
|
|
496
|
// Enable the module.
|
|
497
|
module_invoke($module, 'enable');
|
|
498
|
|
|
499
|
// Record the fact that it was enabled.
|
|
500
|
$modules_enabled[] = $module;
|
|
501
|
watchdog('system', '%module module enabled.', array('%module' => $module), WATCHDOG_INFO);
|
|
502
|
}
|
|
503
|
}
|
|
504
|
|
|
505
|
// If any modules were newly installed, invoke hook_modules_installed().
|
|
506
|
if (!empty($modules_installed)) {
|
|
507
|
module_invoke_all('modules_installed', $modules_installed);
|
|
508
|
}
|
|
509
|
|
|
510
|
// If any modules were newly enabled, invoke hook_modules_enabled().
|
|
511
|
if (!empty($modules_enabled)) {
|
|
512
|
module_invoke_all('modules_enabled', $modules_enabled);
|
|
513
|
}
|
|
514
|
|
|
515
|
return TRUE;
|
|
516
|
}
|
|
517
|
|
|
518
|
/**
|
|
519
|
* Disables a given set of modules.
|
|
520
|
*
|
|
521
|
* @param string[] $module_list
|
|
522
|
* An array of module names.
|
|
523
|
* @param bool $disable_dependents
|
|
524
|
* If TRUE, dependent modules will automatically be added and disabled in the
|
|
525
|
* correct order. This incurs a significant performance cost, so use FALSE
|
|
526
|
* if you know $module_list is already complete and in the correct order.
|
|
527
|
*
|
|
528
|
* @see drupal_uninstall_modules()
|
|
529
|
* @see module_enable()
|
|
530
|
*/
|
|
531
|
function module_disable($module_list, $disable_dependents = TRUE) {
|
|
532
|
if ($disable_dependents) {
|
|
533
|
// Get all module data so we can find dependents and sort.
|
|
534
|
$module_data = system_rebuild_module_data();
|
|
535
|
// Create an associative array with weights as values.
|
|
536
|
$module_list = array_flip(array_values($module_list));
|
|
537
|
|
|
538
|
$profile = drupal_get_profile();
|
|
539
|
while (list($module) = each($module_list)) {
|
|
540
|
if (!isset($module_data[$module]) || !$module_data[$module]->status) {
|
|
541
|
// This module doesn't exist or is already disabled, skip it.
|
|
542
|
unset($module_list[$module]);
|
|
543
|
continue;
|
|
544
|
}
|
|
545
|
$module_list[$module] = $module_data[$module]->sort;
|
|
546
|
|
|
547
|
// Add dependent modules to the list, with a placeholder weight.
|
|
548
|
// The new modules will be processed as the while loop continues.
|
|
549
|
foreach ($module_data[$module]->required_by as $dependent => $dependent_data) {
|
|
550
|
if (!isset($module_list[$dependent]) && $dependent != $profile) {
|
|
551
|
$module_list[$dependent] = 0;
|
|
552
|
}
|
|
553
|
}
|
|
554
|
}
|
|
555
|
|
|
556
|
// Sort the module list by pre-calculated weights.
|
|
557
|
asort($module_list);
|
|
558
|
$module_list = array_keys($module_list);
|
|
559
|
}
|
|
560
|
|
|
561
|
$invoke_modules = array();
|
|
562
|
|
|
563
|
foreach ($module_list as $module) {
|
|
564
|
if (module_exists($module)) {
|
|
565
|
// Check if node_access table needs rebuilding.
|
|
566
|
if (!node_access_needs_rebuild() && module_hook($module, 'node_grants')) {
|
|
567
|
node_access_needs_rebuild(TRUE);
|
|
568
|
}
|
|
569
|
|
|
570
|
module_load_install($module);
|
|
571
|
module_invoke($module, 'disable');
|
|
572
|
db_update('system')
|
|
573
|
->fields(array('status' => 0))
|
|
574
|
->condition('type', 'module')
|
|
575
|
->condition('name', $module)
|
|
576
|
->execute();
|
|
577
|
$invoke_modules[] = $module;
|
|
578
|
watchdog('system', '%module module disabled.', array('%module' => $module), WATCHDOG_INFO);
|
|
579
|
}
|
|
580
|
}
|
|
581
|
|
|
582
|
if (!empty($invoke_modules)) {
|
|
583
|
// Refresh the module list to exclude the disabled modules.
|
|
584
|
system_list_reset();
|
|
585
|
module_list(TRUE);
|
|
586
|
module_implements('', FALSE, TRUE);
|
|
587
|
entity_info_cache_clear();
|
|
588
|
// Invoke hook_modules_disabled before disabling modules,
|
|
589
|
// so we can still call module hooks to get information.
|
|
590
|
module_invoke_all('modules_disabled', $invoke_modules);
|
|
591
|
// Update the registry to remove the newly-disabled module.
|
|
592
|
registry_update();
|
|
593
|
_system_update_bootstrap_status();
|
|
594
|
// Update the theme registry to remove the newly-disabled module.
|
|
595
|
drupal_theme_rebuild();
|
|
596
|
}
|
|
597
|
|
|
598
|
// If there remains no more node_access module, rebuilding will be
|
|
599
|
// straightforward, we can do it right now.
|
|
600
|
if (node_access_needs_rebuild() && count(module_implements('node_grants')) == 0) {
|
|
601
|
node_access_rebuild();
|
|
602
|
}
|
|
603
|
}
|
|
604
|
|
|
605
|
/**
|
|
606
|
* @defgroup hooks Hooks
|
|
607
|
* @{
|
|
608
|
* Allow modules to interact with the Drupal core.
|
|
609
|
*
|
|
610
|
* Drupal's module system is based on the concept of "hooks". A hook is a PHP
|
|
611
|
* function that is named foo_bar(), where "foo" is the name of the module
|
|
612
|
* (whose filename is thus foo.module) and "bar" is the name of the hook. Each
|
|
613
|
* hook has a defined set of parameters and a specified result type.
|
|
614
|
*
|
|
615
|
* To extend Drupal, a module need simply implement a hook. When Drupal wishes
|
|
616
|
* to allow intervention from modules, it determines which modules implement a
|
|
617
|
* hook and calls that hook in all enabled modules that implement it.
|
|
618
|
*
|
|
619
|
* The available hooks to implement are explained here in the Hooks section of
|
|
620
|
* the developer documentation. The string "hook" is used as a placeholder for
|
|
621
|
* the module name in the hook definitions. For example, if the module file is
|
|
622
|
* called example.module, then hook_help() as implemented by that module would
|
|
623
|
* be defined as example_help().
|
|
624
|
*
|
|
625
|
* The example functions included are not part of the Drupal core, they are
|
|
626
|
* just models that you can modify. Only the hooks implemented within modules
|
|
627
|
* are executed when running Drupal.
|
|
628
|
*
|
|
629
|
* @see themeable
|
|
630
|
* @see callbacks
|
|
631
|
*/
|
|
632
|
|
|
633
|
/**
|
|
634
|
* @defgroup callbacks Callbacks
|
|
635
|
* @{
|
|
636
|
* Callback function signatures.
|
|
637
|
*
|
|
638
|
* Drupal's API sometimes uses callback functions to allow you to define how
|
|
639
|
* some type of processing happens. A callback is a function with a defined
|
|
640
|
* signature, which you define in a module. Then you pass the function name as
|
|
641
|
* a parameter to a Drupal API function or return it as part of a hook
|
|
642
|
* implementation return value, and your function is called at an appropriate
|
|
643
|
* time. For instance, when setting up batch processing you might need to
|
|
644
|
* provide a callback function for each processing step and/or a callback for
|
|
645
|
* when processing is finished; you would do that by defining these functions
|
|
646
|
* and passing their names into the batch setup function.
|
|
647
|
*
|
|
648
|
* Callback function signatures, like hook definitions, are described by
|
|
649
|
* creating and documenting dummy functions in a *.api.php file; normally, the
|
|
650
|
* dummy callback function's name should start with "callback_", and you should
|
|
651
|
* document the parameters and return value and provide a sample function body.
|
|
652
|
* Then your API documentation can refer to this callback function in its
|
|
653
|
* documentation. A user of your API can usually name their callback function
|
|
654
|
* anything they want, although a standard name would be to replace "callback_"
|
|
655
|
* with the module name.
|
|
656
|
*
|
|
657
|
* @see hooks
|
|
658
|
* @see themeable
|
|
659
|
*
|
|
660
|
* @}
|
|
661
|
*/
|
|
662
|
|
|
663
|
/**
|
|
664
|
* Determines whether a module implements a hook.
|
|
665
|
*
|
|
666
|
* @param $module
|
|
667
|
* The name of the module (without the .module extension).
|
|
668
|
* @param $hook
|
|
669
|
* The name of the hook (e.g. "help" or "menu").
|
|
670
|
*
|
|
671
|
* @return
|
|
672
|
* TRUE if the module is both installed and enabled, and the hook is
|
|
673
|
* implemented in that module.
|
|
674
|
*/
|
|
675
|
function module_hook($module, $hook) {
|
|
676
|
$function = $module . '_' . $hook;
|
|
677
|
if (function_exists($function)) {
|
|
678
|
return TRUE;
|
|
679
|
}
|
|
680
|
// If the hook implementation does not exist, check whether it may live in an
|
|
681
|
// optional include file registered via hook_hook_info().
|
|
682
|
$hook_info = module_hook_info();
|
|
683
|
if (isset($hook_info[$hook]['group'])) {
|
|
684
|
module_load_include('inc', $module, $module . '.' . $hook_info[$hook]['group']);
|
|
685
|
if (function_exists($function)) {
|
|
686
|
return TRUE;
|
|
687
|
}
|
|
688
|
}
|
|
689
|
return FALSE;
|
|
690
|
}
|
|
691
|
|
|
692
|
/**
|
|
693
|
* Determines which modules are implementing a hook.
|
|
694
|
*
|
|
695
|
* Lazy-loaded include files specified with "group" via hook_hook_info() or
|
|
696
|
* hook_module_implements_alter() will be automatically included by this
|
|
697
|
* function when necessary.
|
|
698
|
*
|
|
699
|
* @param string $hook
|
|
700
|
* The name of the hook (e.g. "help" or "menu").
|
|
701
|
* @param bool $sort
|
|
702
|
* By default, modules are ordered by weight and filename, settings this option
|
|
703
|
* to TRUE, module list will be ordered by module name.
|
|
704
|
* @param bool $reset
|
|
705
|
* For internal use only: Whether to force the stored list of hook
|
|
706
|
* implementations to be regenerated (such as after enabling a new module,
|
|
707
|
* before processing hook_enable).
|
|
708
|
*
|
|
709
|
* @return
|
|
710
|
* An array with the names of the modules which are implementing this hook.
|
|
711
|
*
|
|
712
|
* @see module_implements_write_cache()
|
|
713
|
*/
|
|
714
|
function module_implements($hook, $sort = FALSE, $reset = FALSE) {
|
|
715
|
// Use the advanced drupal_static() pattern, since this is called very often.
|
|
716
|
static $drupal_static_fast;
|
|
717
|
if (!isset($drupal_static_fast)) {
|
|
718
|
$drupal_static_fast['implementations'] = &drupal_static(__FUNCTION__);
|
|
719
|
$drupal_static_fast['verified'] = &drupal_static(__FUNCTION__ . ':verified');
|
|
720
|
}
|
|
721
|
$implementations = &$drupal_static_fast['implementations'];
|
|
722
|
$verified = &$drupal_static_fast['verified'];
|
|
723
|
|
|
724
|
// We maintain a persistent cache of hook implementations in addition to the
|
|
725
|
// static cache to avoid looping through every module and every hook on each
|
|
726
|
// request. Benchmarks show that the benefit of this caching outweighs the
|
|
727
|
// additional database hit even when using the default database caching
|
|
728
|
// backend and only a small number of modules are enabled. The cost of the
|
|
729
|
// cache_get() is more or less constant and reduced further when non-database
|
|
730
|
// caching backends are used, so there will be more significant gains when a
|
|
731
|
// large number of modules are installed or hooks invoked, since this can
|
|
732
|
// quickly lead to module_hook() being called several thousand times
|
|
733
|
// per request.
|
|
734
|
if ($reset) {
|
|
735
|
$implementations = array();
|
|
736
|
$verified = array();
|
|
737
|
cache_set('module_implements', array(), 'cache_bootstrap');
|
|
738
|
drupal_static_reset('module_hook_info');
|
|
739
|
drupal_static_reset('drupal_alter');
|
|
740
|
cache_clear_all('hook_info', 'cache_bootstrap');
|
|
741
|
cache_clear_all('system_cache_tables', 'cache');
|
|
742
|
return;
|
|
743
|
}
|
|
744
|
|
|
745
|
// Fetch implementations from cache.
|
|
746
|
// This happens on the first call to module_implements(*, *, FALSE) during a
|
|
747
|
// request, but also when $implementations have been reset, e.g. after
|
|
748
|
// module_enable().
|
|
749
|
if (empty($implementations)) {
|
|
750
|
$implementations = cache_get('module_implements', 'cache_bootstrap');
|
|
751
|
if ($implementations === FALSE) {
|
|
752
|
$implementations = array();
|
|
753
|
}
|
|
754
|
else {
|
|
755
|
$implementations = $implementations->data;
|
|
756
|
}
|
|
757
|
// Forget all previously "verified" hooks, in case that $implementations
|
|
758
|
// were cleared via drupal_static_reset('module_implements') instead of
|
|
759
|
// module_implements(*, *, TRUE).
|
|
760
|
$verified = array();
|
|
761
|
}
|
|
762
|
|
|
763
|
if (!isset($implementations[$hook])) {
|
|
764
|
// The hook is not cached, so ensure that whether or not it has
|
|
765
|
// implementations, that the cache is updated at the end of the request.
|
|
766
|
$implementations['#write_cache'] = TRUE;
|
|
767
|
// Discover implementations for this hook.
|
|
768
|
$hook_info = module_hook_info();
|
|
769
|
$implementations[$hook] = array();
|
|
770
|
$list = module_list(FALSE, FALSE, $sort);
|
|
771
|
foreach ($list as $module) {
|
|
772
|
$include_file = isset($hook_info[$hook]['group']) && module_load_include('inc', $module, $module . '.' . $hook_info[$hook]['group']);
|
|
773
|
// Since module_hook() may needlessly try to load the include file again,
|
|
774
|
// function_exists() is used directly here.
|
|
775
|
if (function_exists($module . '_' . $hook)) {
|
|
776
|
$implementations[$hook][$module] = $include_file ? $hook_info[$hook]['group'] : FALSE;
|
|
777
|
}
|
|
778
|
}
|
|
779
|
// Allow modules to change the weight of specific implementations, but avoid
|
|
780
|
// an infinite loop.
|
|
781
|
if ($hook != 'module_implements_alter') {
|
|
782
|
// Remember the implementations before hook_module_implements_alter().
|
|
783
|
$implementations_before = $implementations[$hook];
|
|
784
|
drupal_alter('module_implements', $implementations[$hook], $hook);
|
|
785
|
// Verify implementations that were added or modified.
|
|
786
|
foreach (array_diff_assoc($implementations[$hook], $implementations_before) as $module => $group) {
|
|
787
|
// If drupal_alter('module_implements') changed or added a $group, the
|
|
788
|
// respective file needs to be included.
|
|
789
|
if ($group) {
|
|
790
|
module_load_include('inc', $module, "$module.$group");
|
|
791
|
}
|
|
792
|
// If a new implementation was added, verify that the function exists.
|
|
793
|
if (!function_exists($module . '_' . $hook)) {
|
|
794
|
unset($implementations[$hook][$module]);
|
|
795
|
}
|
|
796
|
}
|
|
797
|
}
|
|
798
|
// Implementations for this hook are now "verified".
|
|
799
|
$verified[$hook] = TRUE;
|
|
800
|
}
|
|
801
|
elseif (!isset($verified[$hook])) {
|
|
802
|
// Implementations for this hook were in the cache, but they are not
|
|
803
|
// "verified" yet.
|
|
804
|
foreach ($implementations[$hook] as $module => $group) {
|
|
805
|
// If this hook implementation is stored in a lazy-loaded file, so include
|
|
806
|
// that file first.
|
|
807
|
if ($group) {
|
|
808
|
module_load_include('inc', $module, "$module.$group");
|
|
809
|
}
|
|
810
|
// It is possible that a module removed a hook implementation without the
|
|
811
|
// implementations cache being rebuilt yet, so we check whether the
|
|
812
|
// function exists on each request to avoid undefined function errors.
|
|
813
|
// Since module_hook() may needlessly try to load the include file again,
|
|
814
|
// function_exists() is used directly here.
|
|
815
|
if (!function_exists($module . '_' . $hook)) {
|
|
816
|
// Clear out the stale implementation from the cache and force a cache
|
|
817
|
// refresh to forget about no longer existing hook implementations.
|
|
818
|
unset($implementations[$hook][$module]);
|
|
819
|
$implementations['#write_cache'] = TRUE;
|
|
820
|
}
|
|
821
|
}
|
|
822
|
$verified[$hook] = TRUE;
|
|
823
|
}
|
|
824
|
|
|
825
|
return array_keys($implementations[$hook]);
|
|
826
|
}
|
|
827
|
|
|
828
|
/**
|
|
829
|
* Retrieves a list of hooks that are declared through hook_hook_info().
|
|
830
|
*
|
|
831
|
* @return
|
|
832
|
* An associative array whose keys are hook names and whose values are an
|
|
833
|
* associative array containing a group name. The structure of the array
|
|
834
|
* is the same as the return value of hook_hook_info().
|
|
835
|
*
|
|
836
|
* @see hook_hook_info()
|
|
837
|
*/
|
|
838
|
function module_hook_info() {
|
|
839
|
// This function is indirectly invoked from bootstrap_invoke_all(), in which
|
|
840
|
// case common.inc, subsystems, and modules are not loaded yet, so it does not
|
|
841
|
// make sense to support hook groups resp. lazy-loaded include files prior to
|
|
842
|
// full bootstrap.
|
|
843
|
if (drupal_bootstrap(NULL, FALSE) != DRUPAL_BOOTSTRAP_FULL) {
|
|
844
|
return array();
|
|
845
|
}
|
|
846
|
$hook_info = &drupal_static(__FUNCTION__);
|
|
847
|
|
|
848
|
if (!isset($hook_info)) {
|
|
849
|
$hook_info = array();
|
|
850
|
$cache = cache_get('hook_info', 'cache_bootstrap');
|
|
851
|
if ($cache === FALSE) {
|
|
852
|
// Rebuild the cache and save it.
|
|
853
|
// We can't use module_invoke_all() here or it would cause an infinite
|
|
854
|
// loop.
|
|
855
|
foreach (module_list() as $module) {
|
|
856
|
$function = $module . '_hook_info';
|
|
857
|
if (function_exists($function)) {
|
|
858
|
$result = $function();
|
|
859
|
if (isset($result) && is_array($result)) {
|
|
860
|
$hook_info = array_merge_recursive($hook_info, $result);
|
|
861
|
}
|
|
862
|
}
|
|
863
|
}
|
|
864
|
// We can't use drupal_alter() for the same reason as above.
|
|
865
|
foreach (module_list() as $module) {
|
|
866
|
$function = $module . '_hook_info_alter';
|
|
867
|
if (function_exists($function)) {
|
|
868
|
$function($hook_info);
|
|
869
|
}
|
|
870
|
}
|
|
871
|
cache_set('hook_info', $hook_info, 'cache_bootstrap');
|
|
872
|
}
|
|
873
|
else {
|
|
874
|
$hook_info = $cache->data;
|
|
875
|
}
|
|
876
|
}
|
|
877
|
|
|
878
|
return $hook_info;
|
|
879
|
}
|
|
880
|
|
|
881
|
/**
|
|
882
|
* Writes the hook implementation cache.
|
|
883
|
*
|
|
884
|
* @see module_implements()
|
|
885
|
*/
|
|
886
|
function module_implements_write_cache() {
|
|
887
|
// The list of implementations includes vital modules only before full
|
|
888
|
// bootstrap, so do not write cache if we are not fully bootstrapped yet.
|
|
889
|
if (drupal_get_bootstrap_phase() != DRUPAL_BOOTSTRAP_FULL) {
|
|
890
|
return;
|
|
891
|
}
|
|
892
|
$implementations = &drupal_static('module_implements');
|
|
893
|
if (isset($implementations['#write_cache'])) {
|
|
894
|
unset($implementations['#write_cache']);
|
|
895
|
cache_set('module_implements', $implementations, 'cache_bootstrap');
|
|
896
|
}
|
|
897
|
}
|
|
898
|
|
|
899
|
/**
|
|
900
|
* Invokes a hook in a particular module.
|
|
901
|
*
|
|
902
|
* All arguments are passed by value. Use drupal_alter() if you need to pass
|
|
903
|
* arguments by reference.
|
|
904
|
*
|
|
905
|
* @param $module
|
|
906
|
* The name of the module (without the .module extension).
|
|
907
|
* @param $hook
|
|
908
|
* The name of the hook to invoke.
|
|
909
|
* @param ...
|
|
910
|
* Arguments to pass to the hook implementation.
|
|
911
|
*
|
|
912
|
* @return
|
|
913
|
* The return value of the hook implementation.
|
|
914
|
*
|
|
915
|
* @see drupal_alter()
|
|
916
|
*/
|
|
917
|
function module_invoke($module, $hook) {
|
|
918
|
$args = func_get_args();
|
|
919
|
// Remove $module and $hook from the arguments.
|
|
920
|
unset($args[0], $args[1]);
|
|
921
|
if (module_hook($module, $hook)) {
|
|
922
|
return call_user_func_array($module . '_' . $hook, $args);
|
|
923
|
}
|
|
924
|
}
|
|
925
|
|
|
926
|
/**
|
|
927
|
* Invokes a hook in all enabled modules that implement it.
|
|
928
|
*
|
|
929
|
* All arguments are passed by value. Use drupal_alter() if you need to pass
|
|
930
|
* arguments by reference.
|
|
931
|
*
|
|
932
|
* @param $hook
|
|
933
|
* The name of the hook to invoke.
|
|
934
|
* @param ...
|
|
935
|
* Arguments to pass to the hook.
|
|
936
|
*
|
|
937
|
* @return
|
|
938
|
* An array of return values of the hook implementations. If modules return
|
|
939
|
* arrays from their implementations, those are merged into one array.
|
|
940
|
*
|
|
941
|
* @see drupal_alter()
|
|
942
|
*/
|
|
943
|
function module_invoke_all($hook) {
|
|
944
|
$args = func_get_args();
|
|
945
|
// Remove $hook from the arguments.
|
|
946
|
unset($args[0]);
|
|
947
|
$return = array();
|
|
948
|
foreach (module_implements($hook) as $module) {
|
|
949
|
$function = $module . '_' . $hook;
|
|
950
|
if (function_exists($function)) {
|
|
951
|
$result = call_user_func_array($function, $args);
|
|
952
|
if (isset($result) && is_array($result)) {
|
|
953
|
$return = array_merge_recursive($return, $result);
|
|
954
|
}
|
|
955
|
elseif (isset($result)) {
|
|
956
|
$return[] = $result;
|
|
957
|
}
|
|
958
|
}
|
|
959
|
}
|
|
960
|
|
|
961
|
return $return;
|
|
962
|
}
|
|
963
|
|
|
964
|
/**
|
|
965
|
* @} End of "defgroup hooks".
|
|
966
|
*/
|
|
967
|
|
|
968
|
/**
|
|
969
|
* Returns an array of modules required by core.
|
|
970
|
*/
|
|
971
|
function drupal_required_modules() {
|
|
972
|
$files = drupal_system_listing('/^' . DRUPAL_PHP_FUNCTION_PATTERN . '\.info$/', 'modules', 'name', 0);
|
|
973
|
$required = array();
|
|
974
|
|
|
975
|
// An installation profile is required and one must always be loaded.
|
|
976
|
$required[] = drupal_get_profile();
|
|
977
|
|
|
978
|
foreach ($files as $name => $file) {
|
|
979
|
$info = drupal_parse_info_file($file->uri);
|
|
980
|
if (!empty($info) && !empty($info['required']) && $info['required']) {
|
|
981
|
$required[] = $name;
|
|
982
|
}
|
|
983
|
}
|
|
984
|
|
|
985
|
return $required;
|
|
986
|
}
|
|
987
|
|
|
988
|
/**
|
|
989
|
* Passes alterable variables to specific hook_TYPE_alter() implementations.
|
|
990
|
*
|
|
991
|
* This dispatch function hands off the passed-in variables to type-specific
|
|
992
|
* hook_TYPE_alter() implementations in modules. It ensures a consistent
|
|
993
|
* interface for all altering operations.
|
|
994
|
*
|
|
995
|
* A maximum of 2 alterable arguments is supported (a third is supported for
|
|
996
|
* legacy reasons, but should not be used in new code). In case more arguments
|
|
997
|
* need to be passed and alterable, modules provide additional variables
|
|
998
|
* assigned by reference in the last $context argument:
|
|
999
|
* @code
|
|
1000
|
* $context = array(
|
|
1001
|
* 'alterable' => &$alterable,
|
|
1002
|
* 'unalterable' => $unalterable,
|
|
1003
|
* 'foo' => 'bar',
|
|
1004
|
* );
|
|
1005
|
* drupal_alter('mymodule_data', $alterable1, $alterable2, $context);
|
|
1006
|
* @endcode
|
|
1007
|
*
|
|
1008
|
* Note that objects are always passed by reference in PHP5. If it is absolutely
|
|
1009
|
* required that no implementation alters a passed object in $context, then an
|
|
1010
|
* object needs to be cloned:
|
|
1011
|
* @code
|
|
1012
|
* $context = array(
|
|
1013
|
* 'unalterable_object' => clone $object,
|
|
1014
|
* );
|
|
1015
|
* drupal_alter('mymodule_data', $data, $context);
|
|
1016
|
* @endcode
|
|
1017
|
*
|
|
1018
|
* @param $type
|
|
1019
|
* A string describing the type of the alterable $data. 'form', 'links',
|
|
1020
|
* 'node_content', and so on are several examples. Alternatively can be an
|
|
1021
|
* array, in which case hook_TYPE_alter() is invoked for each value in the
|
|
1022
|
* array, ordered first by module, and then for each module, in the order of
|
|
1023
|
* values in $type. For example, when Form API is using drupal_alter() to
|
|
1024
|
* execute both hook_form_alter() and hook_form_FORM_ID_alter()
|
|
1025
|
* implementations, it passes array('form', 'form_' . $form_id) for $type.
|
|
1026
|
* @param $data
|
|
1027
|
* The variable that will be passed to hook_TYPE_alter() implementations to be
|
|
1028
|
* altered. The type of this variable depends on the value of the $type
|
|
1029
|
* argument. For example, when altering a 'form', $data will be a structured
|
|
1030
|
* array. When altering a 'profile', $data will be an object.
|
|
1031
|
* @param $context1
|
|
1032
|
* (optional) An additional variable that is passed by reference.
|
|
1033
|
* @param $context2
|
|
1034
|
* (optional) An additional variable that is passed by reference. If more
|
|
1035
|
* context needs to be provided to implementations, then this should be an
|
|
1036
|
* associative array as described above.
|
|
1037
|
* @param $context3
|
|
1038
|
* (optional) An additional variable that is passed by reference. This
|
|
1039
|
* parameter is deprecated and will not exist in Drupal 8; consequently, it
|
|
1040
|
* should not be used for new Drupal 7 code either. It is here only for
|
|
1041
|
* backwards compatibility with older code that passed additional arguments
|
|
1042
|
* to drupal_alter().
|
|
1043
|
*/
|
|
1044
|
function drupal_alter($type, &$data, &$context1 = NULL, &$context2 = NULL, &$context3 = NULL) {
|
|
1045
|
// Use the advanced drupal_static() pattern, since this is called very often.
|
|
1046
|
static $drupal_static_fast;
|
|
1047
|
if (!isset($drupal_static_fast)) {
|
|
1048
|
$drupal_static_fast['functions'] = &drupal_static(__FUNCTION__);
|
|
1049
|
}
|
|
1050
|
$functions = &$drupal_static_fast['functions'];
|
|
1051
|
|
|
1052
|
// Most of the time, $type is passed as a string, so for performance,
|
|
1053
|
// normalize it to that. When passed as an array, usually the first item in
|
|
1054
|
// the array is a generic type, and additional items in the array are more
|
|
1055
|
// specific variants of it, as in the case of array('form', 'form_FORM_ID').
|
|
1056
|
if (is_array($type)) {
|
|
1057
|
$cid = implode(',', $type);
|
|
1058
|
$extra_types = $type;
|
|
1059
|
$type = array_shift($extra_types);
|
|
1060
|
// Allow if statements in this function to use the faster isset() rather
|
|
1061
|
// than !empty() both when $type is passed as a string, or as an array with
|
|
1062
|
// one item.
|
|
1063
|
if (empty($extra_types)) {
|
|
1064
|
unset($extra_types);
|
|
1065
|
}
|
|
1066
|
}
|
|
1067
|
else {
|
|
1068
|
$cid = $type;
|
|
1069
|
}
|
|
1070
|
|
|
1071
|
// Some alter hooks are invoked many times per page request, so statically
|
|
1072
|
// cache the list of functions to call, and on subsequent calls, iterate
|
|
1073
|
// through them quickly.
|
|
1074
|
if (!isset($functions[$cid])) {
|
|
1075
|
$functions[$cid] = array();
|
|
1076
|
$hook = $type . '_alter';
|
|
1077
|
$modules = module_implements($hook);
|
|
1078
|
if (!isset($extra_types)) {
|
|
1079
|
// For the more common case of a single hook, we do not need to call
|
|
1080
|
// function_exists(), since module_implements() returns only modules with
|
|
1081
|
// implementations.
|
|
1082
|
foreach ($modules as $module) {
|
|
1083
|
$functions[$cid][] = $module . '_' . $hook;
|
|
1084
|
}
|
|
1085
|
}
|
|
1086
|
else {
|
|
1087
|
// For multiple hooks, we need $modules to contain every module that
|
|
1088
|
// implements at least one of them.
|
|
1089
|
$extra_modules = array();
|
|
1090
|
foreach ($extra_types as $extra_type) {
|
|
1091
|
$extra_modules = array_merge($extra_modules, module_implements($extra_type . '_alter'));
|
|
1092
|
}
|
|
1093
|
// If any modules implement one of the extra hooks that do not implement
|
|
1094
|
// the primary hook, we need to add them to the $modules array in their
|
|
1095
|
// appropriate order. module_implements() can only return ordered
|
|
1096
|
// implementations of a single hook. To get the ordered implementations
|
|
1097
|
// of multiple hooks, we mimic the module_implements() logic of first
|
|
1098
|
// ordering by module_list(), and then calling
|
|
1099
|
// drupal_alter('module_implements').
|
|
1100
|
if (array_diff($extra_modules, $modules)) {
|
|
1101
|
// Merge the arrays and order by module_list().
|
|
1102
|
$modules = array_intersect(module_list(), array_merge($modules, $extra_modules));
|
|
1103
|
// Since module_implements() already took care of loading the necessary
|
|
1104
|
// include files, we can safely pass FALSE for the array values.
|
|
1105
|
$implementations = array_fill_keys($modules, FALSE);
|
|
1106
|
// Let modules adjust the order solely based on the primary hook. This
|
|
1107
|
// ensures the same module order regardless of whether this if block
|
|
1108
|
// runs. Calling drupal_alter() recursively in this way does not result
|
|
1109
|
// in an infinite loop, because this call is for a single $type, so we
|
|
1110
|
// won't end up in this code block again.
|
|
1111
|
drupal_alter('module_implements', $implementations, $hook);
|
|
1112
|
$modules = array_keys($implementations);
|
|
1113
|
}
|
|
1114
|
foreach ($modules as $module) {
|
|
1115
|
// Since $modules is a merged array, for any given module, we do not
|
|
1116
|
// know whether it has any particular implementation, so we need a
|
|
1117
|
// function_exists().
|
|
1118
|
$function = $module . '_' . $hook;
|
|
1119
|
if (function_exists($function)) {
|
|
1120
|
$functions[$cid][] = $function;
|
|
1121
|
}
|
|
1122
|
foreach ($extra_types as $extra_type) {
|
|
1123
|
$function = $module . '_' . $extra_type . '_alter';
|
|
1124
|
if (function_exists($function)) {
|
|
1125
|
$functions[$cid][] = $function;
|
|
1126
|
}
|
|
1127
|
}
|
|
1128
|
}
|
|
1129
|
}
|
|
1130
|
// Allow the theme to alter variables after the theme system has been
|
|
1131
|
// initialized.
|
|
1132
|
global $theme, $base_theme_info;
|
|
1133
|
if (isset($theme)) {
|
|
1134
|
$theme_keys = array();
|
|
1135
|
foreach ($base_theme_info as $base) {
|
|
1136
|
$theme_keys[] = $base->name;
|
|
1137
|
}
|
|
1138
|
$theme_keys[] = $theme;
|
|
1139
|
foreach ($theme_keys as $theme_key) {
|
|
1140
|
$function = $theme_key . '_' . $hook;
|
|
1141
|
if (function_exists($function)) {
|
|
1142
|
$functions[$cid][] = $function;
|
|
1143
|
}
|
|
1144
|
if (isset($extra_types)) {
|
|
1145
|
foreach ($extra_types as $extra_type) {
|
|
1146
|
$function = $theme_key . '_' . $extra_type . '_alter';
|
|
1147
|
if (function_exists($function)) {
|
|
1148
|
$functions[$cid][] = $function;
|
|
1149
|
}
|
|
1150
|
}
|
|
1151
|
}
|
|
1152
|
}
|
|
1153
|
}
|
|
1154
|
}
|
|
1155
|
|
|
1156
|
foreach ($functions[$cid] as $function) {
|
|
1157
|
$function($data, $context1, $context2, $context3);
|
|
1158
|
}
|
|
1159
|
}
|
