class Requirements in MongoDB 8.2

Class Requirements implements hook_requirements().

Hierarchy

class \Drupal\mongodb_watchdog\Install\Requirements implements ContainerInjectionInterface uses StringTranslationTrait

Expanded class hierarchy of Requirements

1 file declares its use of Requirements

mongodb_watchdog.install in modules/mongodb_watchdog/mongodb_watchdog.install: MongoDB watchdog install file.

1 string reference to 'Requirements'

mongodb_watchdog.services.yml in modules/mongodb_watchdog/mongodb_watchdog.services.yml: modules/mongodb_watchdog/mongodb_watchdog.services.yml

1 service uses Requirements

mongodb.watchdog_requirements in modules/mongodb_watchdog/mongodb_watchdog.services.yml: \Drupal\mongodb_watchdog\Install\Requirements

File

modules/mongodb_watchdog/src/Install/Requirements.php, line 22

Namespace

Drupal\mongodb_watchdog\Install

View source

class Requirements implements ContainerInjectionInterface {
  use StringTranslationTrait;

  /**
   * The module configuration.
   *
   * @var \Drupal\Core\Config\Config
   */
  protected $config;

  /**
   * The config.factory service.
   *
   * @var \Drupal\Core\Config\ConfigFactoryInterface
   */
  protected $configFactory;

  /**
   * The messenger service.
   *
   * @var \Drupal\Core\Messenger\MessengerInterface
   */
  protected $messenger;

  /**
   * The request_stack service.
   *
   * @var \Symfony\Component\HttpFoundation\RequestStack
   */
  protected $requestStack;

  /**
   * The serialization.yaml service.
   *
   * @var \Drupal\Component\Serialization\SerializationInterface
   */
  protected $serialization;

  /**
   * The section of Settings related to the MongoDB package.
   *
   * @var array
   */
  protected $settings;

  /**
   * Requirements constructor.
   *
   * @param \Drupal\Core\Site\Settings $settings
   *   The settings service.
   * @param \Drupal\Core\Config\ConfigFactoryInterface $configFactory
   *   The config.factory service.
   * @param \Symfony\Component\HttpFoundation\RequestStack $requestStack
   *   The request_stack service.
   * @param \Drupal\Component\Serialization\SerializationInterface $serialization
   *   The serialization.yaml service.
   * @param \Drupal\Core\Messenger\MessengerInterface $messenger
   *   The messenger service.
   */
  public function __construct(Settings $settings, ConfigFactoryInterface $configFactory, RequestStack $requestStack, SerializationInterface $serialization, MessengerInterface $messenger) {
    $this->serialization = $serialization;
    $this->configFactory = $configFactory;
    $this->requestStack = $requestStack;
    $this->settings = $settings
      ->get(MongoDb::MODULE);
    $this->messenger = $messenger;
  }

  /**
   * {@inheritdoc}
   */
  public static function create(ContainerInterface $container) : self {
    return new static($container
      ->get('settings'), $container
      ->get('config.factory'), $container
      ->get('request_stack'), $container
      ->get('serialization.yaml'), $container
      ->get('messenger'));
  }

  /**
   * Apply database aliases consistency checks.
   *
   * @param array $state
   *   The current state of requirements checks.
   *
   * @return array
   *   - array: The current state of requirements checks.
   *   - bool: true if the checks added an error, false otherwise
   */
  protected function checkDatabaseAliasConsistency(array $state) : array {
    $databases = $this->settings['databases'];
    if (!isset($databases[Logger::DB_LOGGER])) {
      $state[Logger::MODULE] += [
        'severity' => REQUIREMENT_ERROR,
        'value' => $this
          ->t('Missing `@alias` database alias in settings.', [
          '@alias' => Logger::DB_LOGGER,
        ]),
      ];
      return [
        $state,
        TRUE,
      ];
    }
    [
      $loggerClient,
      $loggerDb,
    ] = $databases[Logger::DB_LOGGER];
    unset($databases[Logger::DB_LOGGER]);
    $duplicates = [];
    foreach ($databases as $alias => $list) {
      [
        $client,
        $database,
      ] = $list;
      if ($loggerClient == $client && $loggerDb == $database) {
        $duplicates[] = "`{$alias}`";
      }
    }
    if (!empty($duplicates)) {
      $state[Logger::MODULE] += [
        'severity' => REQUIREMENT_ERROR,
        'value' => $this
          ->t('The `@alias` alias points to the same database as @others.', [
          '@alias' => Logger::DB_LOGGER,
          '@others' => implode(', ', $duplicates),
        ]),
        'description' => $this
          ->t('Those databases would also be dropped when uninstalling the watchdog module.'),
      ];
      return [
        $state,
        TRUE,
      ];
    }
    return [
      $state,
      FALSE,
    ];
  }

