function EntityReferenceFieldItemNormalizer::normalize

Same name and namespace in other branches
  1. 9 core/modules/serialization/src/Normalizer/EntityReferenceFieldItemNormalizer.php \Drupal\serialization\Normalizer\EntityReferenceFieldItemNormalizer::normalize()
  2. 8.9.x core/modules/serialization/src/Normalizer/EntityReferenceFieldItemNormalizer.php \Drupal\serialization\Normalizer\EntityReferenceFieldItemNormalizer::normalize()
  3. 11.x core/modules/serialization/src/Normalizer/EntityReferenceFieldItemNormalizer.php \Drupal\serialization\Normalizer\EntityReferenceFieldItemNormalizer::normalize()

Overrides ComplexDataNormalizer::normalize

File

core/modules/serialization/src/Normalizer/EntityReferenceFieldItemNormalizer.php, line 38

Class

EntityReferenceFieldItemNormalizer
Adds the file URI to embedded file entities.

Namespace

Drupal\serialization\Normalizer

Code

public function normalize($field_item, $format = NULL, array $context = []) : array|string|int|float|bool|\ArrayObject|null {
  $values = parent::normalize($field_item, $format, $context);
  $this->normalizeRootReferenceValue($values, $field_item);
  /** @var \Drupal\Core\Entity\EntityInterface $entity */
  if ($entity = $field_item->get('entity')
    ->getValue()) {
    $values['target_type'] = $entity->getEntityTypeId();
    // Add the target entity UUID to the normalized output values.
    $values['target_uuid'] = $entity->uuid();
    // Add a 'url' value if there is a reference and a canonical URL. Hard
    // code 'canonical' here as config entities override the default $rel
    // parameter value to 'edit-form.
    if ($entity->hasLinkTemplate('canonical') && !$entity->isNew() && ($url = $entity->toUrl('canonical')
      ->toString(TRUE))) {
      $this->addCacheableDependency($context, $url);
      $values['url'] = $url->getGeneratedUrl();
    }
    elseif ($entity instanceof FileInterface) {
      $values['url'] = $entity->createFileUrl(FALSE);
    }
  }
  return $values;
}

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