Subversion-Projekte lars-tiefland.php_share

<?php

/*

 *  $Id: Doctrine.php 6483 2009-10-12 17:29:18Z jwage $

 *

 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS

 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT

 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR

 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT

 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,

 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT

 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,

 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY

 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE

 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

 *

 * This software consists of voluntary contributions made by many individuals

 * and is licensed under the LGPL. For more information, see

 * <http://www.doctrine-project.org>.

 */

/**

 * The base core class of Doctrine

 *

 * @package     Doctrine

 * @author      Konsta Vesterinen <kvesteri@cc.hut.fi>

 * @author      Lukas Smith <smith@pooteeweet.org> (PEAR MDB2 library)

 * @license     http://www.opensource.org/licenses/lgpl-license.php LGPL

 * @link        www.doctrine-project.org

 * @since       1.0

 * @version     $Revision: 6483 $

 */

class Doctrine_Core

{

    /**

     * VERSION

     */

    const VERSION                   = '1.2.4';

    /**

     * ERROR CONSTANTS

     */

    const ERR                       = -1;

    const ERR_SYNTAX                = -2;

    const ERR_CONSTRAINT            = -3;

    const ERR_NOT_FOUND             = -4;

    const ERR_ALREADY_EXISTS        = -5;

    const ERR_UNSUPPORTED           = -6;

    const ERR_MISMATCH              = -7;

    const ERR_INVALID               = -8;

    const ERR_NOT_CAPABLE           = -9;

    const ERR_TRUNCATED             = -10;

    const ERR_INVALID_NUMBER        = -11;

    const ERR_INVALID_DATE          = -12;

    const ERR_DIVZERO               = -13;

    const ERR_NODBSELECTED          = -14;

    const ERR_CANNOT_CREATE         = -15;

    const ERR_CANNOT_DELETE         = -16;

    const ERR_CANNOT_DROP           = -17;

    const ERR_NOSUCHTABLE           = -18;

    const ERR_NOSUCHFIELD           = -19;

    const ERR_NEED_MORE_DATA        = -20;

    const ERR_NOT_LOCKED            = -21;

    const ERR_VALUE_COUNT_ON_ROW    = -22;

    const ERR_INVALID_DSN           = -23;

    const ERR_CONNECT_FAILED        = -24;

    const ERR_EXTENSION_NOT_FOUND   = -25;

    const ERR_NOSUCHDB              = -26;

    const ERR_ACCESS_VIOLATION      = -27;

    const ERR_CANNOT_REPLACE        = -28;

    const ERR_CONSTRAINT_NOT_NULL   = -29;

    const ERR_DEADLOCK              = -30;

    const ERR_CANNOT_ALTER          = -31;

    const ERR_MANAGER               = -32;

    const ERR_MANAGER_PARSE         = -33;

    const ERR_LOADMODULE            = -34;

    const ERR_INSUFFICIENT_DATA     = -35;

    const ERR_CLASS_NAME            = -36;

    /**

     * PDO derived constants

     */

    const CASE_LOWER = 2;

    const CASE_NATURAL = 0;

    const CASE_UPPER = 1;

    const CURSOR_FWDONLY = 0;

    const CURSOR_SCROLL = 1;

    const ERRMODE_EXCEPTION = 2;

    const ERRMODE_SILENT = 0;

    const ERRMODE_WARNING = 1;

    const FETCH_ASSOC = 2;

    const FETCH_BOTH = 4;

    const FETCH_BOUND = 6;

    const FETCH_CLASS = 8;

    const FETCH_CLASSTYPE = 262144;

    const FETCH_COLUMN = 7;

    const FETCH_FUNC = 10;

    const FETCH_GROUP = 65536;

    const FETCH_INTO = 9;

    const FETCH_LAZY = 1;

    const FETCH_NAMED = 11;

    const FETCH_NUM = 3;

    const FETCH_OBJ = 5;

    const FETCH_ORI_ABS = 4;

    const FETCH_ORI_FIRST = 2;

    const FETCH_ORI_LAST = 3;

    const FETCH_ORI_NEXT = 0;

    const FETCH_ORI_PRIOR = 1;

    const FETCH_ORI_REL = 5;

    const FETCH_SERIALIZE = 524288;

    const FETCH_UNIQUE = 196608;

    const NULL_EMPTY_STRING = 1;