  /**
   * Load the configuration from default or from active configuration.
   *
   * @param bool $useDefault
   *   Use default configuration ?
   */
  protected function loadConfig(bool $useDefault) : void {
    if ($useDefault) {
      $rawDefaultConfig = file_get_contents(__DIR__ . '/../../config/install/mongodb_watchdog.settings.yml');
      $defaultConfigData = $this->serialization
        ->decode($rawDefaultConfig);
      $this->config = $this->configFactory
        ->getEditable(Logger::MODULE);
      $this->config
        ->initWithData($defaultConfigData);
      return;
    }
    $this->config = $this->configFactory
      ->get(Logger::CONFIG_NAME);
  }

  /**
   * Check the consistency of request tracking vs configuration and environment.
   *
   * @param array $state
   *   The current state of requirements.
   *
   * @return array
   *   - array: The current state of requirements checks.
   *   - bool: true if the checks added an error, false otherwise
   */
  protected function checkRequestTracking(array $state) : array {
    $requestTracking = $this->config
      ->get('request_tracking');
    if ($this
      ->hasUniqueId()) {
      $state[Logger::MODULE] += $requestTracking ? [
        'value' => $this
          ->t('Mod_unique_id available and used'),
        'severity' => REQUIREMENT_OK,
        'description' => $this
          ->t('Request tracking is available and active.'),
      ] : [
        'value' => $this
          ->t('Unused mod_unique_id'),
        'severity' => REQUIREMENT_INFO,
        'description' => $this
          ->t('The site could track requests, but request tracking is not enabled. You could disable mod_unique_id to save resources, or enable request tracking</a> for a better logging experience.'),
      ];
      return [
        $state,
        FALSE,
      ];
    }
    $state[Logger::MODULE] += [
      'value' => $this
        ->t('No mod_unique_id'),
    ];
    if ($requestTracking) {
      if (php_sapi_name() === 'cli') {
        $message = $this
          ->t('Request tracking is configured, but the site cannot check the working mod_unique_id configuration from the CLI. Be sure to validate configuration on the <a href=":report">status page</a>.', [
          ':report' => Url::fromRoute('system.status')
            ->toString(),
        ]);
        $state[Logger::MODULE] += [
          'severity' => REQUIREMENT_WARNING,
          'description' => $message,
        ];
        $this->messenger
          ->addWarning($message);
        return [
          $state,
          FALSE,
        ];
      }
      $state[Logger::MODULE] += [
        'severity' => REQUIREMENT_ERROR,
        'description' => $this
          ->t('Request tracking is configured, but the site is not served by Apache with a working mod_unique_id.'),
      ];
      return [
        $state,
        TRUE,
      ];
    }
    $state[Logger::MODULE] += [
      'severity' => REQUIREMENT_OK,
      'description' => $this
        ->t('Request tracking is not configured.'),
    ];
    return [
      $state,
      FALSE,
    ];
  }

  /**
   * Implements hook_requirements().
   */
  public function check(string $phase) : array {
    $state = [
      Logger::MODULE => [
        'title' => 'MongoDB watchdog',
      ],
    ];
    [
      $state,
      $err,
    ] = $this
      ->checkDatabaseAliasConsistency($state);
    if ($err) {
      return $state;
    }
    $this
      ->loadConfig($phase !== 'runtime');
    [
      $state,
      $err,
    ] = $this
      ->checkRequestTracking($state);
    if ($err) {
      return $state;
    }
    return $state;
  }

  /**
   * Is mod_unique_id available on this instance ?
   *
   * @return bool
   *   Is it ?
   */
  protected function hasUniqueId() : bool {
    $server = $this->requestStack
      ->getCurrentRequest()->server;
    return $server
      ->has('UNIQUE_ID') || $server
      ->has('REDIRECT_UNIQUE_ID');
  }

}

Members

Name	Modifiers	Type	Description	Overrides
Requirements::$config	protected	property	The module configuration.
Requirements::$configFactory	protected	property	The config.factory service.
Requirements::$messenger	protected	property	The messenger service.
Requirements::$requestStack	protected	property	The request_stack service.
Requirements::$serialization	protected	property	The serialization.yaml service.
Requirements::$settings	protected	property	The section of Settings related to the MongoDB package.
Requirements::check	public	function	Implements hook_requirements().
Requirements::checkDatabaseAliasConsistency	protected	function	Apply database aliases consistency checks.
Requirements::checkRequestTracking	protected	function	Check the consistency of request tracking vs configuration and environment.
Requirements::create	public static	function	Instantiates a new instance of this class. Overrides ContainerInjectionInterface::create
Requirements::hasUniqueId	protected	function	Is mod_unique_id available on this instance ?
Requirements::loadConfig	protected	function	Load the configuration from default or from active configuration.
Requirements::__construct	public	function	Requirements constructor.
StringTranslationTrait::$stringTranslation	protected	property	The string translation service.	1
StringTranslationTrait::formatPlural	protected	function	Formats a string containing a count of items.
StringTranslationTrait::getNumberOfPlurals	protected	function	Returns the number of plurals supported by a given language.
StringTranslationTrait::getStringTranslation	protected	function	Gets the string translation service.
StringTranslationTrait::setStringTranslation	public	function	Sets the string translation service to use.	2
StringTranslationTrait::t	protected	function	Translates a string to the current language or to a given language.

You are here

class Requirements in MongoDB 8.2

Hierarchy

File

Namespace

Members

API Navigation