public function UpdateRegistry::getPendingUpdateInformation

public UpdateRegistry::getPendingUpdateInformation()

Returns a list of all the pending updates.

Return value

array[] An associative array keyed by module name which contains all information about database updates that need to be run, and any updates that are not going to proceed due to missing requirements.

The subarray for each module can contain the following keys:

  • start: The starting update that is to be processed. If this does not exist then do not process any updates for this module as there are other requirements that need to be resolved.
  • pending: An array of all the pending updates for the module including the description from source code comment for each update function. This array is keyed by the update name.

File

core/lib/Drupal/Core/Update/UpdateRegistry.php, line 182

Class

UpdateRegistry
Provides all and missing update implementations.

Namespace

Drupal\Core\Update

Code

public function getPendingUpdateInformation() {
  $functions = $this->getPendingUpdateFunctions();

  $ret = [];
  foreach ($functions as $function) {
    list($module, $update) = explode("_{$this->updateType}_", $function);
    // The description for an update comes from its Doxygen.
    $func = new \ReflectionFunction($function);
    $description = trim(str_replace(array("\n", '*', '/'), '', $func->getDocComment()), ' ');
    $ret[$module]['pending'][$update] = $description;
    if (!isset($ret[$module]['start'])) {
      $ret[$module]['start'] = $update;
    }
  }
  return $ret;
}

© 2001–2016 by the original authors
Licensed under the GNU General Public License, version 2 and later.
Drupal is a registered trademark of Dries Buytaert.
https://api.drupal.org/api/drupal/core!lib!Drupal!Core!Update!UpdateRegistry.php/function/UpdateRegistry::getPendingUpdateInformation/8.1.x