function update_invoke_post_update in Drupal 9

Same name and namespace in other branches

1. 8 core/includes/update.inc \update_invoke_post_update()

Executes a single hook_post_update_NAME().

Parameters

string $function: The function name, that should be executed.

array $context: The batch context array.

1 string reference to 'update_invoke_post_update'

DbUpdateController::triggerBatch in core/modules/system/src/Controller/DbUpdateController.php

Starts the database update batch process.

File

core/includes/update.inc, line 280

Drupal database update API.

Code

function update_invoke_post_update($function, &$context) {
  $ret = [];

  // If this update was aborted in a previous step, or has a dependency that was
  // aborted in a previous step, go no further.
  if (!empty($context['results']['#abort'])) {
    return;
  }
  list($module, $name) = explode('_post_update_', $function, 2);
  module_load_include('php', $module, $module . '.post_update');
  if (function_exists($function)) {
    try {
      $ret['results']['query'] = $function($context['sandbox']);
      $ret['results']['success'] = TRUE;
      if (!isset($context['sandbox']['#finished']) || isset($context['sandbox']['#finished']) && $context['sandbox']['#finished'] >= 1) {
        \Drupal::service('update.post_update_registry')
          ->registerInvokedUpdates([
          $function,
        ]);
      }
    } catch (Exception $e) {
      watchdog_exception('update', $e);
      $variables = Error::decodeException($e);
      unset($variables['backtrace'], $variables['exception']);
      $ret['#abort'] = [
        'success' => FALSE,
        'query' => t('%type: @message in %function (line %line of %file).', $variables),
      ];
    }
  }
  if (isset($context['sandbox']['#finished'])) {
    $context['finished'] = $context['sandbox']['#finished'];
    unset($context['sandbox']['#finished']);
  }
  if (!isset($context['results'][$module][$name])) {
    $context['results'][$module][$name] = [];
  }
  $context['results'][$module][$name] = array_merge($context['results'][$module][$name], $ret);
  if (!empty($ret['#abort'])) {

    // Record this function in the list of updates that were aborted.
    $context['results']['#abort'][] = $function;
  }
  $context['message'] = t('Post updating @module', [
    '@module' => $module,
  ]);
}