function EntityStorageBase::doPreSave

Same name and namespace in other branches
  1. 9 core/lib/Drupal/Core/Entity/EntityStorageBase.php \Drupal\Core\Entity\EntityStorageBase::doPreSave()
  2. 8.9.x core/lib/Drupal/Core/Entity/EntityStorageBase.php \Drupal\Core\Entity\EntityStorageBase::doPreSave()
  3. 11.x core/lib/Drupal/Core/Entity/EntityStorageBase.php \Drupal\Core\Entity\EntityStorageBase::doPreSave()

Performs presave entity processing.

Parameters

\Drupal\Core\Entity\EntityInterface $entity: The saved entity.

Return value

int|string|null The processed entity identifier, or null for new entities.

Throws

\Drupal\Core\Entity\EntityStorageException If the entity identifier is invalid.

2 calls to EntityStorageBase::doPreSave()
ContentEntityStorageBase::doPreSave in core/lib/Drupal/Core/Entity/ContentEntityStorageBase.php
Performs presave entity processing.
EntityStorageBase::save in core/lib/Drupal/Core/Entity/EntityStorageBase.php
Saves the entity permanently.
1 method overrides EntityStorageBase::doPreSave()
ContentEntityStorageBase::doPreSave in core/lib/Drupal/Core/Entity/ContentEntityStorageBase.php
Performs presave entity processing.

File

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

Class

EntityStorageBase
A base entity storage class.

Namespace

Drupal\Core\Entity

Code

protected function doPreSave(EntityInterface $entity) {
  $id = $entity->id();
  // Track the original ID.
  if ($entity->getOriginalId() !== NULL) {
    $id = $entity->getOriginalId();
  }
  // Track if this entity exists already.
  $id_exists = $this->has($id, $entity);
  // A new entity should not already exist.
  if ($id_exists && $entity->isNew()) {
    throw new EntityStorageException("'{$this->entityTypeId}' entity with ID '{$id}' already exists.");
  }
  // Load the original entity, if any.
  if ($id_exists && !isset($entity->original)) {
    $entity->original = $this->loadUnchanged($id);
  }
  // Allow code to run before saving.
  $entity->preSave($this);
  $this->invokeHook('presave', $entity);
  return $id;
}

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