function EntityStorageBase::doPreSave

Same name and namespace in other branches
  1. 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 The processed entity identifier.

Throws

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

File

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

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.