1039 lines
32 KiB
PHP
1039 lines
32 KiB
PHP
<?php
|
|
/*
|
|
* $Id: Doctrine.php 6647 2009-11-03 18:34:45Z 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.phpdoctrine.org>.
|
|
*/
|
|
|
|
/**
|
|
* Doctrine
|
|
* the base class of Doctrine framework
|
|
*
|
|
* @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.phpdoctrine.org
|
|
* @since 1.0
|
|
* @version $Revision: 6647 $
|
|
*/
|
|
final class Doctrine
|
|
{
|
|
/**
|
|
* VERSION
|
|
*/
|
|
const VERSION = '1.1.6';
|
|
|
|
/**
|
|
* 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;
|
|
|
|
/**
|
|
* 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
|
|
*/
|
|
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;
|
|
|
|
/**
|
|
* 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;
|
|
|
|
/**
|
|
* 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;
|
|
|
|
/**
|
|
* Path to Doctrine root
|
|
*
|
|
* @var string $path doctrine root directory
|
|
*/
|
|
private static $_path;
|
|
|
|
/**
|
|
* 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();
|
|
|
|
/**
|
|
* __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;
|
|
}
|
|
|
|
/**
|
|
* Get the root path to Doctrine
|
|
*
|
|
* @return string
|
|
*/
|
|
public static function getPath()
|
|
{
|
|
if ( ! self::$_path) {
|
|
self::$_path = dirname(__FILE__);
|
|
}
|
|
|
|
return self::$_path;
|
|
}
|
|
|
|
/**
|
|
* 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;
|
|
}
|
|
|
|
/**
|
|
* 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::ATTR_MODEL_LOADING to force a certain style of model loading
|
|
* Allowed Doctrine::MODEL_LOADING_AGGRESSIVE(default) or Doctrine::MODEL_LOADING_CONSERVATIVE
|
|
*/
|
|
public static function loadModels($directory, $modelLoading = null)
|
|
{
|
|
$manager = Doctrine_Manager::getInstance();
|
|
|
|
$modelLoading = $modelLoading === null ? $manager->getAttribute(Doctrine::ATTR_MODEL_LOADING):$modelLoading;
|
|
|
|
$loadedModels = array();
|
|
|
|
if ($directory !== null) {
|
|
foreach ((array) $directory as $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) {
|
|
$className = $e[0];
|
|
|
|
if ( ! class_exists($className, false)) {
|
|
if ($modelLoading == Doctrine::MODEL_LOADING_CONSERVATIVE) {
|
|
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 {
|
|
$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::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::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 $databases Array of databases to generate models for
|
|
* @param array $options Array of options
|
|
* @return boolean
|
|
* @throws Exception
|
|
*/
|
|
public static function generateModelsFromDb($directory, array $databases = array(), array $options = array())
|
|
{
|
|
return Doctrine_Manager::connection()->import->importSchema($directory, $databases, $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 $options Array of options
|
|
* @return void
|
|
*/
|
|
public static function generateYamlFromDb($yamlPath, array $databases = array(), array $options = array())
|
|
{
|
|
$directory = sys_get_temp_dir() . DIRECTORY_SEPARATOR . 'tmp_doctrine_models';
|
|
|
|
$options['generateBaseClasses'] = isset($options['generateBaseClasses']) ? $options['generateBaseClasses']:false;
|
|
$result = Doctrine::generateModelsFromDb($directory, $databases, $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);
|
|
|
|
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 (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;
|
|
}
|
|
|
|
$loadedModels = self::$_loadedModelFiles;
|
|
|
|
if (isset($loadedModels[$className]) && file_exists($loadedModels[$className])) {
|
|
require $loadedModels[$className];
|
|
|
|
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);
|
|
}
|
|
} |