Change record status: 
Project: 
Introduced in branch: 
11.2.x
Introduced in version: 
11.2.0
Description: 

This runs during the update check.

This hook is equivalent to the hook_requirements($phase = 'update').

This runs after hook_requirements().

This can be implemented using #[Hook('update_requirements')]

There is a hook_update_requirements_alter() that runs after all requirements hooks during update checks.

Before

/**
 * Implements hook_requirements().
 */
function google_tag_requirements($phase) {
  $requirements = [];
  $incompatible = FALSE;

  if ($phase === 'update') {
    $entities = \Drupal::entityTypeManager()->getStorage('google_tag_container')->loadMultiple();
    if (\Drupal::moduleHandler()->moduleExists('google_analytics')) {
      $ga_settings = \Drupal::config('google_analytics.settings');
      $accounts = $ga_settings->get('account');
      $metrics_dimensions = $ga_settings->get('custom.parameters');
      if ($entities && $accounts !== '' && $metrics_dimensions !== []) {
        $incompatible = TRUE;
      }
    }
    if ($incompatible) {
      // @todo provide a drush command usage example here.
      // Where users can choose between google_tag 1.x
      // and google_analytics for migration.
      $requirements['google_tag'] = [
        'title' => t('Google Tag'),
        'description' => t('In order to use Google Tag 2.x, you must decide the upgrade path between Google Tag 1.x and Google Analytics.'),
        'severity' => REQUIREMENT_ERROR,
        'value' => 'Google Tag 2.x is incompatible with Google Analytics while upgrading from 1.x.',
      ];
    }
  }
  return $requirements;
}

After


namespace Drupal\google_tag\Hook;

use Drupal\Core\Hook\Attribute\Hook;

/**
 * Update Requirements for google_tag.
 */
class GoogleTagRequirementsHook {

  /**
   * Implements hook_update_requirements().
   */
  #[Hook('update_requirements')]
  public function update(): array {
    $requirements = [];
    $incompatible = FALSE;

      $entities = \Drupal::entityTypeManager()->getStorage('google_tag_container')->loadMultiple();
      if (\Drupal::moduleHandler()->moduleExists('google_analytics')) {
       $ga_settings = \Drupal::config('google_analytics.settings');
        $accounts = $ga_settings->get('account');
        $metrics_dimensions = $ga_settings->get('custom.parameters');
        if ($entities && $accounts !== '' && $metrics_dimensions !== []) {
          $incompatible = TRUE;
        }
      }
      if ($incompatible) {
        // @todo provide a drush command usage example here.
        // Where users can choose between google_tag 1.x
        // and google_analytics for migration.
        $requirements['google_tag'] = [
          'title' => t('Google Tag'),
          'description' => t('In order to use Google Tag 2.x, you must decide the upgrade path between Google Tag 1.x and Google Analytics.'),
          'severity' => REQUIREMENT_ERROR,
          'value' => 'Google Tag 2.x is incompatible with Google Analytics while upgrading from 1.x.',
        ];
      }
    }
    return $requirements;
  }
}
Impacts: 
Module developers
Site templates, recipes and distribution developers