InstallRequirementsInterface.php

Namespace

Drupal\Core\Extension

File

core/lib/Drupal/Core/Extension/InstallRequirementsInterface.php

View source
<?php

namespace Drupal\Core\Extension;


/**
 * Provides method for checking requirements during install time.
 */
interface InstallRequirementsInterface {
    
    /**
     * Check installation requirements.
     *
     * Classes implementing this must be in the Install/Requirements namespace.
     * For example src/Install/Requirements/ModuleNameRequirements.php.
     *
     * During the 'install' phase, modules can for example assert that
     * library or server versions are available or sufficient.
     * Note that the installation of a module can happen during installation of
     * Drupal itself (by install.php) with an installation profile or later by
     * hand. As a consequence, install-time requirements must be checked without
     * access to the full Drupal API, because it is not available during
     * install.php.
     * If a requirement has a severity of REQUIREMENT_ERROR, install.php will
     * abort or at least the module will not install.
     * Other severity levels have no effect on the installation.
     * Module dependencies do not belong to these installation requirements,
     * but should be defined in the module's .info.yml file.
     *
     * During installation, if you need to load a class from your module,
     * you'll need to include the class file directly.
     *
     * @return array
     *   An associative array where the keys are arbitrary but must be unique (it
     *   is suggested to use the module short name as a prefix) and the values are
     *   themselves associative arrays with the following elements:
     *   - title: The name of the requirement.
     *   - value: This should only be used for version numbers, do not set it if
     *     not applicable.
     *   - description: The description of the requirement/status.
     *   - severity: (optional) The requirement'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.
     *     Defaults to REQUIREMENT_OK when installing.
     */
    public static function getRequirements() : array;

}

Interfaces

Title Deprecated Summary
InstallRequirementsInterface Provides method for checking requirements during install time.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.