mirror of
https://github.com/silverstripe/silverstripe-framework
synced 2024-08-31 06:48:02 +02:00
137 lines
3.3 KiB
PHP
137 lines
3.3 KiB
PHP
<?php
|
|
|
|
/**
|
|
* This class keeps track of the available database adapters
|
|
* and provides a meaning of registering community built
|
|
* adapters in to the installer process.
|
|
*
|
|
* @package framework
|
|
* @author Tom Rix
|
|
*/
|
|
class DatabaseAdapterRegistry {
|
|
|
|
/**
|
|
* Default database connector registration fields
|
|
*
|
|
* @var array
|
|
*/
|
|
private static $default_fields = array(
|
|
'server' => array(
|
|
'title' => 'Database server',
|
|
'envVar' => 'SS_DATABASE_SERVER',
|
|
'default' => 'localhost'
|
|
),
|
|
'username' => array(
|
|
'title' => 'Database username',
|
|
'envVar' => 'SS_DATABASE_USERNAME',
|
|
'default' => 'root'
|
|
),
|
|
'password' => array(
|
|
'title' => 'Database password',
|
|
'envVar' => 'SS_DATABASE_PASSWORD',
|
|
'default' => 'password'
|
|
),
|
|
'database' => array(
|
|
'title' => 'Database name',
|
|
'default' => 'SS_mysite',
|
|
'attributes' => array(
|
|
"onchange" => "this.value = this.value.replace(/[\/\\:*?"<>|. \t]+/g,'');"
|
|
)
|
|
),
|
|
);
|
|
|
|
/**
|
|
* Internal array of registered database adapters
|
|
*
|
|
* @var array
|
|
*/
|
|
private static $adapters = array();
|
|
|
|
/**
|
|
* Add new adapter to the registry
|
|
*
|
|
* @param array $config Associative array of configuration details
|
|
*/
|
|
public static function register($config) {
|
|
$missingExtensionText = isset($config['missingExtensionText'])
|
|
? $config['missingExtensionText']
|
|
: 'The PHP extension is missing, please enable or install it.';
|
|
|
|
$path = explode('/', $config['helperPath']);
|
|
$moduleName = array_shift($path);
|
|
$missingModuleText = isset($config['missingModuleText'])
|
|
? $config['missingModuleText']
|
|
: 'The SilverStripe module, '.$moduleName.', is missing or incomplete.'
|
|
. ' Please <a href="http://silverstripe.org/modules">download it</a>.';
|
|
|
|
$config['missingModuleText'] = $missingModuleText;
|
|
$config['missingExtensionText'] = $missingExtensionText;
|
|
|
|
// set default fields if none are defined already
|
|
if(!isset($config['fields'])) $config['fields'] = self::$default_fields;
|
|
|
|
self::$adapters[$config['class']] = $config;
|
|
}
|
|
|
|
/**
|
|
* Unregisters a database connector by classname
|
|
*
|
|
* @param string $class
|
|
*/
|
|
public static function unregister($class) {
|
|
unset(self::$adapters[$class]);
|
|
}
|
|
|
|
/**
|
|
* Detects all _register_database.php files and invokes them
|
|
*/
|
|
public static function autodiscover() {
|
|
foreach(glob(dirname(__FILE__) . '/../../../*', GLOB_ONLYDIR) as $directory) {
|
|
if(file_exists($directory . '/_register_database.php')) {
|
|
include_once($directory . '/_register_database.php');
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Detects all _configure_database.php files and invokes them
|
|
* Called by ConfigureFromEnv.php
|
|
*/
|
|
public static function autoconfigure() {
|
|
foreach(glob(dirname(__FILE__) . '/../../../*', GLOB_ONLYDIR) as $directory) {
|
|
if(file_exists($directory . '/_configure_database.php')) {
|
|
include_once($directory . '/_configure_database.php');
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Return all registered adapters
|
|
*
|
|
* @return array
|
|
*/
|
|
public static function get_adapters() {
|
|
return self::$adapters;
|
|
}
|
|
|
|
/**
|
|
* Returns registry data for a class
|
|
*
|
|
* @param string $class
|
|
* @return array List of adapter properties
|
|
*/
|
|
public static function get_adapter($class) {
|
|
if(isset(self::$adapters[$class])) return self::$adapters[$class];
|
|
}
|
|
|
|
/**
|
|
* Retrieves default field configuration
|
|
*
|
|
* @return array
|
|
*/
|
|
public static function get_default_fields() {
|
|
return self::$default_fields;
|
|
}
|
|
|
|
}
|