    const NULL_NATURAL = 0;

    const NULL_TO_STRING         = NULL;

    const PARAM_BOOL = 5;

    const PARAM_INPUT_OUTPUT = -2147483648;

    const PARAM_INT = 1;

    const PARAM_LOB = 3;

    const PARAM_NULL = 0;

    const PARAM_STMT = 4;

    const PARAM_STR = 2;

    /**

     * ATTRIBUTE CONSTANTS

     */

    /**

     * PDO derived attributes

     */

    const ATTR_AUTOCOMMIT           = 0;

    const ATTR_PREFETCH             = 1;

    const ATTR_TIMEOUT              = 2;

    const ATTR_ERRMODE              = 3;

    const ATTR_SERVER_VERSION       = 4;

    const ATTR_CLIENT_VERSION       = 5;

    const ATTR_SERVER_INFO          = 6;

    const ATTR_CONNECTION_STATUS    = 7;

    const ATTR_CASE                 = 8;

    const ATTR_CURSOR_NAME          = 9;

    const ATTR_CURSOR               = 10;

    const ATTR_ORACLE_NULLS         = 11;

    const ATTR_PERSISTENT           = 12;

    const ATTR_STATEMENT_CLASS      = 13;

    const ATTR_FETCH_TABLE_NAMES    = 14;

    const ATTR_FETCH_CATALOG_NAMES  = 15;

    const ATTR_DRIVER_NAME          = 16;

    const ATTR_STRINGIFY_FETCHES    = 17;

    const ATTR_MAX_COLUMN_LEN       = 18;

    /**

     * Doctrine constants

     */

    const ATTR_LISTENER             = 100;

    const ATTR_QUOTE_IDENTIFIER     = 101;

    const ATTR_FIELD_CASE           = 102;

    const ATTR_IDXNAME_FORMAT       = 103;

    const ATTR_SEQNAME_FORMAT       = 104;

    const ATTR_SEQCOL_NAME          = 105;

    const ATTR_CMPNAME_FORMAT       = 118;

    const ATTR_DBNAME_FORMAT        = 117;

    const ATTR_TBLCLASS_FORMAT      = 119;

    const ATTR_TBLNAME_FORMAT       = 120;

    const ATTR_FKNAME_FORMAT        = 171;

    const ATTR_EXPORT               = 140;

    const ATTR_DECIMAL_PLACES       = 141;

    const ATTR_PORTABILITY          = 106;

    const ATTR_VALIDATE             = 107;

    const ATTR_COLL_KEY             = 108;

    const ATTR_QUERY_LIMIT          = 109;

    const ATTR_DEFAULT_TABLE_TYPE   = 112;

    const ATTR_DEF_TEXT_LENGTH      = 113;

    const ATTR_DEF_VARCHAR_LENGTH   = 114;

    const ATTR_DEF_TABLESPACE       = 115;

    const ATTR_EMULATE_DATABASE     = 116;

    const ATTR_USE_NATIVE_ENUM      = 117;

    const ATTR_DEFAULT_SEQUENCE     = 133;

    const ATTR_FETCHMODE                    = 118;

    const ATTR_NAME_PREFIX                  = 121;

    const ATTR_CREATE_TABLES                = 122;

    const ATTR_COLL_LIMIT                   = 123;

    const ATTR_CACHE                        = 150;

    const ATTR_RESULT_CACHE                 = 150;

    const ATTR_CACHE_LIFESPAN               = 151;

    const ATTR_RESULT_CACHE_LIFESPAN        = 151;

    const ATTR_LOAD_REFERENCES              = 153;

    const ATTR_RECORD_LISTENER              = 154;

    const ATTR_THROW_EXCEPTIONS             = 155;

    const ATTR_DEFAULT_PARAM_NAMESPACE      = 156;

    const ATTR_QUERY_CACHE                  = 157;

    const ATTR_QUERY_CACHE_LIFESPAN         = 158;

    const ATTR_AUTOLOAD_TABLE_CLASSES       = 160;

    const ATTR_MODEL_LOADING                = 161;

    const ATTR_RECURSIVE_MERGE_FIXTURES     = 162;

    const ATTR_USE_DQL_CALLBACKS            = 164;

    const ATTR_AUTO_ACCESSOR_OVERRIDE       = 165;

    const ATTR_AUTO_FREE_QUERY_OBJECTS      = 166;

