mirror of
https://github.com/silverstripe/silverstripe-framework
synced 2024-08-26 20:45:47 +02:00
138 lines
4.2 KiB
PHP
138 lines
4.2 KiB
PHP
<?php
|
|
/**
|
|
* This is a helper class for the SS installer.
|
|
*
|
|
* It does all the specific checking for MySQLDatabase
|
|
* to ensure that the configuration is setup correctly.
|
|
*
|
|
* @package framework
|
|
* @subpackage model
|
|
*/
|
|
class MySQLDatabaseConfigurationHelper implements DatabaseConfigurationHelper {
|
|
|
|
/**
|
|
* Ensure that the database function for connectivity is available.
|
|
* If it is, we assume the PHP module for this database has been setup correctly.
|
|
*
|
|
* @param array $databaseConfig Associative array of db configuration, e.g. "server", "username" etc
|
|
* @return boolean
|
|
*/
|
|
public function requireDatabaseFunctions($databaseConfig) {
|
|
return class_exists('MySQLi');
|
|
}
|
|
|
|
/**
|
|
* Ensure that the database server exists.
|
|
* @param array $databaseConfig Associative array of db configuration, e.g. "server", "username" etc
|
|
* @return array Result - e.g. array('success' => true, 'error' => 'details of error')
|
|
*/
|
|
public function requireDatabaseServer($databaseConfig) {
|
|
$success = false;
|
|
$error = '';
|
|
$conn = @new MySQLi($databaseConfig['server'], $databaseConfig['username'], $databaseConfig['password']);
|
|
if($conn && $conn->connect_errno) {
|
|
$success = false;
|
|
$error = $conn->connect_error;
|
|
} else {
|
|
$success = true;
|
|
}
|
|
|
|
return array(
|
|
'success' => $success,
|
|
'error' => $error
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get the database version for the MySQL connection, given the
|
|
* database parameters.
|
|
* @return mixed string Version number as string | boolean FALSE on failure
|
|
*/
|
|
public function getDatabaseVersion($databaseConfig) {
|
|
$conn = new MySQLi($databaseConfig['server'], $databaseConfig['username'], $databaseConfig['password']);
|
|
if(!$conn) return false;
|
|
$version = $conn->server_info;
|
|
if(!$version) {
|
|
// fallback to trying a query
|
|
$result = $conn->query('SELECT VERSION()');
|
|
$row = $result->fetch_array();
|
|
if($row && isset($row[0])) {
|
|
$version = trim($row[0]);
|
|
}
|
|
}
|
|
return $version;
|
|
}
|
|
|
|
/**
|
|
* Ensure that the MySQL server version is at least 5.0.
|
|
* @param array $databaseConfig Associative array of db configuration, e.g. "server", "username" etc
|
|
* @return array Result - e.g. array('success' => true, 'error' => 'details of error')
|
|
*/
|
|
public function requireDatabaseVersion($databaseConfig) {
|
|
$version = $this->getDatabaseVersion($databaseConfig);
|
|
$success = false;
|
|
$error = '';
|
|
if($version) {
|
|
$success = version_compare($version, '5.0', '>=');
|
|
if(!$success) {
|
|
$error = "Your MySQL server version is $version. It's recommended you use at least MySQL 5.0.";
|
|
}
|
|
} else {
|
|
$error = "Could not determine your MySQL version.";
|
|
}
|
|
return array(
|
|
'success' => $success,
|
|
'error' => $error
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Ensure a database connection is possible using credentials provided.
|
|
* @param array $databaseConfig Associative array of db configuration, e.g. "server", "username" etc
|
|
* @return array Result - e.g. array('success' => true, 'error' => 'details of error')
|
|
*/
|
|
public function requireDatabaseConnection($databaseConfig) {
|
|
$success = false;
|
|
$error = '';
|
|
$conn = new MySQLi($databaseConfig['server'], $databaseConfig['username'], $databaseConfig['password']);
|
|
if($conn) {
|
|
$success = true;
|
|
} else {
|
|
$success = false;
|
|
$error = ($conn) ? $conn->connect_error : '';
|
|
}
|
|
return array(
|
|
'success' => $success,
|
|
'error' => $error
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Ensure that the database connection is able to use an existing database,
|
|
* or be able to create one if it doesn't exist.
|
|
*
|
|
* @param array $databaseConfig Associative array of db configuration, e.g. "server", "username" etc
|
|
* @return array Result - e.g. array('success' => true, 'alreadyExists' => 'true')
|
|
*/
|
|
public function requireDatabaseOrCreatePermissions($databaseConfig) {
|
|
$success = false;
|
|
$alreadyExists = false;
|
|
$conn = new MySQLi($databaseConfig['server'], $databaseConfig['username'], $databaseConfig['password']);
|
|
if($conn && $conn->select_db($databaseConfig['database'])) {
|
|
$success = true;
|
|
$alreadyExists = true;
|
|
} else {
|
|
if($conn && $conn->query('CREATE DATABASE testing123')) {
|
|
$conn->query('DROP DATABASE testing123');
|
|
$success = true;
|
|
$alreadyExists = false;
|
|
}
|
|
}
|
|
return array(
|
|
'success' => $success,
|
|
'alreadyExists' => $alreadyExists
|
|
);
|
|
}
|
|
|
|
}
|