interface DiagnosticCheckInterface in Purge 8.3

Describes a diagnostic check that checks a specific purging requirement.

Hierarchy

interface \Drupal\Component\Plugin\PluginInspectionInterface; interface \Drupal\Core\Plugin\ContainerFactoryPluginInterface
- interface \Drupal\purge\Plugin\Purge\DiagnosticCheck\DiagnosticCheckInterface

Expanded class hierarchy of DiagnosticCheckInterface

All classes that implement DiagnosticCheckInterface

9 files declare their use of DiagnosticCheckInterface

AlwaysErrorDiagnosticCheck.php in tests/modules/purge_check_error_test/src/Plugin/Purge/DiagnosticCheck/AlwaysErrorDiagnosticCheck.php
AlwaysInfoDiagnosticCheck.php in tests/modules/purge_check_test/src/Plugin/Purge/DiagnosticCheck/AlwaysInfoDiagnosticCheck.php
AlwaysOkDiagnosticCheck.php in tests/modules/purge_check_test/src/Plugin/Purge/DiagnosticCheck/AlwaysOkDiagnosticCheck.php
AlwaysWarningDiagnosticCheck.php in tests/modules/purge_check_warning_test/src/Plugin/Purge/DiagnosticCheck/AlwaysWarningDiagnosticCheck.php
DiagnosticsCommand.php in modules/purge_drush/src/Commands/DiagnosticsCommand.php

... See full list

File

src/Plugin/Purge/DiagnosticCheck/DiagnosticCheckInterface.php, line 11

Namespace

Drupal\purge\Plugin\Purge\DiagnosticCheck

View source

interface DiagnosticCheckInterface extends PluginInspectionInterface, ContainerFactoryPluginInterface {

  /**
   * Non-blocking severity -- Informational message only.
   */
  const SEVERITY_INFO = -1;

  /**
   * Non-blocking severity -- check successfully passed.
   */
  const SEVERITY_OK = 0;

  /**
   * Non-blocking severity -- Warning condition; proceed but flag warning.
   */
  const SEVERITY_WARNING = 1;

  /**
   * BLOCKING severity -- Error condition; purge.purgers service cannot operate.
   */
  const SEVERITY_ERROR = 2;

  /**
   * Perform the check and determine the severity level.
   *
   * Diagnostic checks determine whether something you are checking for is in
   * shape, for instance CMI settings on which your plugin depends. Any check
   * reporting self::SEVERITY_ERROR in their run() methods, will cause purge to
   * stop working. Any other severity level will let the purgers proceed
   * operating but you may report any warning through getRecommendation() to be
   * shown on Drupal's status report, purge_ui or any other diagnostic listing.
   *
   * @code
   * public function run() {
   *   if (...check..) {
   *     return self::SEVERITY_OK;
   *   }
   *   return self::SEVERITY_WARNING;
   * }
   * @endcode
   *
   * @warning
   *   As diagnostic checks can be expensive, this method is called as rarely as
   *   possible. Checks derived from DiagnosticCheckBase will only see the check
   *   getting executed when any of the getter methods are called.
   *
   * @throws \Drupal\purge\Plugin\Purge\DiagnosticCheck\Exception\CheckNotImplementedCorrectly
   *   Thrown when the return value is incorrect.
   *
   * @return int
   *   Integer, matching either of the following constants:
   *    - \Drupal\purge\Plugin\Purge\DiagnosticCheck\DiagnosticCheckInterface::SEVERITY_INFO
   *    - \Drupal\purge\Plugin\Purge\DiagnosticCheck\DiagnosticCheckInterface::SEVERITY_OK
   *    - \Drupal\purge\Plugin\Purge\DiagnosticCheck\DiagnosticCheckInterface::SEVERITY_WARNING
   *    - \Drupal\purge\Plugin\Purge\DiagnosticCheck\DiagnosticCheckInterface::SEVERITY_ERROR
   */
  public function run();

  /**
   * Gets the title of the check.
   *
   * @return \Drupal\Core\StringTranslation\TranslatableMarkup
   *   The translated title.
   */
  public function getTitle();

  /**
   * Gets the description of the check.
   *
   * @return \Drupal\Core\StringTranslation\TranslatableMarkup
   *   The translated description.
   */
  public function getDescription();