    const ATTR_DEFAULT_TABLE_CHARSET        = 167;

    const ATTR_DEFAULT_TABLE_COLLATE        = 168;

    const ATTR_DEFAULT_IDENTIFIER_OPTIONS   = 169;

    const ATTR_DEFAULT_COLUMN_OPTIONS       = 170;

    const ATTR_HYDRATE_OVERWRITE            = 172;

    const ATTR_QUERY_CLASS                  = 173;

    const ATTR_CASCADE_SAVES                = 174;

    const ATTR_COLLECTION_CLASS             = 175;

    const ATTR_TABLE_CLASS                  = 176;

    const ATTR_USE_NATIVE_SET               = 177;

    const ATTR_MODEL_CLASS_PREFIX           = 178;

    const ATTR_TABLE_CLASS_FORMAT           = 179;

    const ATTR_MAX_IDENTIFIER_LENGTH        = 180;

    /**

     * LIMIT CONSTANTS

     */

    /**

     * constant for row limiting

     */

    const LIMIT_ROWS       = 1;

    const QUERY_LIMIT_ROWS = 1;

    /**

     * constant for record limiting

     */

    const LIMIT_RECORDS       = 2;

    const QUERY_LIMIT_RECORDS = 2;

    /**

     * FETCHMODE CONSTANTS

     */

    /**

     * PORTABILITY CONSTANTS

     */

    /**

     * Portability: turn off all portability features.

     * @see self::ATTR_PORTABILITY

     */

    const PORTABILITY_NONE          = 0;

    /**

     * Portability: convert names of tables and fields to case defined in the

     * "field_case" option when using the query*(), fetch*() methods.

     * @see self::ATTR_PORTABILITY

     */

    const PORTABILITY_FIX_CASE      = 1;

    /**

     * Portability: right trim the data output by query*() and fetch*().

     * @see self::ATTR_PORTABILITY

     */

    const PORTABILITY_RTRIM         = 2;

    /**

     * Portability: force reporting the number of rows deleted.

     * @see self::ATTR_PORTABILITY

     */

    const PORTABILITY_DELETE_COUNT  = 4;

    /**

     * Portability: convert empty values to null strings in data output by

     * query*() and fetch*().

     * @see self::ATTR_PORTABILITY

     */

    const PORTABILITY_EMPTY_TO_NULL = 8;

    /**

     * Portability: removes database/table qualifiers from associative indexes

     * @see self::ATTR_PORTABILITY

     */

    const PORTABILITY_FIX_ASSOC_FIELD_NAMES = 16;

    /**

     * Portability: makes Doctrine_Expression throw exception for unportable RDBMS expressions

     * @see self::ATTR_PORTABILITY

     */

    const PORTABILITY_EXPR          = 32;

    /**

     * Portability: turn on all portability features.

     * @see self::ATTR_PORTABILITY

     */

    const PORTABILITY_ALL           = 63;

    /**

     * LOCKMODE CONSTANTS

     */

    /**

     * mode for optimistic locking

     */

    const LOCK_OPTIMISTIC       = 0;

    /**

     * mode for pessimistic locking

     */

    const LOCK_PESSIMISTIC      = 1;

    /**

     * EXPORT CONSTANTS

     */

    /**

     * EXPORT_NONE

     */

    const EXPORT_NONE               = 0;

    /**

     * EXPORT_TABLES

     */

    const EXPORT_TABLES             = 1;

    /**

     * EXPORT_CONSTRAINTS

     */

    const EXPORT_CONSTRAINTS        = 2;

    /**

     * EXPORT_PLUGINS

     */

    const EXPORT_PLUGINS            = 4;

    /**

     * EXPORT_ALL

     */

    const EXPORT_ALL                = 7;

    /**

     * HYDRATION CONSTANTS

     */

    /**

     * HYDRATE_RECORD

     */

    const HYDRATE_RECORD            = 2;

    /**

     * HYDRATE_ARRAY

     */

    const HYDRATE_ARRAY             = 3;

    /**

     * HYDRATE_NONE

     */

    const HYDRATE_NONE              = 4;

    /**

     * HYDRATE_SCALAR

     */

    const HYDRATE_SCALAR            = 5;

    /**

     * HYDRATE_SINGLE_SCALAR

     */

    const HYDRATE_SINGLE_SCALAR     = 6;

