1. class
  2. SilverStripe
  3. \
  4. ORM
  5. \
  6. Connect
  7. \
  8. TempDatabase

TempDatabase

class TempDatabase

Traits

Injectable
A class that can be instantiated or replaced via DI

Methods

static Injectable
create(array $args)

An implementation of the factory method, allows you to create an instance of a class

from Injectable
static Injectable
singleton(string $class = null)

Creates a class instance by the "singleton" design pattern.

from Injectable
__construct(string $name = 'default')

Create a new temp database

bool
isUsed()

Returns true if we are currently using a temporary database

bool
supportsTransactions()

No description

startTransaction()

Start a transaction for easy rollback after tests

bool
rollbackTransaction()

Rollback a transaction (or trash all data if the DB doesn't support databases

kill()

Destroy the current temp database

clearAllData()

Remove all content from the temporary database.

string
build()

Create temp DB without creating extra objects

deleteAll()

Clear all temp DBs on this connection

resetDBSchema(array $extraDataObjects = [])

Reset the testing database's schema.

Details

in Injectable at line 26
static Injectable create(array $args)

An implementation of the factory method, allows you to create an instance of a class

This method will defer class substitution to the Injector API, which can be customised via the Config API to declare substitution classes.

This can be called in one of two ways - either calling via the class directly, or calling on Object and passing the class name as the first parameter. The following are equivalent: $list = DataList::create('SiteTree'); $list = SiteTree::get();

Parameters

array $args

Return Value

Injectable

in Injectable at line 43
static Injectable singleton(string $class = null)

Creates a class instance by the "singleton" design pattern.

It will always return the same instance for this class, which can be used for performance reasons and as a simple way to access instance methods which don't rely on instance data (e.g. the custom SilverStripe static handling).

Parameters

string $class Optional classname to create, if the called class should not be used

Return Value

Injectable The singleton instance

at line 39
__construct(string $name = 'default')

Create a new temp database

Parameters

string $name DB Connection name to use

at line 73
bool isUsed()

Returns true if we are currently using a temporary database

Return Value

bool

at line 82
bool supportsTransactions()

Return Value

bool

at line 90
startTransaction()

Start a transaction for easy rollback after tests

at line 105
bool rollbackTransaction()

Rollback a transaction (or trash all data if the DB doesn't support databases

Return Value

bool True if successfully rolled back, false otherwise. On error the DB is killed and must be re-created. Note that calling rollbackTransaction() when there is no transaction is counted as a failure, user code should either kill or flush the DB as necessary

at line 127
kill()

Destroy the current temp database

at line 159
clearAllData()

Remove all content from the temporary database.

at line 186
string build()

Create temp DB without creating extra objects

Return Value

string DB name

at line 269
deleteAll()

Clear all temp DBs on this connection

Note: This will output results to stdout unless suppressOutput is set on the current db schema

at line 286
resetDBSchema(array $extraDataObjects = [])

Reset the testing database's schema.

Parameters

array $extraDataObjects List of extra dataobjects to build