for testing and deploying your application
for finding and fixing issues
for empowering human code reviews
<?php
declare(strict_types=1);
namespace Doctrine\ORM;
/**
* An OptimisticLockException is thrown when a version check on an object
* that uses optimistic locking through a version field fails.
*/
class OptimisticLockException extends ORMException
{
* @var object|null
private $entity;
* @param string $msg
* @param object $entity
public function __construct($msg, $entity)
parent::__construct($msg);
$this->entity = $entity;
}
* Gets the entity that caused the exception.
*
* @return object|null
public function getEntity()
return $this->entity;
* @return OptimisticLockException
public static function lockFailed($entity)
return new self('The optimistic lock on an entity failed.', $entity);
* @param int $expectedLockVersion
* @param int $actualLockVersion
public static function lockFailedVersionMismatch($entity, $expectedLockVersion, $actualLockVersion)
$expectedLockVersion = ($expectedLockVersion instanceof \DateTime) ? $expectedLockVersion->getTimestamp() : $expectedLockVersion;
$expectedLockVersion instanceof DateTime
true
$expectedLockVersion
DateTime
$actualLockVersion = ($actualLockVersion instanceof \DateTime) ? $actualLockVersion->getTimestamp() : $actualLockVersion;
$actualLockVersion instanceof DateTime
$actualLockVersion
return new self('The optimistic lock failed, version ' . $expectedLockVersion . ' was expected, but is actually ' . $actualLockVersion, $entity);
* @param string $entityName
public static function notVersioned($entityName)
return new self('Cannot obtain optimistic lock on unversioned entity ' . $entityName, null);