public ModuleHandlerInterface::alter($type, &$data, &$context1 = NULL, &$context2 = NULL)
Passes alterable variables to specific hook_TYPE_alter() implementations.
This dispatch function hands off the passed-in variables to type-specific hook_TYPE_alter() implementations in modules. It ensures a consistent interface for all altering operations.
A maximum of 2 alterable arguments is supported. In case more arguments need to be passed and alterable, modules provide additional variables assigned by reference in the last $context argument:
$context = array( 'alterable' => &$alterable, 'unalterable' => $unalterable, 'foo' => 'bar', ); $this->alter('mymodule_data', $alterable1, $alterable2, $context);
Note that objects are always passed by reference in PHP5. If it is absolutely required that no implementation alters a passed object in $context, then an object needs to be cloned:
$context = array( 'unalterable_object' => clone $object, ); $this->alter('mymodule_data', $data, $context);
Parameters
string|array $type: A string describing the type of the alterable $data. 'form', 'links', 'node_content', and so on are several examples. Alternatively can be an array, in which case hook_TYPE_alter() is invoked for each value in the array, ordered first by module, and then for each module, in the order of values in $type. For example, when Form API is using $this->alter() to execute both hook_form_alter() and hook_form_FORM_ID_alter() implementations, it passes array('form', 'form_' . $form_id) for $type.
mixed $data: The variable that will be passed to hook_TYPE_alter() implementations to be altered. The type of this variable depends on the value of the $type argument. For example, when altering a 'form', $data will be a structured array. When altering a 'profile', $data will be an object.
mixed $context1: (optional) An additional variable that is passed by reference.
mixed $context2: (optional) An additional variable that is passed by reference. If more context needs to be provided to implementations, then this should be an associative array as described above.
File
- core/lib/Drupal/Core/Extension/ModuleHandlerInterface.php, line 290
Class
- ModuleHandlerInterface
- Interface for classes that manage a set of enabled modules.
Namespace
Drupal\Core\Extension
Code
public function alter($type, &$data, &$context1 = NULL, &$context2 = NULL);
Please login to continue.