  /**
   * Get the severity level.
   *
   * @return int
   *   Integer, matching either of the following constants:
   *    - \Drupal\purge\Plugin\Purge\DiagnosticCheck\DiagnosticCheckInterface::SEVERITY_INFO
   *    - \Drupal\purge\Plugin\Purge\DiagnosticCheck\DiagnosticCheckInterface::SEVERITY_OK
   *    - \Drupal\purge\Plugin\Purge\DiagnosticCheck\DiagnosticCheckInterface::SEVERITY_WARNING
   *    - \Drupal\purge\Plugin\Purge\DiagnosticCheck\DiagnosticCheckInterface::SEVERITY_ERROR
   */
  public function getSeverity();

  /**
   * Get the severity level as unprefixed string.
   *
   * @return string
   *   The string comes without the 'SEVERITY_' prefix as on the constants.
   */
  public function getSeverityString();

  /**
   * Get a recommendation matching the severity level, may return NULL.
   *
   * @return null|\Drupal\Core\StringTranslation\TranslatableMarkup
   *   Null when no recommendation exists, else a translated string.
   */
  public function getRecommendation();

  /**
   * Get an optional value for the check output, may return NULL.
   *
   * @return null|\Drupal\Core\StringTranslation\TranslatableMarkup
   *   Null when no value exists, else a translated string.
   */
  public function getValue();

  /**
   * Generates a individual Drupal-like requirements array.
   *
   * @return array
   *   An associative array with the following elements:
   *   - title: The name of this check.
   *   - value: The current value (e.g., version, time, level, etc), will not
   *     be set if not applicable.
   *   - description: The description of the check.
   *   - severity_status: severity string: 'info', 'ok', 'warning' or 'error'.
   *   - severity: The check's result/severity level, one of:
   *     - REQUIREMENT_INFO: For info only.
   *     - REQUIREMENT_OK: The requirement is satisfied.
   *     - REQUIREMENT_WARNING: The requirement failed with a warning.
   *     - REQUIREMENT_ERROR: The requirement failed with an error.
   */
  public function getRequirementsArray();

  /**
   * Get the severity level, expressed as a status_report severity.
   *
   * @return int
   *   Integer, matching either of the following constants:
   *    - REQUIREMENT_INFO
   *    - REQUIREMENT_OK
   *    - REQUIREMENT_WARNING
   *    - REQUIREMENT_ERROR
   */
  public function getRequirementsSeverity();

}

Members

Name	Modifiers	Type	Description	Overrides
ContainerFactoryPluginInterface::create	public static	function	Creates an instance of the plugin.	112
DiagnosticCheckInterface::getDescription	public	function	Gets the description of the check.	1
DiagnosticCheckInterface::getRecommendation	public	function	Get a recommendation matching the severity level, may return NULL.	1
DiagnosticCheckInterface::getRequirementsArray	public	function	Generates a individual Drupal-like requirements array.	1
DiagnosticCheckInterface::getRequirementsSeverity	public	function	Get the severity level, expressed as a status_report severity.	1
DiagnosticCheckInterface::getSeverity	public	function	Get the severity level.	1
DiagnosticCheckInterface::getSeverityString	public	function	Get the severity level as unprefixed string.	1
DiagnosticCheckInterface::getTitle	public	function	Gets the title of the check.	1
DiagnosticCheckInterface::getValue	public	function	Get an optional value for the check output, may return NULL.	1
DiagnosticCheckInterface::run	public	function	Perform the check and determine the severity level.	14
DiagnosticCheckInterface::SEVERITY_ERROR		constant	BLOCKING severity -- Error condition; purge.purgers service cannot operate.
DiagnosticCheckInterface::SEVERITY_INFO		constant	Non-blocking severity -- Informational message only.
DiagnosticCheckInterface::SEVERITY_OK		constant	Non-blocking severity -- check successfully passed.
DiagnosticCheckInterface::SEVERITY_WARNING		constant	Non-blocking severity -- Warning condition; proceed but flag warning.
PluginInspectionInterface::getPluginDefinition	public	function	Gets the definition of the plugin implementation.	4
PluginInspectionInterface::getPluginId	public	function	Gets the plugin_id of the plugin instance.	2

You are here

interface DiagnosticCheckInterface in Purge 8.3

Hierarchy

File

Namespace

Members

API Navigation