SilverStripe\MSSQL\MSSQLAzureDatabase

Complexity

Total Complexity

8

Size/Duplication

Total Lines	91
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	3

Importance

Changes

0

4 Methods

Rating	Name	Duplication	Size	Complexity
A	fullTextEnabled()	0	4	1
A	connect()	0	5	1
A	connectDatabase()	0	20	2
A	selectDatabase()	0	21	4

<?php

namespace SilverStripe\MSSQL;

/**
 * Specific support for SQL Azure databases running on Windows Azure.
 * Currently only supports the SQLSRV driver from Microsoft.
 *
 * Some important things about SQL Azure:
 *
 * Selecting a database is not supported.
 *
 * In order to change the database currently in use, you need to connect to
 * the database using the "Database" parameter with sqlsrv_connect()
 *
 * Multiple active result sets are not supported. This means you can't
 * have two query results open at once.
 *
 * Fulltext indexes are not supported.
 */
class MSSQLAzureDatabase extends MSSQLDatabase
{

    /**
     * List of parameters used to create new Azure connections between databases
     *
     * @var array
     */
    protected $parameters = [];

    public function fullTextEnabled()
    {
        return false;
    }

    /**
     * Connect to a SQL Azure database with the given parameters.
     * @param array $parameters Connection parameters set by environment
     *  - server: The server, eg, localhost
     *  - username: The username to log on with
     *  - password: The password to log on with
     *  - database: The database to connect to
     *  - windowsauthentication: Not supported for Azure
     */
    public function connect($parameters)
    {
        $this->parameters = $parameters;
        $this->connectDatabase($parameters['database']);
    }

    /**
     * Connect to a database using the provided parameters
     *
     * @param string $database
     */
    protected function connectDatabase($database)
    {
        $parameters = $this->parameters;
        $parameters['database'] = $database;
        $parameters['returndatesasstrings'] = 1;
        $parameters['multipleactiveresultsets'] = 1;

        // Ensure that driver is available (required by PDO)
        if (empty($parameters['driver'])) {
            $parameters['driver'] = $this->getDatabaseServer();
        }

        // Notify connector of parameters, instructing the connector
        // to connect immediately to the Azure database
        $this->connector->connect($parameters, true);

        // Configure the connection
        $this->query('SET QUOTED_IDENTIFIER ON');
        $this->query('SET TEXTSIZE 2147483647');
    }

    /**
     * Switches to the given database.
     *
     * IMPORTANT: SQL Azure doesn't support "USE", so we need
     * to reinitialize the database connection with the requested
     * database name.
     * @see http://msdn.microsoft.com/en-us/library/windowsazure/ee336288.aspx
     *
     * @param string $name The database name to switch to
     * @param bool $create
     * @param bool|int $errorLevel
     * @return bool
     */
    public function selectDatabase($name, $create = false, $errorLevel = E_USER_ERROR)
    {
        $this->fullTextEnabled = null;

        if (!$this->schemaManager->databaseExists($name)) {
            // Check DB creation permisson
            if (!$create) {
                if ($errorLevel !== false) {
                    user_error("Attempted to connect to non-existing database \"$name\"", $errorLevel);
                }
                // Unselect database
                $this->connector->unloadDatabase();
                return false;
            }
            $this->schemaManager->createDatabase($name);
        }

        $this->connectDatabase($name);

        return true;
    }
}