trf4php/trf4php-doctrine

This is a Doctrine binding for trf4php.

2.0.0 2018-03-19 21:51 UTC

Requires

• php: >=7.1
• doctrine/orm: ~2.4
• trf4php/trf4php: ~2.0

Requires (Dev)

• ext-pdo_sqlite: *
• php-coveralls/php-coveralls: 2.0.0
• phpunit/phpunit: 7.0.2

MIT

• Janos Szurovecz

• doctrine
• wrapper
• facade
• transaction

README

master: 1.2:

This is a Doctrine binding for trf4php

Using trf4php-doctrine

Configuration

<?php
/* @var $em \Doctrine\ORM\EntityManager */
$tm = new DoctrineTransactionManager($em);

Using transactions

<?php
/* @var $tm TransactionManager */
try {
    $tm->beginTransaction();
    // database modifications
    $tm->commit();
} catch (TransactionException $e) {
    $tm->rollback();
}

Transactional EntityManager

If a transaction fails, you have to close your EntityManager. Doctrine says that after closing an EM, you have to create another one if you want to use database. TransactionalEntityManagerReloader does it automatically.

To enable this feature, you have to do the following steps:

• Use EntityManagerProxy in DoctrineTransactionManager
• Attach TransactionalEntityManagerReloader observer to DoctrineTransactionManager

$tm = new DoctrineTransactionManager(new DefaultEntityManagerProxy());
$emFactory = new DefaultEntityManagerFactory($conn, $config);
$tm->attach(new TransactionalEntityManagerReloader($emFactory));

If you would like to use a shared, non-transactional EntityManager, pass it to the constructor of DefaultEntityManagerProxy. In this case you can use the proxy object without starting a transaction, which is not recommended, but sometimes necessary.

This feature is also useful in integration tests. You can rollback in tearDown() thus you don't need to reinitialize the database. It highly speed-up your tests.

History

1.2

Transactional EntityManager

Create an EntityManager right after you start a transaction.