Blame | Letzte Änderung | Log anzeigen | RSS feed
<?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_Recordif ( ! $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*/public static function loadData($yamlPath, $append = false){$data = new Doctrine_Data();return $data->importData($yamlPath, 'yml', array(), $append);}/*** Migrate database to specified $to version. Migrates from current to latest if you do not specify.** @param string $migrationsPath Path to migrations directory which contains your migration classes* @param string $to Version you wish to migrate to.* @return bool true* @throws new Doctrine_Migration_Exception*/public static function migrate($migrationsPath, $to = null){$migration = new Doctrine_Migration($migrationsPath);return $migration->migrate($to);}/*** Generate new migration class skeleton** @param string $className Name of the Migration class to generate* @param string $migrationsPath Path to directory which contains your migration classes*/public static function generateMigrationClass($className, $migrationsPath){$builder = new Doctrine_Migration_Builder($migrationsPath);return $builder->generateMigrationClass($className);}/*** Generate a set of migration classes from an existing database** @param string $migrationsPath* @return void* @throws new Doctrine_Migration_Exception*/public static function generateMigrationsFromDb($migrationsPath){$builder = new Doctrine_Migration_Builder($migrationsPath);return $builder->generateMigrationsFromDb();}/*** Generate a set of migration classes from an existing set of models** @param string $migrationsPath Path to your Doctrine migration classes* @param string $modelsPath Path to your Doctrine model classes* @param integer $modelLoading Style of model loading to use for loading the models in order to generate migrations* @return void*/public static function generateMigrationsFromModels($migrationsPath, $modelsPath = null, $modelLoading = null){$builder = new Doctrine_Migration_Builder($migrationsPath);return $builder->generateMigrationsFromModels($modelsPath, $modelLoading);}/*** Generate a set of migration classes by generating differences between two sets* of schema information** @param string $migrationsPath Path to your Doctrine migration classes* @param string $from From schema information* @param string $to To schema information* @return array $changes*/public static function generateMigrationsFromDiff($migrationsPath, $from, $to){$diff = new Doctrine_Migration_Diff($from, $to, $migrationsPath);return $diff->generateMigrationClasses();}/*** Get the Doctrine_Table object for the passed model** @param string $componentName* @return Doctrine_Table*/public static function getTable($componentName){return Doctrine_Manager::getInstance()->getConnectionForComponent($componentName)->getTable($componentName);}/*** Method for making a single file of most used doctrine runtime components* including the compiled file instead of multiple files (in worst* cases dozens of files) can improve performance by an order of magnitude** @param string $target* @param array $includedDrivers* @throws Doctrine_Exception* @return void*/public static function compile($target = null, $includedDrivers = array()){return Doctrine_Compiler::compile($target, $includedDrivers);}/*** simple autoload function* returns true if the class was loaded, otherwise false** @param string $className* @return boolean*/public static function autoload($className){if (strpos($className, 'sfYaml') === 0) {require dirname(__FILE__) . '/Parser/sfYaml/' . $className . '.php';return true;}if (0 !== stripos($className, 'Doctrine') || class_exists($className, false) || interface_exists($className, false)) {return false;}$class = self::getPath() . DIRECTORY_SEPARATOR . str_replace('_', DIRECTORY_SEPARATOR, $className) . '.php';if (file_exists($class)) {require $class;return true;}return false;}public static function modelsAutoload($className){if (class_exists($className, false) || interface_exists($className, false)) {return false;}if ( ! self::$_modelsDirectory) {$loadedModels = self::$_loadedModelFiles;if (isset($loadedModels[$className]) && file_exists($loadedModels[$className])) {require $loadedModels[$className];return true;}} else {$class = self::$_modelsDirectory . DIRECTORY_SEPARATOR . str_replace('_', DIRECTORY_SEPARATOR, $className) . '.php';if (file_exists($class)) {require $class;return true;}}return false;}/*** Load classes from the Doctrine extensions directory/path** @param string $className* @return boolean*/public static function extensionsAutoload($className){if (class_exists($className, false) || interface_exists($className, false)) {return false;}$extensions = Doctrine_Manager::getInstance()->getExtensions();foreach ($extensions as $name => $path) {$class = $path . DIRECTORY_SEPARATOR . str_replace('_', DIRECTORY_SEPARATOR, $className) . '.php';if (file_exists($class)) {require $class;return true;}}return false;}/*** dumps a given variable** @param mixed $var a variable of any type* @param boolean $output whether to output the content* @param string $indent indention string* @return void|string*/public static function dump($var, $output = true, $indent = ""){$ret = array();switch (gettype($var)) {case 'array':$ret[] = 'Array(';$indent .= " ";foreach ($var as $k => $v) {$ret[] = $indent . $k . ' : ' . self::dump($v, false, $indent);}$indent = substr($indent,0, -4);$ret[] = $indent . ")";break;case 'object':$ret[] = 'Object(' . get_class($var) . ')';break;default:$ret[] = var_export($var, true);}if ($output) {print implode("\n", $ret);}return implode("\n", $ret);}}