Table Of Contents

Previous topic

< Class Phalcon\Mvc\Model\Row

Next topic

Class Phalcon\Mvc\Model\Transaction\Exception >

Class Phalcon\Mvc\Model\Transaction

implements Phalcon\Mvc\Model\TransactionInterface

Transactions are protective blocks where SQL statements are only permanent if they can all succeed as one atomic action. Phalcon\Transaction is intended to be used with Phalcon_Model_Base. Phalcon Transactions should be created using Phalcon\Transaction\Manager.


try {

  $manager = new Phalcon\Mvc\Model\Transaction\Manager();

  $transaction = $manager->get();

  $robot = new Robots();
  $robot->name = 'WALL·E';
  $robot->created_at = date('Y-m-d');
  if ($robot->save() == false) {
    $transaction->rollback("Can't save robot");

  $robotPart = new RobotParts();
  $robotPart->type = 'head';
  if ($robotPart->save() == false) {
    $transaction->rollback("Can't save robot part");


} catch(Phalcon\Mvc\Model\Transaction\Failed $e) {
  echo 'Failed, reason: ', $e->getMessage();


public __construct (Phalcon\DiInterface $dependencyInjector, [boolean $autoBegin], [string $service])

Phalcon\Mvc\Model\Transaction constructor

public setTransactionManager (Phalcon\Mvc\Model\Transaction\ManagerInterface $manager)

Sets transaction manager related to the transaction

public boolean begin ()

Starts the transaction

public boolean commit ()

Commits the transaction

public boolean rollback ([string $rollbackMessage], [Phalcon\Mvc\ModelInterface $rollbackRecord])

Rolls back the transaction

public Phalcon\Db\AdapterInterface getConnection ()

Returns the connection related to transaction

public setIsNewTransaction (boolean $isNew)

Sets if is a reused transaction or new once

public setRollbackOnAbort (boolean $rollbackOnAbort)

Sets flag to rollback on abort the HTTP connection

public boolean isManaged ()

Checks whether transaction is managed by a transaction manager

public array getMessages ()

Returns validations messages from last save try

public boolean isValid ()

Checks whether internal connection is under an active transaction

public setRollbackedRecord (Phalcon\Mvc\ModelInterface $record)

Sets object which generates rollback action