FEATURE Added MSSQLDatabaseConfigurationHelper which is related to the installer

This commit is contained in:
Sean Harvey 2010-02-11 07:38:10 +00:00
parent a2c2b3ebc0
commit 68757c72a6

View File

@ -0,0 +1,126 @@
<?php
/**
* This is a helper class for the SS installer.
*
* It does all the specific checking for MSSQLDatabase
* to ensure that the configuration is setup correctly.
*
* @package mssql
*/
class MSSQLDatabaseConfigurationHelper 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 database configuration, e.g. "server", "username" etc
* @return boolean
*/
public function requireDatabaseFunctions($databaseConfig) {
return (function_exists('mssql_connect') || function_exists('sqlsrv_connect')) ? true : false;
}
/**
* 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('okay' => true, 'error' => 'details of error')
*/
public function requireDatabaseServer($databaseConfig) {
$okay = false;
$error = '';
if(function_exists('mssql_connect')) {
$conn = @mssql_connect($databaseConfig['server'], $databaseConfig['username'], $databaseConfig['password'], true);
} else {
$conn = @sqlsrv_connect($databaseConfig['server'], array(
'UID' => $databaseConfig['username'],
'PWD' => $databaseConfig['password']
));
}
if($conn) {
$okay = true;
} else {
$okay = false;
$error = 'SQL Server requires a valid username and password to determine if the server exists.';
}
return array(
'okay' => $okay,
'error' => $error
);
}
/**
* Ensure a database connection is possible using credentials provided.
* The established connection resource is returned with the results as well.
*
* @param array $databaseConfig Associative array of db configuration, e.g. "server", "username" etc
* @return array Result - e.g. array('okay' => true, 'connection' => mssql link, 'error' => 'details of error')
*/
public function requireDatabaseConnection($databaseConfig) {
$okay = false;
$error = '';
if(function_exists('mssql_connect')) {
$conn = @mssql_connect($databaseConfig['server'], $databaseConfig['username'], $databaseConfig['password'], true);
} else {
$conn = @sqlsrv_connect($databaseConfig['server'], array(
'UID' => $databaseConfig['username'],
'PWD' => $databaseConfig['password']
));
}
if($conn) {
$okay = true;
} else {
$okay = false;
$error = '';
}
return array(
'okay' => $okay,
'connection' => $conn,
'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('okay' => true, 'existsAlready' => 'true')
*/
public function requireDatabaseOrCreatePermissions($databaseConfig) {
$okay = false;
$existsAlready = false;
$check = $this->requireDatabaseConnection($databaseConfig);
$conn = $check['connection'];
if(
(function_exists('mssql_select_db') && @mssql_select_db($databaseConfig['database'], $conn))
||
(function_exists('sqlsrv_select_db') && @sqlsrv_select_db($conn, $databaseConfig['database']))
) {
$okay = true;
$existsAlready = true;
} else {
if(function_exists('mssql_query') && mssql_query("CREATE DATABASE testing123", $conn)) {
mssql_query("DROP DATABASE testing123", $conn);
$okay = true;
$existsAlready = false;
} elseif(function_exists('sqlsrv_query') && @sqlsrv_query($conn, "CREATE DATABASE testing123")) {
sqlsrv_query($conn, "DROP DATABASE testing123");
$okay = true;
$existsAlready = false;
}
}
return array(
'okay' => $okay,
'existsAlready' => $existsAlready
);
}
}