1. class
  2. SilverStripe
  3. \
  4. Dev
  5. \
  6. Install
  7. \
  8. DatabaseAdapterRegistry

DatabaseAdapterRegistry

class DatabaseAdapterRegistry implements Flushable (View source)

This class keeps track of the available database adapters and provides a meaning of registering community built adapters in to the installer process.

Methods

static 
register(array $config)

Add new adapter to the registry

static 
unregister(string $class)

Unregisters a database connector by classname

static 
autodiscover()

Detects all _register_database.php files and invokes them.

static 
autoconfigure(array $config = null)

Detects all _configure_database.php files and invokes them Called by ConfigureFromEnv.php.

static CacheInterface
getCache()

No description

static 
flush()

This function is triggered early in the request if the "flush" query parameter has been set. Each class that implements Flushable implements this function which looks after it's own specific flushing functionality.

static array
get_adapters()

Return all registered adapters

static array
get_adapter(string $class)

Returns registry data for a class

static array
get_default_fields()

Retrieves default field configuration

static DatabaseConfigurationHelper|null
getDatabaseConfigurationHelper(string $databaseClass)

Build configuration helper for a given class

Details

at line 72
static register(array $config)

Add new adapter to the registry

Parameters

array $config

Associative array of configuration details. This must include:

  • title
  • class
  • helperClass
  • supported This SHOULD include:
  • fields
  • helperPath (if helperClass can't be autoloaded via psr-4/-0)
  • missingExtensionText
  • module OR missingModuleText

at line 111
static unregister(string $class)

Unregisters a database connector by classname

Parameters

string $class

at line 121
static autodiscover()

Detects all _register_database.php files and invokes them.

Searches through vendor/\/ folders only, does not support "legacy" folder location in webroot

at line 142
static autoconfigure(array $config = null)

Detects all _configure_database.php files and invokes them Called by ConfigureFromEnv.php.

Searches through vendor/ folder only, does not support "legacy" folder location in webroot

Parameters

array $config

Config to update. If not provided fall back to global $databaseConfig. In 5.0.0 this will be mandatory and the global will be removed.

at line 195
static CacheInterface getCache()

Return Value

CacheInterface

at line 200
static flush()

This function is triggered early in the request if the "flush" query parameter has been set. Each class that implements Flushable implements this function which looks after it's own specific flushing functionality.

at line 210
static array get_adapters()

Return all registered adapters

Return Value

array

at line 221
static array get_adapter(string $class)

Returns registry data for a class

Parameters

string $class

Return Value

array

List of adapter properties

at line 234
static array get_default_fields()

Retrieves default field configuration

Return Value

array

at line 245
static DatabaseConfigurationHelper|null getDatabaseConfigurationHelper(string $databaseClass)

Build configuration helper for a given class

Parameters

string $databaseClass

Name of class

Return Value

DatabaseConfigurationHelper|null

Instance of helper, or null if cannot be loaded