trait DependencySerializationTrait

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

Provides dependency injection friendly methods for serialization.

Hierarchy

52 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
ContentTranslationHandler.php in core/modules/content_translation/src/ContentTranslationHandler.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, Drupal.NamingConventions.ValidVariableName.LowerCamelName
    protected $_serviceIds = [];
    
    /**
     * An array of entity type IDs keyed by the property name of their storages.
     *
     * @var array
     */
    // phpcs:ignore Drupal.Classes.PropertyDeclaration, Drupal.NamingConventions.ValidVariableName.LowerCamelName
    protected $_entityStorages = [];
    
    /**
     * {@inheritdoc}
     */
    public function __sleep() : array {
        $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) {
            // No container, no problem.
        }
        return array_keys($vars);
    }
    
    /**
     * {@inheritdoc}
     */
    public function __wakeup() : void {
        // 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


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