function EntityReferenceFieldItemList::referencedEntities

Overrides EntityReferenceFieldItemListInterface::referencedEntities

File

core/lib/Drupal/Core/Field/EntityReferenceFieldItemList.php, line 26

Class

EntityReferenceFieldItemList

Defines an item list class for entity reference fields.

Namespace

Code

public function referencedEntities() {
    if ($this->isEmpty()) {
        return [];
    }
    // Collect the IDs of existing entities to load, and directly grab the
    // "autocreate" entities that are already populated in $item->entity.
    $target_entities = $ids = [];
    foreach ($this->list as $delta => $item) {
        if ($item->target_id !== NULL) {
            $ids[$delta] = $item->target_id;
        }
        elseif ($item->hasNewEntity()) {
            $target_entities[$delta] = $item->entity;
        }
    }
    // Load and add the existing entities.
    if ($ids) {
        $target_type = $this->getFieldDefinition()
            ->getSetting('target_type');
        $entities = \Drupal::entityTypeManager()->getStorage($target_type)
            ->loadMultiple($ids);
        foreach ($ids as $delta => $target_id) {
            if (isset($entities[$target_id])) {
                $target_entities[$delta] = $entities[$target_id];
            }
        }
        // Ensure the returned array is ordered by deltas.
        ksort($target_entities);
    }
    return $target_entities;
}