class Hooks in Lightning Core 8.4

Implements Drush command hooks.

Hierarchy

• class \Drupal\lightning_core\Commands\Hooks extends \Drush\Commands\DrushCommands

1 string reference to 'Hooks'

drush.services.yml in ./drush.services.yml

drush.services.yml

1 service uses Hooks

lightning_core.hooks in ./drush.services.yml

\Drupal\lightning_core\Commands\Hooks

File

src/Commands/Hooks.php, line 15

Namespace

Drupal\lightning_core\Commands

class Hooks extends DrushCommands {

  /**
   * The profile extension list service.
   *
   * @var \Drupal\Core\Extension\ProfileExtensionList
   */
  private $profileList;

  /**
   * The install_profile parameter.
   *
   * @var string
   */
  private $installProfile;

  /**
   * The plugin cache clearer service.
   *
   * @var \Drupal\Core\Plugin\CachedDiscoveryClearerInterface
   */
  private $pluginCacheClearer;

  /**
   * Hooks constructor.
   *
   * @param \Drupal\Core\Extension\ProfileExtensionList $profile_list
   *   The profile extension list service.
   * @param string $install_profile
   *   The install_profile parameter.
   * @param \Drupal\Core\Plugin\CachedDiscoveryClearerInterface $plugin_cache_clearer
   *   The plugin cache clearer service.
   */
  public function __construct(ProfileExtensionList $profile_list, $install_profile, CachedDiscoveryClearerInterface $plugin_cache_clearer) {
    $this->profileList = $profile_list;
    $this->installProfile = $install_profile;
    $this->pluginCacheClearer = $plugin_cache_clearer;
  }

  /**
   * Clears all plugin caches before database updates begin.
   *
   * A common cause of errors during database updates is update hooks
   * inadvertently using stale data from the myriad caches in Drupal core and
   * contributed modules. To migitate this, we do a bit of cache pruning before
   * database updates begin.
   *
   * drupal_flush_all_caches() is extremely aggressive because it rebuilds the
   * router and other things, but it's a bit too much of a sledgehammer for our
   * purposes. A good compromise is to clear all plugin discovery caches (which
   * will include entity type definitions).
   *
   * @hook pre-command updatedb
   */
  public function preUpdate() {
    $this->pluginCacheClearer
      ->clearCachedDefinitions();
  }

  /**
   * Defines the base-profile field to the core:status command.
   *
   * @param \Symfony\Component\Console\Event\ConsoleCommandEvent $event
   *   The command event.
   *
   * @see ::setBaseProfileFieldValue()
   *
   * @hook command-event core:status
   */
  public function defineExtraStatusFields(ConsoleCommandEvent $event) {
    $options = $event
      ->getCommand()
      ->getDefinition()
      ->getOptions();
    $default_fields = $options['fields']
      ->getDefault();
    $default_fields .= ',base-profile';
    $options['fields']
      ->setDefault($default_fields);
  }

  /**
   * Sets the base-profile field value in core:status.
   *
   * @param mixed $result
   *   The result of the core:status command before alteration.
   * @param \Consolidation\AnnotatedCommand\CommandData $command_data
   *   The Drush command data.
   *
   * @see ::defineExtraStatusFields()
   *
   * @hook alter core:status
   */
  public function setBaseProfileFieldValue($result, CommandData $command_data) {
    $info = $this->profileList
      ->get($this->installProfile);
    if (isset($info->info['base profile'])) {
      $base_profile = $info->info['base profile'];
    }
    else {
      $base_profile = t('This profile does not extend a base profile.');
    }
    $formatter_options = $command_data
      ->formatterOptions();

    // Add a field label for our new 'base-profile' field. This is required
    // in order for this field to be selectable; otherwise, our structured
    // data formatters will remove it.
    $field_labels = $formatter_options
      ->get(FormatterOptions::FIELD_LABELS);
    $field_labels['base-profile'] = t('Base Profile');
    $formatter_options
      ->setFieldLabels($field_labels);

    // Add our data to the new field.
    $result['base-profile'] = $base_profile;
    return $result;
  }

}

Members

Name	Modifiers	Type	Description	Overrides
Hooks::$installProfile	private	property	The install_profile parameter.
Hooks::$pluginCacheClearer	private	property	The plugin cache clearer service.
Hooks::$profileList	private	property	The profile extension list service.
Hooks::defineExtraStatusFields	public	function	Defines the base-profile field to the core:status command.
Hooks::preUpdate	public	function	Clears all plugin caches before database updates begin.
Hooks::setBaseProfileFieldValue	public	function	Sets the base-profile field value in core:status.
Hooks::__construct	public	function	Hooks constructor.