class FieldUninstallValidator in Drupal 10

Prevents uninstallation of modules providing active field storage.

Hierarchy

• class \Drupal\field\FieldUninstallValidator implements ConfigImportModuleUninstallValidatorInterface uses StringTranslationTrait

1 string reference to 'FieldUninstallValidator'

field.services.yml in core/modules/field/field.services.yml

core/modules/field/field.services.yml

1 service uses FieldUninstallValidator

field.uninstall_validator in core/modules/field/field.services.yml

Drupal\field\FieldUninstallValidator

File

core/modules/field/src/FieldUninstallValidator.php, line 15

Namespace

Drupal\field

class FieldUninstallValidator implements ConfigImportModuleUninstallValidatorInterface {
  use StringTranslationTrait;

  /**
   * The field storage config storage.
   *
   * @var \Drupal\Core\Config\Entity\ConfigEntityStorageInterface
   */
  protected $fieldStorageConfigStorage;

  /**
   * The field type plugin manager.
   *
   * @var \Drupal\Core\Field\FieldTypePluginManagerInterface
   */
  protected $fieldTypeManager;

  /**
   * Constructs a new FieldUninstallValidator.
   *
   * @param \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager
   *   The entity type manager.
   * @param \Drupal\Core\StringTranslation\TranslationInterface $string_translation
   *   The string translation service.
   * @param \Drupal\Core\Field\FieldTypePluginManagerInterface $field_type_manager
   *   The field type plugin manager.
   */
  public function __construct(EntityTypeManagerInterface $entity_type_manager, TranslationInterface $string_translation, FieldTypePluginManagerInterface $field_type_manager) {
    $this->fieldStorageConfigStorage = $entity_type_manager
      ->getStorage('field_storage_config');
    $this->stringTranslation = $string_translation;
    $this->fieldTypeManager = $field_type_manager;
  }

  /**
   * {@inheritdoc}
   */
  public function validate($module) {
    $reasons = [];
    if ($field_storages = $this
      ->getFieldStoragesByModule($module)) {

      // Provide an explanation message (only mention pending deletions if there
      // remain no actual, non-deleted fields.)
      $fields_in_use = [];
      foreach ($field_storages as $field_storage) {
        if (!$field_storage
          ->isDeleted()) {
          $fields_in_use[$field_storage
            ->getType()][] = $field_storage
            ->getLabel();
        }
      }
      if (!empty($fields_in_use)) {
        foreach ($fields_in_use as $field_type => $field_storages) {
          $field_type_label = $this
            ->getFieldTypeLabel($field_type);
          $reasons[] = $this
            ->formatPlural(count($fields_in_use[$field_type]), 'The %field_type_label field type is used in the following field: @fields', 'The %field_type_label field type is used in the following fields: @fields', [
            '%field_type_label' => $field_type_label,
            '@fields' => implode(', ', $field_storages),
          ]);
        }
      }
      else {
        $reasons[] = $this
          ->t('Fields pending deletion');
      }
    }
    return $reasons;
  }

  /**
   * {@inheritdoc}
   */
  public function validateConfigImport(string $module, StorageInterface $source_storage) : array {

    // The field_config_import_steps_alter() method removes field data prior to
    // configuration import so the checks in ::validate() are unnecessary.
    return [];
  }

  /**
   * Returns all field storages for a specified module.
   *
   * @param string $module
   *   The module to filter field storages by.
   *
   * @return \Drupal\field\FieldStorageConfigInterface[]
   *   An array of field storages for a specified module.
   */
  protected function getFieldStoragesByModule($module) {
    return $this->fieldStorageConfigStorage
      ->loadByProperties([
      'module' => $module,
      'include_deleted' => TRUE,
    ]);
  }

  /**
   * Returns the label for a specified field type.
   *
   * @param string $field_type
   *   The field type.
   *
   * @return string
   *   The field type label.
   */
  protected function getFieldTypeLabel($field_type) {
    return $this->fieldTypeManager
      ->getDefinitions()[$field_type]['label'];
  }

}

Members

Name	Modifiers	Type	Description	Overrides
FieldUninstallValidator::$fieldStorageConfigStorage	protected	property	The field storage config storage.
FieldUninstallValidator::$fieldTypeManager	protected	property	The field type plugin manager.
FieldUninstallValidator::getFieldStoragesByModule	protected	function	Returns all field storages for a specified module.
FieldUninstallValidator::getFieldTypeLabel	protected	function	Returns the label for a specified field type.
FieldUninstallValidator::validate	public	function	Determines the reasons a module can not be uninstalled. Overrides ModuleUninstallValidatorInterface::validate
FieldUninstallValidator::validateConfigImport	public	function	Determines reasons a module can not be uninstalled prior to config import. Overrides ConfigImportModuleUninstallValidatorInterface::validateConfigImport
FieldUninstallValidator::__construct	public	function	Constructs a new FieldUninstallValidator.
StringTranslationTrait::$stringTranslation	protected	property	The string translation service.	3
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.
StringTranslationTrait::t	protected	function	Translates a string to the current language or to a given language.