function drupal_check_module in Drupal 8

Same name and namespace in other branches

1. 5 includes/install.inc \drupal_check_module()
2. 6 includes/install.inc \drupal_check_module()
3. 7 includes/install.inc \drupal_check_module()
4. 9 core/includes/install.inc \drupal_check_module()

Checks a module's requirements.

Parameters

$module: Machine name of module to check.

Return value

TRUE or FALSE, depending on whether the requirements are met.

1 call to drupal_check_module()

ModulesListForm::buildModuleList in core/modules/system/src/Form/ModulesListForm.php

Helper function for building a list of modules to install.

File

core/includes/install.inc, line 1101

API functions for installing modules and themes.

Code

function drupal_check_module($module) {
  module_load_install($module);

  // Check requirements
  $requirements = \Drupal::moduleHandler()
    ->invoke($module, 'requirements', [
    'install',
  ]);
  if (is_array($requirements) && drupal_requirements_severity($requirements) == REQUIREMENT_ERROR) {

    // Print any error messages
    foreach ($requirements as $requirement) {
      if (isset($requirement['severity']) && $requirement['severity'] == REQUIREMENT_ERROR) {
        $message = $requirement['description'];
        if (isset($requirement['value']) && $requirement['value']) {
          $message = t('@requirements_message (Currently using @item version @version)', [
            '@requirements_message' => $requirement['description'],
            '@item' => $requirement['title'],
            '@version' => $requirement['value'],
          ]);
        }
        \Drupal::messenger()
          ->addError($message);
      }
    }
    return FALSE;
  }
  return TRUE;
}