    /**

     * HYDRATE_ON_DEMAND

     */

    const HYDRATE_ON_DEMAND         = 7;

    /**

     * HYDRATE_ARRAY_HIERARCHY

     */

    const HYDRATE_ARRAY_HIERARCHY   = 8;

    /**

     * HYDRATE_RECORD_HIERARCHY

     */

    const HYDRATE_RECORD_HIERARCHY  = 9;

    /**

     * HYDRATE_ARRAY_SHALLOW

     */

    const HYDRATE_ARRAY_SHALLOW     = 10;

    /**

     * VALIDATION CONSTANTS

     */

    const VALIDATE_NONE             = 0;

    /**

     * VALIDATE_LENGTHS

     */

    const VALIDATE_LENGTHS          = 1;

    /**

     * VALIDATE_TYPES

     */

    const VALIDATE_TYPES            = 2;

    /**

     * VALIDATE_CONSTRAINTS

     */

    const VALIDATE_CONSTRAINTS      = 4;

    /**

     * VALIDATE_ALL

     */

    const VALIDATE_ALL              = 7;

    /**

     * VALIDATE_USER

     */

    const VALIDATE_USER             = 8;

    /**

     * IDENTIFIER_AUTOINC

     *

     * constant for auto_increment identifier

     */

    const IDENTIFIER_AUTOINC        = 1;

    /**

     * IDENTIFIER_SEQUENCE

     *

     * constant for sequence identifier

     */

    const IDENTIFIER_SEQUENCE       = 2;

    /**

     * IDENTIFIER_NATURAL

     *

     * constant for normal identifier

     */

    const IDENTIFIER_NATURAL        = 3;

    /**

     * IDENTIFIER_COMPOSITE

     *

     * constant for composite identifier

     */

    const IDENTIFIER_COMPOSITE      = 4;

    /**

     * MODEL_LOADING_AGGRESSIVE

     *

     * Constant for agressive model loading

     * Will require_once() all found model files

     */

    const MODEL_LOADING_AGGRESSIVE   = 1;

    /**

     * MODEL_LOADING_CONSERVATIVE

     *

     * Constant for conservative model loading

     * Will not require_once() found model files inititally instead it will build an array

     * and reference it in autoload() when a class is needed it will require_once() it

     */

    const MODEL_LOADING_CONSERVATIVE = 2;

    /**

     * MODEL_LOADING_PEAR

     *

     * Constant for pear model loading

     * Will simply store the path passed to Doctrine_Core::loadModels()

     * and Doctrine_Core::autoload() will check there

     */

    const MODEL_LOADING_PEAR = 3;

    /**

     * Path to Doctrine root

     *

     * @var string $path            doctrine root directory

     */

    private static $_path;

    /**

     * Path to the Doctrine extensions directory

     *

     * @var string $extensionsPath

     */

    private static $_extensionsPath;

    /**

     * Debug bool true/false option

     *

     * @var boolean $_debug

     */

    private static $_debug = false;

    /**

     * Array of all the loaded models and the path to each one for autoloading

     *

     * @var array

     */

    private static $_loadedModelFiles = array();

    /**

     * Array of all the loaded validators

     *

     * @var array

     */

    private static $_validators = array();

    /**

     * Path to the models directory

     *

     * @var string

     */

    private static $_modelsDirectory;

    /**

     * __construct

     *

     * @return void

     * @throws Doctrine_Exception

     */

    public function __construct()

    {

        throw new Doctrine_Exception('Doctrine is static class. No instances can be created.');

    }

    /**

     * Returns an array of all the loaded models and the path where each of them exists

     *

     * @return array

     */

    public static function getLoadedModelFiles()

    {

        return self::$_loadedModelFiles;

    }

    /**

     * Turn on/off the debugging setting

     *

     * @param string $bool

     * @return void

     */

    public static function debug($bool = null)

    {

        if ($bool !== null) {

            self::$_debug = (bool) $bool;

        }

        return self::$_debug;

    }

    /**

     * Set the path to your core Doctrine libraries

     *

     * @param string $path The path to your Doctrine libraries

     * @return void

     */

    public static function setPath($path)

    {

        self::$_path = $path;

    }

    /**

     * Get the root path to Doctrine

     *

     * @return string

     */

    public static function getPath()

