Alters requirements data.

Implementations are able to alter the title, value, description or the severity of certain requirements defined by hook_requirements() implementations or even remove such entries.

Parameters

array $requirements: The requirements data to be altered.

See also

hook_requirements()

Related topics

1 function implements hook_requirements_alter()

Note: the procedural functions in this list are found by pattern matching, so the list may include some functions that are not actually implementations of this hook.

Requirements1TestHooks::requirementsAlter in core/modules/system/tests/modules/requirements1_test/src/Hook/Requirements1TestHooks.php

Implements hook_requirements_alter().

2 invocations of hook_requirements_alter()

SystemManager::listRequirements in core/modules/system/src/SystemManager.php

Displays the site status report. Can also be used as a pure check.

update_check_requirements in core/includes/update.inc

Checks update requirements and reports errors and (optionally) warnings.

File

core/lib/Drupal/Core/Extension/module.api.php, line 1209

Code

function hook_requirements_alter(array &$requirements) : void {
  // Change the title from 'PHP' to 'PHP version'.
  $requirements['php']['title'] = t('PHP version');
  // Decrease the 'update status' requirement severity from warning to info.
  $requirements['update status']['severity'] = RequirementSeverity::Info;
  // Remove a requirements entry.
  unset($requirements['foo']);
}

---