Welcome to the Cookbook

To perform a transaction, a model's tables must be of a type that supports transactions.

All transaction methods must be performed on a model's DataSource object. To get a model's DataSource from within the model, use:

    $dataSource = $this->getDataSource();

1. $dataSource = $this->getDataSource();

You can then use the data source to start, commit, or roll back transactions.

    $dataSource->begin($this);
    
    //Perform some tasks

    if(/*all's well*/) {
        $dataSource->commit($this);
    } else {
        $dataSource->rollback($this);
    }

1. $dataSource->begin($this);
3. //Perform some tasks
4. if(/*all's well*/) {
5. $dataSource->commit($this);
6. } else {
7. $dataSource->rollback($this);
8. }

Nested transactions are currently not supported. If a nested transaction is started, a commit will return false on the parent transaction.