trait DeprecatedServicePropertyTrait

Same name and namespace in other branches
  1. 9 core/lib/Drupal/Core/DependencyInjection/DeprecatedServicePropertyTrait.php \Drupal\Core\DependencyInjection\DeprecatedServicePropertyTrait
  2. 8.9.x core/lib/Drupal/Core/DependencyInjection/DeprecatedServicePropertyTrait.php \Drupal\Core\DependencyInjection\DeprecatedServicePropertyTrait
  3. 10 core/lib/Drupal/Core/DependencyInjection/DeprecatedServicePropertyTrait.php \Drupal\Core\DependencyInjection\DeprecatedServicePropertyTrait

Provides a standard way to announce deprecated properties.

Hierarchy

6 files declare their use of DeprecatedServicePropertyTrait
AdminNegotiator.php in core/modules/user/src/Theme/AdminNegotiator.php
ComponentNegotiator.php in core/lib/Drupal/Core/Theme/ComponentNegotiator.php
ExtensionMimeTypeGuesser.php in core/lib/Drupal/Core/File/MimeType/ExtensionMimeTypeGuesser.php
FileSystem.php in core/lib/Drupal/Core/File/FileSystem.php
Permission.php in core/modules/user/src/Plugin/views/access/Permission.php

... See full list

File

core/lib/Drupal/Core/DependencyInjection/DeprecatedServicePropertyTrait.php, line 8

Namespace

Drupal\Core\DependencyInjection
View source
trait DeprecatedServicePropertyTrait {
  
  /**
   * Allows to access deprecated/removed properties.
   *
   * This method must be public.
   */
  public function __get(string $name) : mixed {
    if (!isset($this->deprecatedProperties)) {
      throw new \LogicException('The deprecatedProperties property must be defined to use this trait.');
    }
    if (isset($this->deprecatedProperties[$name])) {
      $service_name = $this->deprecatedProperties[$name];
      $class_name = static::class;
      // phpcs:ignore Drupal.Semantics.FunctionTriggerError
      @trigger_error("The property {$name} ({$service_name} service) is deprecated in {$class_name} and will be removed before Drupal 11.0.0.", E_USER_DEPRECATED);
      return \Drupal::service($service_name);
    }
    return NULL;
  }

}

Members

Title Sort descending Modifiers Object type Summary
DeprecatedServicePropertyTrait::__get public function Allows to access deprecated/removed properties.

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