    {

        if ( ! self::$_path) {

            self::$_path = realpath(dirname(__FILE__) . '/..');

        }

        return self::$_path;

    }

    /**

     * Set the path to autoload extension classes from

     *

     * @param string $extensionsPath

     * @return void

     */

    public static function setExtensionsPath($extensionsPath)

    {

        self::$_extensionsPath = $extensionsPath;

    }

    /**

     * Get the path to load extension classes from

     *

     * @return string $extensionsPath

     */

    public static function getExtensionsPath()

    {

        return self::$_extensionsPath;

    }

    /**

     * Load an individual model name and path in to the model loading registry

     *

     * @return null

     */

    public static function loadModel($className, $path = null)

    {

        self::$_loadedModelFiles[$className] = $path;

    }

    /**

     * Set the directory where your models are located for PEAR style

     * naming convention autoloading.

     *

     * @param string $directory

     * @return void

     */

    public static function setModelsDirectory($directory)

    {

        self::$_modelsDirectory = $directory;

    }

    /**

     * Get the directory where your models are located for PEAR style naming

     * convention autoloading

     *

     * @return void

     * @author Jonathan Wage

     */

    public static function getModelsDirectory()

    {

        return self::$_modelsDirectory;

    }

    /**

     * Recursively load all models from a directory or array of directories

     *

     * @param  string   $directory      Path to directory of models or array of directory paths

     * @param  integer  $modelLoading   Pass value of Doctrine_Core::ATTR_MODEL_LOADING to force a certain style of model loading

     *                                  Allowed Doctrine_Core::MODEL_LOADING_AGGRESSIVE(default) or Doctrine_Core::MODEL_LOADING_CONSERVATIVE

     * @param  string  $classPrefix     The class prefix of the models to load. This is useful if the class name and file name are not the same

     */

    public static function loadModels($directory, $modelLoading = null, $classPrefix = null)

    {

        $manager = Doctrine_Manager::getInstance();

        $modelLoading = $modelLoading === null ? $manager->getAttribute(Doctrine_Core::ATTR_MODEL_LOADING) : $modelLoading;

        $classPrefix = $classPrefix === null ? $manager->getAttribute(Doctrine_Core::ATTR_MODEL_CLASS_PREFIX) : $classPrefix;

        $loadedModels = array();

        if ($directory !== null) {

            foreach ((array) $directory as $dir) {

                $dir = rtrim($dir, '/');

                if ( ! is_dir($dir)) {

                    throw new Doctrine_Exception('You must pass a valid path to a directory containing Doctrine models');

                }

                $it = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($dir),

                                                        RecursiveIteratorIterator::LEAVES_ONLY);

                foreach ($it as $file) {

                    $e = explode('.', $file->getFileName());

                    if (end($e) === 'php' && strpos($file->getFileName(), '.inc') === false) {

                        if ($modelLoading == Doctrine_Core::MODEL_LOADING_PEAR) {

                            $className = str_replace($dir . DIRECTORY_SEPARATOR, null, $file->getPathName());

                            $className = str_replace(DIRECTORY_SEPARATOR, '_', $className);

                            $className = substr($className, 0, strpos($className, '.'));

                        } else {

                            $className = $e[0];

                        }

                        if ($classPrefix && $classPrefix != substr($className, 0, strlen($classPrefix))) {

                            $className = $classPrefix . $className;

                        }

                        if ( ! class_exists($className, false)) {

                            if ($modelLoading == Doctrine_Core::MODEL_LOADING_CONSERVATIVE || $modelLoading == Doctrine_Core::MODEL_LOADING_PEAR) {

                                self::loadModel($className, $file->getPathName());

                                $loadedModels[$className] = $className;

                            } else {

                                $declaredBefore = get_declared_classes();

                                require_once($file->getPathName());

                                $declaredAfter = get_declared_classes();

                                // Using array_slice because array_diff is broken is some PHP versions

                                $foundClasses = array_slice($declaredAfter, count($declaredBefore));

                                if ($foundClasses) {

                                    foreach ($foundClasses as $className) {

                                        if (self::isValidModelClass($className)) {

                                            $loadedModels[$className] = $className;

                                            self::loadModel($className, $file->getPathName());

                                        }

                                    }

                                }

                                $previouslyLoaded = array_keys(self::$_loadedModelFiles, $file->getPathName());

                                if ( ! empty($previouslyLoaded)) {

                                    $previouslyLoaded = array_combine(array_values($previouslyLoaded), array_values($previouslyLoaded));

                                    $loadedModels = array_merge($loadedModels, $previouslyLoaded);

                                }

                            }

                        } else if (self::isValidModelClass($className)) {

                            $loadedModels[$className] = $className;

                        }

                    }

                }

            }

        }

