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

Provides dependency injection friendly methods for serialization.

Hierarchy

41 files declare their use of DependencySerializationTrait
AccountProxy.php in core/lib/Drupal/Core/Session/AccountProxy.php
CachedStorage.php in core/lib/Drupal/Core/Config/CachedStorage.php
ConfigBase.php in core/lib/Drupal/Core/Config/ConfigBase.php
ConfigImporter.php in core/lib/Drupal/Core/Config/ConfigImporter.php
Context.php in core/lib/Drupal/Core/Plugin/Context/Context.php

... See full list

File

core/lib/Drupal/Core/DependencyInjection/DependencySerializationTrait.php, line 12

Namespace

Drupal\Core\DependencyInjection
View source
trait DependencySerializationTrait {

  /**
   * An array of service IDs keyed by property name used for serialization.
   *
   * @var array
   */

  // phpcs:ignore Drupal.Classes.PropertyDeclaration
  protected $_serviceIds = [];

  /**
   * An array of entity type IDs keyed by the property name of their storages.
   *
   * @var array
   */

  // phpcs:ignore Drupal.Classes.PropertyDeclaration
  protected $_entityStorages = [];

  /**
   * {@inheritdoc}
   */
  public function __sleep() {
    $vars = get_object_vars($this);
    try {
      $container = \Drupal::getContainer();
      $reverse_container = $container
        ->get(ReverseContainer::class);
      foreach ($vars as $key => $value) {
        if (!is_object($value) || $value instanceof TranslatableMarkup) {

          // Ignore properties that cannot be services.
          continue;
        }
        if ($value instanceof EntityStorageInterface) {

          // If a class member is an entity storage, only store the entity type
          // ID the storage is for, so it can be used to get a fresh object on
          // unserialization. By doing this we prevent possible memory leaks
          // when the storage is serialized and it contains a static cache of
          // entity objects. Additionally we ensure that we'll not have multiple
          // storage objects for the same entity type and therefore prevent
          // returning different references for the same entity.
          $this->_entityStorages[$key] = $value
            ->getEntityTypeId();
          unset($vars[$key]);
        }
        elseif ($service_id = $reverse_container
          ->getId($value)) {

          // If a class member was instantiated by the dependency injection
          // container, only store its ID so it can be used to get a fresh object
          // on unserialization.
          $this->_serviceIds[$key] = $service_id;
          unset($vars[$key]);
        }
      }
    } catch (ContainerNotInitializedException $e) {

      // No container, no problem.
    }
    return array_keys($vars);
  }

  /**
   * {@inheritdoc}
   */

  #[\ReturnTypeWillChange]
  public function __wakeup() {

    // Avoid trying to wakeup if there's nothing to do.
    if (empty($this->_serviceIds) && empty($this->_entityStorages)) {
      return;
    }
    $container = \Drupal::getContainer();
    foreach ($this->_serviceIds as $key => $service_id) {
      $this->{$key} = $container
        ->get($service_id);
    }
    $this->_serviceIds = [];
    if ($this->_entityStorages) {

      /** @var \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager */
      $entity_type_manager = $container
        ->get('entity_type.manager');
      foreach ($this->_entityStorages as $key => $entity_type_id) {
        $this->{$key} = $entity_type_manager
          ->getStorage($entity_type_id);
      }
    }
    $this->_entityStorages = [];
  }

}

Members