function EntityStorageBase::postLoad

Attaches data to entities upon loading.

If there are multiple bundle classes involved, each one gets a sub array with only the entities of the same bundle. If there's only a single bundle, the entity's postLoad() method will get a copy of the original $entities array.

Parameters

array $entities: Associative array of query results, keyed on the entity ID.

File

core/lib/Drupal/Core/Entity/EntityStorageBase.php, line 377

Class

EntityStorageBase

A base entity storage class.

Namespace

Code

protected function postLoad(array &$entities) {
    $entities_by_class = $this->getEntitiesByClass($entities);
    // Invoke entity class specific postLoad() methods. If there's only a single
    // class involved, we want to pass in the original $entities array. For
    // example, to provide backwards compatibility with the legacy behavior of
    // the deprecated user_roles() method, \Drupal\user\Entity\Role::postLoad()
    // sorts the array to enforce role weights. We have to let it manipulate the
    // final array, not a subarray. However if there are multiple bundle classes
    // involved, we only want to pass each one the entities that match.
    if (count($entities_by_class) === 1) {
        $entity_class = array_key_first($entities_by_class);
        $entity_class::postLoad($this, $entities);
    }
    else {
        foreach ($entities_by_class as $entity_class => &$items) {
            $entity_class::postLoad($this, $items);
        }
    }
    $this->moduleHandler()
        ->invokeAllWith('entity_load', function (callable $hook, string $module) use (&$entities) {
        $hook($entities, $this->entityTypeId);
    });
    $this->moduleHandler()
        ->invokeAllWith($this->entityTypeId . '_load', function (callable $hook, string $module) use (&$entities) {
        $hook($entities);
    });
}