        asort($loadedModels);

        return $loadedModels;

    }

    /**

     * Get all the loaded models, you can provide an array of classes or it will use get_declared_classes()

     *

     * Will filter through an array of classes and return the Doctrine_Records out of them.

     * If you do not specify $classes it will return all of the currently loaded Doctrine_Records

     *

     * @param classes  Array of classes to filter through, otherwise uses get_declared_classes()

     * @return array   $loadedModels

     */

    public static function getLoadedModels($classes = null)

    {

        if ($classes === null) {

            $classes = get_declared_classes();

            $classes = array_merge($classes, array_keys(self::$_loadedModelFiles));

        }

        return self::filterInvalidModels($classes);

    }

    /**

     * Initialize all models so everything is present and loaded in to memory

     * This will also inheritently initialize any model behaviors and add

     * the models generated by Doctrine generators and add them to the $models

     * array

     *

     * @param string $models

     * @return array $models

     */

    public static function initializeModels($models)

    {

        $models = self::filterInvalidModels($models);

        foreach ($models as $model) {

            $declaredBefore = get_declared_classes();

            Doctrine_Core::getTable($model);

            $declaredAfter = get_declared_classes();

            // Using array_slice because array_diff is broken is some PHP versions

            $foundClasses = array_slice($declaredAfter, count($declaredBefore) - 1);

            foreach ($foundClasses as $class) {

                if (self::isValidModelClass($class)) {

                    $models[] = $class;

                }

            }

        }

        $models = self::filterInvalidModels($models);

        return $models;

    }

    /**

     * Filter through an array of classes and return all the classes that are valid models.

     * This will inflect the class, causing it to be loaded in to memory.

     *

     * @param classes  Array of classes to filter through, otherwise uses get_declared_classes()

     * @return array   $loadedModels

     */

    public static function filterInvalidModels($classes)

    {

        $validModels = array();

        foreach ((array) $classes as $name) {

            if (self::isValidModelClass($name) && ! in_array($name, $validModels)) {

                $validModels[] = $name;

            }

        }

        return $validModels;

    }

    /**

     * Checks if what is passed is a valid Doctrine_Record

     * Will load class in to memory in order to inflect it and find out information about the class

     *

     * @param   mixed   $class Can be a string named after the class, an instance of the class, or an instance of the class reflected

     * @return  boolean

     */

    public static function isValidModelClass($class)

    {

        if ($class instanceof Doctrine_Record) {

            $class = get_class($class);

        }

        if (is_string($class) && class_exists($class)) {

            $class = new ReflectionClass($class);

        }

        if ($class instanceof ReflectionClass) {

            // Skip the following classes

            // - abstract classes

            // - not a subclass of Doctrine_Record

            if ( ! $class->isAbstract() && $class->isSubClassOf('Doctrine_Record')) {

                return true;

            }

        }

        return false;

    }

    /**

     * Get the connection object for a table by the actual table name

     * FIXME: I think this method is flawed because a individual connections could have the same table name

     *

     * @param string $tableName

     * @return Doctrine_Connection

     */

    public static function getConnectionByTableName($tableName)

    {

        $loadedModels = self::getLoadedModels();

        foreach ($loadedModels as $name) {

            $table = Doctrine_Core::getTable($name);

            if ($table->getTableName() == $tableName) {

               return $table->getConnection();

            }

        }

        return Doctrine_Manager::connection();

    }

    /**

     * Method for importing existing schema to Doctrine_Record classes

     *

     * @param string $directory Directory to write your models to

     * @param array $connections Array of connection names to generate models for

     * @param array $options Array of options

     * @return boolean

     * @throws Exception

     */

    public static function generateModelsFromDb($directory, array $connections = array(), array $options = array())

    {

        return Doctrine_Manager::connection()->import->importSchema($directory, $connections, $options);

    }

    /**

     * Generates models from database to temporary location then uses those models to generate a yaml schema file.

     * This should probably be fixed. We should write something to generate a yaml schema file directly from the database.

     *

     * @param string $yamlPath Path to write oyur yaml schema file to

     * @param array $connections Array of connection names to generate yaml for

     * @param array  $options Array of options

     * @return void

     */

    public static function generateYamlFromDb($yamlPath, array $connections = array(), array $options = array())

    {

        $directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'tmp_doctrine_models';

        $options['generateBaseClasses'] = isset($options['generateBaseClasses']) ? $options['generateBaseClasses']:false;

        $result = Doctrine_Core::generateModelsFromDb($directory, $connections, $options);

        if ( empty($result) && ! is_dir($directory)) {

            throw new Doctrine_Exception('No models generated from your databases');

        }

        $export = new Doctrine_Export_Schema();

        $result = $export->exportSchema($yamlPath, 'yml', $directory, array(), Doctrine_Core::MODEL_LOADING_AGGRESSIVE);

        Doctrine_Lib::removeDirectories($directory);

        return $result;

    }

    /**

     * Generate a yaml schema file from an existing directory of models

     *

     * @param string $yamlPath Path to your yaml schema files

     * @param string $directory Directory to generate your models in

     * @param array  $options Array of options to pass to the schema importer

     * @return void

     */

    public static function generateModelsFromYaml($yamlPath, $directory, $options = array())

    {

        $import = new Doctrine_Import_Schema();

        $import->setOptions($options);

        return $import->importSchema($yamlPath, 'yml', $directory);

    }

    /**

     * Creates database tables for the models in the specified directory

     *

     * @param string $directory Directory containing your models

     * @return void

     */

    public static function createTablesFromModels($directory = null)

    {

        return Doctrine_Manager::connection()->export->exportSchema($directory);

    }

    /**

     * Creates database tables for the models in the supplied array

     *

     * @param array $array An array of models to be exported

     * @return void

     */

    public static function createTablesFromArray($array)

    {

        return Doctrine_Manager::connection()->export->exportClasses($array);

    }

    /**

     * Generate a array of sql for the passed array of models

     *

     * @param  array $array

     * @return array $sql

     */

    public static function generateSqlFromArray($array)

    {

        return Doctrine_Manager::connection()->export->exportClassesSql($array);

    }

    /**

     * Generate a sql string to create the tables from all loaded models

     * or the models found in the passed directory.

     *

     * @param  string $directory

     * @return string $build  String of sql queries. One query per line

     */

    public static function generateSqlFromModels($directory = null)

    {

        $conn = Doctrine_Manager::connection();

        $sql = $conn->export->exportSql($directory);

        $build = '';

        foreach ($sql as $query) {

            $build .= $query.$conn->sql_file_delimiter;

        }

        return $build;

    }

    /**

     * Generate yaml schema file for the models in the specified directory

     *

     * @param string $yamlPath Path to your yaml schema files

     * @param string $directory Directory to generate your models in

     * @return void

     */

    public static function generateYamlFromModels($yamlPath, $directory)

    {

        $export = new Doctrine_Export_Schema();

        return $export->exportSchema($yamlPath, 'yml', $directory);

    }

    /**

     * Creates databases for connections

     *

     * @param string $specifiedConnections Array of connections you wish to create the database for

     * @return void

     */

    public static function createDatabases($specifiedConnections = array())

    {

        return Doctrine_Manager::getInstance()->createDatabases($specifiedConnections);

    }

    /**

     * Drops databases for connections

     *

     * @param string $specifiedConnections Array of connections you wish to drop the database for

     * @return void

     */

    public static function dropDatabases($specifiedConnections = array())

    {

        return Doctrine_Manager::getInstance()->dropDatabases($specifiedConnections);

    }

    /**

     * Dump data to a yaml fixtures file

     *

     * @param string $yamlPath Path to write the yaml data fixtures to

     * @param string $individualFiles Whether or not to dump data to individual fixtures files

     * @return void

     */

    public static function dumpData($yamlPath, $individualFiles = false)

    {

        $data = new Doctrine_Data();

        return $data->exportData($yamlPath, 'yml', array(), $individualFiles);

    }

    /**

     * Load data from a yaml fixtures file.

     * The output of dumpData can be fed to loadData

     *

     * @param string $yamlPath Path to your yaml data fixtures

     * @param string $append Whether or not to append the data

     * @return void

     */