2008-05-30 11:40:08 +00:00
< ? php
/* SVN FILE: $Id$ */
/**
* Object - relational mapper .
*
* DBO - backed object data model , for mapping database tables to Cake objects .
*
* PHP versions 5
*
2008-10-30 17:30:26 +00:00
* CakePHP ( tm ) : Rapid Development Framework ( http :// www . cakephp . org )
* Copyright 2005 - 2008 , Cake Software Foundation , Inc . ( http :// www . cakefoundation . org )
2008-05-30 11:40:08 +00:00
*
* Licensed under The MIT License
* Redistributions of files must retain the above copyright notice .
*
* @ filesource
2008-10-30 17:30:26 +00:00
* @ copyright Copyright 2005 - 2008 , Cake Software Foundation , Inc . ( http :// www . cakefoundation . org )
* @ link http :// www . cakefoundation . org / projects / info / cakephp CakePHP ( tm ) Project
* @ package cake
* @ subpackage cake . cake . libs . model
* @ since CakePHP ( tm ) v 0.10 . 0.0
* @ version $Revision $
* @ modifiedby $LastChangedBy $
* @ lastmodified $Date $
* @ license http :// www . opensource . org / licenses / mit - license . php The MIT License
2008-05-30 11:40:08 +00:00
*/
/**
* Included libs
*/
2008-09-26 14:03:16 +00:00
App :: import ( 'Core' , array ( 'ClassRegistry' , 'Overloadable' , 'Validation' , 'Behavior' , 'ConnectionManager' , 'Set' , 'String' ));
2008-05-30 11:40:08 +00:00
/**
* Object - relational mapper .
*
* DBO - backed object data model .
* Automatically selects a database table name based on a pluralized lowercase object class name
* ( i . e . class ' User ' => table ' users '; class ' Man ' => table ' men ' )
2008-10-31 19:05:30 +00:00
* The table is required to have at least 'id auto_increment' primary key .
2008-05-30 11:40:08 +00:00
*
2008-10-30 17:30:26 +00:00
* @ package cake
* @ subpackage cake . cake . libs . model
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 66 / Models
2008-05-30 11:40:08 +00:00
*/
class Model extends Overloadable {
/**
* The name of the DataSource connection that this Model uses
*
* @ var string
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 435 / useDbConfig
2008-05-30 11:40:08 +00:00
*/
var $useDbConfig = 'default' ;
/**
2008-10-31 19:05:30 +00:00
* Custom database table name , or null / false if no table association is desired .
2008-05-30 11:40:08 +00:00
*
* @ var string
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 436 / useTable
2008-05-30 11:40:08 +00:00
*/
var $useTable = null ;
/**
* Custom display field name . Display fields are used by Scaffold , in SELECT boxes ' OPTION elements .
*
* @ var string
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 438 / displayField
2008-05-30 11:40:08 +00:00
*/
var $displayField = null ;
/**
2008-11-08 02:54:07 +00:00
* Value of the primary key ID of the record that this model is currently pointing to .
2008-10-31 19:05:30 +00:00
* Automatically set after database insertions .
2008-05-30 11:40:08 +00:00
*
* @ var mixed
* @ access public
*/
var $id = false ;
/**
2008-10-31 19:05:30 +00:00
* Container for the data that this model gets from persistent storage ( usually , a database ) .
2008-05-30 11:40:08 +00:00
*
* @ var array
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 441 / data
2008-05-30 11:40:08 +00:00
*/
var $data = array ();
/**
* Table name for this Model .
*
* @ var string
* @ access public
*/
var $table = false ;
/**
2008-10-31 19:05:30 +00:00
* The name of the primary key field for this model .
2008-05-30 11:40:08 +00:00
*
* @ var string
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 437 / primaryKey
2008-05-30 11:40:08 +00:00
*/
var $primaryKey = null ;
/**
2008-10-31 19:05:30 +00:00
* Field - by - field table metadata .
2008-05-30 11:40:08 +00:00
*
* @ var array
* @ access protected
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 442 / _schema
2008-05-30 11:40:08 +00:00
*/
var $_schema = null ;
/**
* List of validation rules . Append entries for validation as ( 'field_name' => '/^perl_compat_regexp$/' )
* that have to match with preg_match () . Use these rules with Model :: validate ()
*
* @ var array
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 443 / validate
* @ link http :// book . cakephp . org / view / 125 / Data - Validation
2008-05-30 11:40:08 +00:00
*/
var $validate = array ();
/**
2008-10-31 19:05:30 +00:00
* List of validation errors .
2008-05-30 11:40:08 +00:00
*
* @ var array
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 410 / Validating - Data - from - the - Controller
2008-05-30 11:40:08 +00:00
*/
var $validationErrors = array ();
/**
* Database table prefix for tables in model .
*
* @ var string
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 475 / tablePrefix
2008-05-30 11:40:08 +00:00
*/
var $tablePrefix = null ;
/**
* Name of the model .
*
* @ var string
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 444 / name
2008-05-30 11:40:08 +00:00
*/
var $name = null ;
/**
* Alias name for model .
*
* @ var string
* @ access public
*/
var $alias = null ;
/**
2008-10-31 19:05:30 +00:00
* List of table names included in the model description . Used for associations .
2008-05-30 11:40:08 +00:00
*
* @ var array
* @ access public
*/
var $tableToModel = array ();
/**
2008-10-31 19:05:30 +00:00
* Whether or not to log transactions for this model .
2008-05-30 11:40:08 +00:00
*
* @ var boolean
* @ access public
*/
var $logTransactions = false ;
/**
2008-10-31 19:05:30 +00:00
* Whether or not to enable transactions for this model ( i . e . BEGIN / COMMIT / ROLLBACK statements )
2008-05-30 11:40:08 +00:00
*
* @ var boolean
* @ access public
*/
var $transactional = false ;
/**
* Whether or not to cache queries for this model . This enables in - memory
2008-10-31 19:05:30 +00:00
* caching only , the results are not stored beyond the current request .
2008-05-30 11:40:08 +00:00
*
* @ var boolean
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 445 / cacheQueries
2008-05-30 11:40:08 +00:00
*/
var $cacheQueries = false ;
/**
2008-10-31 19:05:30 +00:00
* Detailed list of belongsTo associations .
2008-05-30 11:40:08 +00:00
*
* @ var array
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 81 / belongsTo
2008-05-30 11:40:08 +00:00
*/
var $belongsTo = array ();
/**
2008-10-31 19:05:30 +00:00
* Detailed list of hasOne associations .
2008-05-30 11:40:08 +00:00
*
* @ var array
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 80 / hasOne
2008-05-30 11:40:08 +00:00
*/
var $hasOne = array ();
/**
2008-10-31 19:05:30 +00:00
* Detailed list of hasMany associations .
2008-05-30 11:40:08 +00:00
*
* @ var array
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 82 / hasMany
2008-05-30 11:40:08 +00:00
*/
var $hasMany = array ();
/**
2008-10-31 19:05:30 +00:00
* Detailed list of hasAndBelongsToMany associations .
2008-05-30 11:40:08 +00:00
*
* @ var array
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 83 / hasAndBelongsToMany - HABTM
2008-05-30 11:40:08 +00:00
*/
var $hasAndBelongsToMany = array ();
/**
* List of behaviors to load when the model object is initialized . Settings can be
* passed to behaviors by using the behavior name as index . Eg :
*
2008-10-31 19:05:30 +00:00
* var $actsAs = array ( 'Translate' , 'MyBehavior' => array ( 'setting1' => 'value1' ))
2008-05-30 11:40:08 +00:00
*
* @ var array
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 90 / Using - Behaviors
2008-05-30 11:40:08 +00:00
*/
var $actsAs = null ;
/**
2008-10-31 19:05:30 +00:00
* Holds the Behavior objects currently bound to this model .
2008-05-30 11:40:08 +00:00
*
* @ var object
* @ access public
*/
var $Behaviors = null ;
/**
2008-10-31 19:05:30 +00:00
* Whitelist of fields allowed to be saved .
2008-05-30 11:40:08 +00:00
*
* @ var array
* @ access public
*/
var $whitelist = array ();
/**
2008-10-31 19:05:30 +00:00
* Whether or not to cache sources for this model .
2008-05-30 11:40:08 +00:00
*
* @ var boolean
* @ access public
*/
var $cacheSources = true ;
/**
2008-10-31 19:05:30 +00:00
* Type of find query currently executing .
2008-05-30 11:40:08 +00:00
*
* @ var string
* @ access public
*/
var $findQueryType = null ;
/**
2008-11-08 02:54:07 +00:00
* Number of associations to recurse through during find calls . Fetches only
2008-10-31 19:05:30 +00:00
* the first level by default .
2008-05-30 11:40:08 +00:00
*
* @ var integer
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 439 / recursive
2008-05-30 11:40:08 +00:00
*/
var $recursive = 1 ;
/**
2008-11-08 02:54:07 +00:00
* The column name ( s ) and direction ( s ) to order find results by default .
*
2008-10-31 19:05:30 +00:00
* var $order = " Post.created DESC " ;
* var $order = array ( " Post.view_count DESC " , " Post.rating DESC " );
2008-05-30 11:40:08 +00:00
*
* @ var string
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 440 / order
2008-05-30 11:40:08 +00:00
*/
var $order = null ;
/**
2008-10-31 19:05:30 +00:00
* Whether or not the model record exists , set by Model :: exists () .
2008-05-30 11:40:08 +00:00
*
* @ var bool
* @ access private
*/
var $__exists = null ;
/**
2008-10-31 19:05:30 +00:00
* Default list of association keys .
2008-05-30 11:40:08 +00:00
*
* @ var array
* @ access private
*/
var $__associationKeys = array (
'belongsTo' => array ( 'className' , 'foreignKey' , 'conditions' , 'fields' , 'order' , 'counterCache' ),
'hasOne' => array ( 'className' , 'foreignKey' , 'conditions' , 'fields' , 'order' , 'dependent' ),
'hasMany' => array ( 'className' , 'foreignKey' , 'conditions' , 'fields' , 'order' , 'limit' , 'offset' , 'dependent' , 'exclusive' , 'finderQuery' , 'counterQuery' ),
'hasAndBelongsToMany' => array ( 'className' , 'joinTable' , 'with' , 'foreignKey' , 'associationForeignKey' , 'conditions' , 'fields' , 'order' , 'limit' , 'offset' , 'unique' , 'finderQuery' , 'deleteQuery' , 'insertQuery' ));
/**
2008-10-31 19:05:30 +00:00
* Holds provided / generated association key names and other data for all associations .
2008-05-30 11:40:08 +00:00
*
* @ var array
* @ access private
*/
var $__associations = array ( 'belongsTo' , 'hasOne' , 'hasMany' , 'hasAndBelongsToMany' );
/**
2008-10-31 19:05:30 +00:00
* Holds model associations temporarily to allow for dynamic ( un ) binding .
2008-05-30 11:40:08 +00:00
*
* @ var array
* @ access private
*/
var $__backAssociation = array ();
/**
2008-10-31 19:05:30 +00:00
* The ID of the model record that was last inserted .
2008-05-30 11:40:08 +00:00
*
* @ var integer
* @ access private
*/
var $__insertID = null ;
/**
2008-10-31 19:05:30 +00:00
* The number of records returned by the last query .
2008-05-30 11:40:08 +00:00
*
* @ var integer
* @ access private
*/
var $__numRows = null ;
/**
2008-10-31 19:05:30 +00:00
* The number of records affected by the last query .
2008-05-30 11:40:08 +00:00
*
* @ var integer
* @ access private
*/
var $__affectedRows = null ;
/**
2008-10-31 19:05:30 +00:00
* List of valid finder method options , supplied as the first parameter to find () .
2008-05-30 11:40:08 +00:00
*
* @ var array
2008-09-21 04:09:16 +00:00
* @ access protected
2008-05-30 11:40:08 +00:00
*/
2008-09-21 04:09:16 +00:00
var $_findMethods = array (
'all' => true , 'first' => true , 'count' => true ,
'neighbors' => true , 'list' => true , 'threaded' => true
);
2008-05-30 11:40:08 +00:00
/**
2008-10-31 19:05:30 +00:00
* Constructor . Binds the model ' s database table to the object .
2008-05-30 11:40:08 +00:00
*
* @ param integer $id Set this ID for this model on startup
* @ param string $table Name of database table to use .
* @ param object $ds DataSource connection object .
*/
function __construct ( $id = false , $table = null , $ds = null ) {
parent :: __construct ();
if ( is_array ( $id )) {
2008-08-25 22:33:36 +00:00
extract ( array_merge (
2008-09-21 04:09:16 +00:00
array (
'id' => $this -> id , 'table' => $this -> useTable , 'ds' => $this -> useDbConfig ,
'name' => $this -> name , 'alias' => $this -> alias
),
$id
));
2008-05-30 11:40:08 +00:00
}
if ( $this -> name === null ) {
2008-09-21 04:09:16 +00:00
$this -> name = ( isset ( $name ) ? $name : get_class ( $this ));
2008-05-30 11:40:08 +00:00
}
if ( $this -> alias === null ) {
2008-09-21 04:09:16 +00:00
$this -> alias = ( isset ( $alias ) ? $alias : $this -> name );
2008-05-30 11:40:08 +00:00
}
if ( $this -> primaryKey === null ) {
$this -> primaryKey = 'id' ;
}
2008-09-26 15:27:36 +00:00
2008-05-30 11:40:08 +00:00
ClassRegistry :: addObject ( $this -> alias , $this );
$this -> id = $id ;
unset ( $id );
if ( $table === false ) {
$this -> useTable = false ;
} elseif ( $table ) {
$this -> useTable = $table ;
}
2008-09-21 04:09:16 +00:00
if ( is_subclass_of ( $this , 'AppModel' )) {
$appVars = get_class_vars ( 'AppModel' );
$merge = array ( '_findMethods' );
if ( $this -> actsAs !== null || $this -> actsAs !== false ) {
$merge [] = 'actsAs' ;
}
2008-11-14 20:24:27 +00:00
$parentClass = get_parent_class ( $this );
if ( strtolower ( $parentClass ) !== 'appmodel' ) {
$parentVars = get_class_vars ( $parentClass );
foreach ( $merge as $var ) {
if ( isset ( $parentVars [ $var ]) && ! empty ( $parentVars [ $var ])) {
$appVars [ $var ] = Set :: merge ( $appVars [ $var ], $parentVars [ $var ]);
}
}
}
2008-09-21 04:09:16 +00:00
foreach ( $merge as $var ) {
if ( isset ( $appVars [ $var ]) && ! empty ( $appVars [ $var ]) && is_array ( $this -> { $var })) {
$this -> { $var } = Set :: merge ( $appVars [ $var ], $this -> { $var });
}
}
}
$this -> Behaviors = new BehaviorCollection ();
2008-05-30 11:40:08 +00:00
if ( $this -> useTable !== false ) {
$this -> setDataSource ( $ds );
if ( $this -> useTable === null ) {
$this -> useTable = Inflector :: tableize ( $this -> name );
}
2008-07-27 15:55:49 +00:00
if ( method_exists ( $this , 'setTablePrefix' )) {
2008-05-30 11:40:08 +00:00
$this -> setTablePrefix ();
}
$this -> setSource ( $this -> useTable );
if ( $this -> displayField == null ) {
$this -> displayField = $this -> hasField ( array ( 'title' , 'name' , $this -> primaryKey ));
}
2008-10-15 17:30:08 +00:00
} elseif ( $this -> table === false ) {
$this -> table = Inflector :: tableize ( $this -> name );
2008-05-30 11:40:08 +00:00
}
2008-10-15 17:30:08 +00:00
$this -> __createLinks ();
2008-09-22 16:32:41 +00:00
$this -> Behaviors -> init ( $this -> alias , $this -> actsAs );
2008-05-30 11:40:08 +00:00
}
/**
* Handles custom method calls , like findBy < field > for DB models ,
* and custom RPC calls for remote data sources .
*
* @ param string $method Name of method to call .
* @ param array $params Parameters for the method .
* @ return mixed Whatever is returned by called method
* @ access protected
*/
function call__ ( $method , $params ) {
$result = $this -> Behaviors -> dispatchMethod ( $this , $method , $params );
if ( $result !== array ( 'unhandled' )) {
return $result ;
}
$db =& ConnectionManager :: getDataSource ( $this -> useDbConfig );
$return = $db -> query ( $method , $params , $this );
if ( ! PHP5 ) {
$this -> resetAssociations ();
}
return $return ;
}
/**
* Bind model associations on the fly .
*
* If $permanent is true , association will not be reset
* to the originals defined in the model .
*
* @ param mixed $model A model or association name ( string ) or set of binding options ( indexed by model name type )
* @ param array $options If $model is a string , this is the list of association properties with which $model will
* be bound
* @ param boolean $permanent Set to true to make the binding permanent
2008-09-25 16:49:56 +00:00
* @ return void
2008-05-30 11:40:08 +00:00
* @ access public
* @ todo
*/
function bind ( $model , $options = array (), $permanent = true ) {
if ( ! is_array ( $model )) {
$model = array ( $model => $options );
}
foreach ( $model as $name => $options ) {
if ( isset ( $options [ 'type' ])) {
$assoc = $options [ 'type' ];
} elseif ( isset ( $options [ 0 ])) {
$assoc = $options [ 0 ];
} else {
$assoc = 'belongsTo' ;
}
if ( ! $permanent ) {
$this -> __backAssociation [ $assoc ] = $this -> { $assoc };
}
foreach ( $model as $key => $value ) {
$assocName = $modelName = $key ;
if ( isset ( $this -> { $assoc }[ $assocName ])) {
$this -> { $assoc }[ $assocName ] = array_merge ( $this -> { $assoc }[ $assocName ], $options );
} else {
if ( isset ( $value [ 'className' ])) {
$modelName = $value [ 'className' ];
}
$this -> __constructLinkedModel ( $assocName , $modelName );
$this -> { $assoc }[ $assocName ] = $model [ $assocName ];
$this -> __generateAssociation ( $assoc );
}
unset ( $this -> { $assoc }[ $assocName ][ 'type' ], $this -> { $assoc }[ $assocName ][ 0 ]);
}
}
}
/**
* Bind model associations on the fly .
*
* If $reset is false , association will not be reset
* to the originals defined in the model
*
* Example : Add a new hasOne binding to the Profile model not
* defined in the model source code :
* < code >
* $this -> User -> bindModel ( array ( 'hasOne' => array ( 'Profile' )) );
* </ code >
*
* @ param array $params Set of bindings ( indexed by binding type )
* @ param boolean $reset Set to false to make the binding permanent
* @ return boolean Success
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 86 / Creating - and - Destroying - Associations - on - the - Fly
2008-05-30 11:40:08 +00:00
*/
function bindModel ( $params , $reset = true ) {
foreach ( $params as $assoc => $model ) {
if ( $reset === true ) {
$this -> __backAssociation [ $assoc ] = $this -> { $assoc };
}
foreach ( $model as $key => $value ) {
$assocName = $key ;
if ( is_numeric ( $key )) {
$assocName = $value ;
$value = array ();
}
$modelName = $assocName ;
$this -> { $assoc }[ $assocName ] = $value ;
}
}
$this -> __createLinks ();
return true ;
}
/**
* Turn off associations on the fly .
*
* If $reset is false , association will not be reset
* to the originals defined in the model
*
* Example : Turn off the associated Model Support request ,
* to temporarily lighten the User model :
* < code >
* $this -> User -> unbindModel ( array ( 'hasMany' => array ( 'Supportrequest' )) );
* </ code >
*
* @ param array $params Set of bindings to unbind ( indexed by binding type )
* @ param boolean $reset Set to false to make the unbinding permanent
* @ return boolean Success
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 86 / Creating - and - Destroying - Associations - on - the - Fly
2008-05-30 11:40:08 +00:00
*/
function unbindModel ( $params , $reset = true ) {
foreach ( $params as $assoc => $models ) {
if ( $reset === true ) {
$this -> __backAssociation [ $assoc ] = $this -> { $assoc };
}
foreach ( $models as $model ) {
$this -> __backAssociation = array_merge ( $this -> __backAssociation , $this -> { $assoc });
unset ( $this -> __backAssociation [ $model ]);
unset ( $this -> { $assoc }[ $model ]);
}
}
return true ;
}
/**
2008-10-31 19:05:30 +00:00
* Create a set of associations .
2008-05-30 11:40:08 +00:00
*
2008-09-25 16:49:56 +00:00
* @ return void
2008-05-30 11:40:08 +00:00
* @ access private
*/
function __createLinks () {
foreach ( $this -> __associations as $type ) {
if ( ! is_array ( $this -> { $type })) {
$this -> { $type } = explode ( ',' , $this -> { $type });
foreach ( $this -> { $type } as $i => $className ) {
$className = trim ( $className );
unset ( $this -> { $type }[ $i ]);
$this -> { $type }[ $className ] = array ();
}
}
2008-06-11 08:54:27 +00:00
if ( ! empty ( $this -> { $type })) {
foreach ( $this -> { $type } as $assoc => $value ) {
$plugin = null ;
2008-05-30 11:40:08 +00:00
2008-06-11 08:54:27 +00:00
if ( is_numeric ( $assoc )) {
unset ( $this -> { $type }[ $assoc ]);
$assoc = $value ;
$value = array ();
2008-05-30 11:40:08 +00:00
$this -> { $type }[ $assoc ] = $value ;
2008-06-11 08:54:27 +00:00
if ( strpos ( $assoc , '.' ) !== false ) {
$value = $this -> { $type }[ $assoc ];
unset ( $this -> { $type }[ $assoc ]);
list ( $plugin , $assoc ) = explode ( '.' , $assoc );
$this -> { $type }[ $assoc ] = $value ;
$plugin = $plugin . '.' ;
}
2008-05-30 11:40:08 +00:00
}
2008-06-11 08:54:27 +00:00
$className = $assoc ;
if ( isset ( $value [ 'className' ]) && ! empty ( $value [ 'className' ])) {
$className = $value [ 'className' ];
if ( strpos ( $className , '.' ) !== false ) {
list ( $plugin , $className ) = explode ( '.' , $className );
$plugin = $plugin . '.' ;
$this -> { $type }[ $assoc ][ 'className' ] = $className ;
}
2008-05-30 11:40:08 +00:00
}
2008-06-11 08:54:27 +00:00
$this -> __constructLinkedModel ( $assoc , $plugin . $className );
2008-05-30 11:40:08 +00:00
}
2008-06-11 08:54:27 +00:00
$this -> __generateAssociation ( $type );
2008-05-30 11:40:08 +00:00
}
}
}
/**
2008-10-31 19:05:30 +00:00
* Private helper method to create associated models of a given class .
2008-05-30 11:40:08 +00:00
*
* @ param string $assoc Association name
* @ param string $className Class name
* @ deprecated $this -> $className use $this -> $assoc instead . $assoc is the 'key' in the associations array ;
* examples : var $hasMany = array ( 'Assoc' => array ( 'className' => 'ModelName' ));
* usage : $this -> Assoc -> modelMethods ();
*
* var $hasMany = array ( 'ModelName' );
* usage : $this -> ModelName -> modelMethods ();
2008-09-25 16:49:56 +00:00
* @ return void
2008-05-30 11:40:08 +00:00
* @ access private
*/
function __constructLinkedModel ( $assoc , $className = null ) {
2008-10-23 00:10:44 +00:00
if ( empty ( $className )) {
2008-05-30 11:40:08 +00:00
$className = $assoc ;
}
2008-09-19 15:27:43 +00:00
if ( ! isset ( $this -> { $assoc }) || $this -> { $assoc } -> name !== $className ) {
2008-06-11 08:54:27 +00:00
$model = array ( 'class' => $className , 'alias' => $assoc );
if ( PHP5 ) {
$this -> { $assoc } = ClassRegistry :: init ( $model );
} else {
$this -> { $assoc } =& ClassRegistry :: init ( $model );
}
if ( $assoc ) {
$this -> tableToModel [ $this -> { $assoc } -> table ] = $assoc ;
}
2008-05-30 11:40:08 +00:00
}
}
/**
2008-10-31 19:05:30 +00:00
* Build an array - based association from string .
2008-05-30 11:40:08 +00:00
*
* @ param string $type 'belongsTo' , 'hasOne' , 'hasMany' , 'hasAndBelongsToMany'
2008-09-25 16:49:56 +00:00
* @ return void
2008-05-30 11:40:08 +00:00
* @ access private
*/
function __generateAssociation ( $type ) {
foreach ( $this -> { $type } as $assocKey => $assocData ) {
$class = $assocKey ;
2008-10-13 01:17:34 +00:00
$dynamicWith = false ;
2008-05-30 11:40:08 +00:00
foreach ( $this -> __associationKeys [ $type ] as $key ) {
2008-10-12 22:21:55 +00:00
2008-05-30 11:40:08 +00:00
if ( ! isset ( $this -> { $type }[ $assocKey ][ $key ]) || $this -> { $type }[ $assocKey ][ $key ] === null ) {
$data = '' ;
2008-10-23 00:10:44 +00:00
switch ( $key ) {
2008-05-30 11:40:08 +00:00
case 'fields' :
$data = '' ;
break ;
case 'foreignKey' :
2008-07-30 16:26:48 +00:00
$data = (( $type == 'belongsTo' ) ? Inflector :: underscore ( $assocKey ) : Inflector :: singularize ( $this -> table )) . '_id' ;
2008-05-30 11:40:08 +00:00
break ;
case 'associationForeignKey' :
$data = Inflector :: singularize ( $this -> { $class } -> table ) . '_id' ;
break ;
case 'with' :
$data = Inflector :: camelize ( Inflector :: singularize ( $this -> { $type }[ $assocKey ][ 'joinTable' ]));
2008-10-12 02:16:43 +00:00
$dynamicWith = true ;
2008-05-30 11:40:08 +00:00
break ;
case 'joinTable' :
$tables = array ( $this -> table , $this -> { $class } -> table );
sort ( $tables );
$data = $tables [ 0 ] . '_' . $tables [ 1 ];
break ;
case 'className' :
$data = $class ;
break ;
case 'unique' :
$data = true ;
break ;
}
$this -> { $type }[ $assocKey ][ $key ] = $data ;
}
}
2008-08-11 16:18:19 +00:00
if ( ! empty ( $this -> { $type }[ $assocKey ][ 'with' ])) {
2008-05-30 11:40:08 +00:00
$joinClass = $this -> { $type }[ $assocKey ][ 'with' ];
if ( is_array ( $joinClass )) {
$joinClass = key ( $joinClass );
}
$plugin = null ;
if ( strpos ( $joinClass , '.' ) !== false ) {
list ( $plugin , $joinClass ) = explode ( '.' , $joinClass );
$plugin = $plugin . '.' ;
$this -> { $type }[ $assocKey ][ 'with' ] = $joinClass ;
}
2008-10-12 02:16:43 +00:00
if ( ! ClassRegistry :: isKeySet ( $joinClass ) && $dynamicWith === true ) {
2008-05-30 11:40:08 +00:00
$this -> { $joinClass } = new AppModel ( array (
'name' => $joinClass ,
'table' => $this -> { $type }[ $assocKey ][ 'joinTable' ],
'ds' => $this -> useDbConfig
));
2008-12-23 23:28:08 +00:00
} else {
2008-05-30 11:40:08 +00:00
$this -> __constructLinkedModel ( $joinClass , $plugin . $joinClass );
2008-07-31 15:38:23 +00:00
$this -> { $type }[ $assocKey ][ 'joinTable' ] = $this -> { $joinClass } -> table ;
2008-05-30 11:40:08 +00:00
}
2008-08-11 16:18:19 +00:00
2008-12-23 23:28:08 +00:00
if ( count ( $this -> { $joinClass } -> schema ()) <= 2 && $this -> { $joinClass } -> primaryKey !== false ) {
2008-08-11 16:18:19 +00:00
$this -> { $joinClass } -> primaryKey = $this -> { $type }[ $assocKey ][ 'foreignKey' ];
}
2008-05-30 11:40:08 +00:00
}
}
}
/**
* Sets a custom table for your controller class . Used by your controller to select a database table .
*
* @ param string $tableName Name of the custom table
2008-09-25 16:49:56 +00:00
* @ return void
2008-05-30 11:40:08 +00:00
* @ access public
*/
function setSource ( $tableName ) {
$this -> setDataSource ( $this -> useDbConfig );
$db =& ConnectionManager :: getDataSource ( $this -> useDbConfig );
2008-08-27 04:55:15 +00:00
$db -> cacheSources = ( $this -> cacheSources && $db -> cacheSources );
2008-05-30 11:40:08 +00:00
if ( $db -> isInterfaceSupported ( 'listSources' )) {
$sources = $db -> listSources ();
if ( is_array ( $sources ) && ! in_array ( strtolower ( $this -> tablePrefix . $tableName ), array_map ( 'strtolower' , $sources ))) {
return $this -> cakeError ( 'missingTable' , array ( array (
'className' => $this -> alias ,
'table' => $this -> tablePrefix . $tableName
)));
}
$this -> _schema = null ;
}
$this -> table = $this -> useTable = $tableName ;
$this -> tableToModel [ $this -> table ] = $this -> alias ;
$this -> schema ();
}
/**
* This function does two things : 1 ) it scans the array $one for the primary key ,
* and if that ' s found , it sets the current id to the value of $one [ id ] .
* For all other keys than 'id' the keys and values of $one are copied to the 'data' property of this object .
* 2 ) Returns an array with all of $one ' s keys and values .
* ( Alternative indata : two strings , which are mangled to
* a one - item , two - dimensional array using $one for a key and $two as its value . )
*
* @ param mixed $one Array or string of data
* @ param string $two Value string for the alternative indata method
* @ return array Data with all of $one ' s keys and values
* @ access public
*/
function set ( $one , $two = null ) {
if ( ! $one ) {
return ;
}
if ( is_object ( $one )) {
$one = Set :: reverse ( $one );
}
if ( is_array ( $one )) {
2008-06-14 20:39:27 +00:00
$data = $one ;
if ( empty ( $one [ $this -> alias ])) {
2008-08-01 06:28:59 +00:00
if ( $this -> getAssociated ( key ( $one )) === null ) {
2008-06-14 20:39:27 +00:00
$data = array ( $this -> alias => $one );
}
2008-05-30 11:40:08 +00:00
}
} else {
$data = array ( $this -> alias => array ( $one => $two ));
}
2008-10-06 02:44:05 +00:00
foreach ( $data as $modelName => $fieldSet ) {
if ( is_array ( $fieldSet )) {
2008-05-30 11:40:08 +00:00
2008-10-06 02:44:05 +00:00
foreach ( $fieldSet as $fieldName => $fieldValue ) {
if ( isset ( $this -> validationErrors [ $fieldName ])) {
unset ( $this -> validationErrors [ $fieldName ]);
2008-05-30 11:40:08 +00:00
}
2008-10-06 02:44:05 +00:00
if ( $modelName === $this -> alias ) {
if ( $fieldName === $this -> primaryKey ) {
$this -> id = $fieldValue ;
2008-05-30 11:40:08 +00:00
}
}
2008-10-06 02:44:05 +00:00
if ( is_array ( $fieldValue ) || is_object ( $fieldValue )) {
$fieldValue = $this -> deconstruct ( $fieldName , $fieldValue );
2008-05-30 11:40:08 +00:00
}
2008-10-06 02:44:05 +00:00
$this -> data [ $modelName ][ $fieldName ] = $fieldValue ;
2008-05-30 11:40:08 +00:00
}
}
}
return $data ;
}
/**
2008-10-31 19:05:30 +00:00
* Deconstructs a complex data type ( array or object ) into a single field value .
2008-05-30 11:40:08 +00:00
*
* @ param string $field The name of the field to be deconstructed
* @ param mixed $data An array or object to be deconstructed into a field
* @ return mixed The resulting data that should be assigned to a field
* @ access public
*/
function deconstruct ( $field , $data ) {
$copy = $data ;
$type = $this -> getColumnType ( $field );
$db =& ConnectionManager :: getDataSource ( $this -> useDbConfig );
if ( in_array ( $type , array ( 'datetime' , 'timestamp' , 'date' , 'time' ))) {
$useNewDate = ( isset ( $data [ 'year' ]) || isset ( $data [ 'month' ]) || isset ( $data [ 'day' ]) || isset ( $data [ 'hour' ]) || isset ( $data [ 'minute' ]));
$dateFields = array ( 'Y' => 'year' , 'm' => 'month' , 'd' => 'day' , 'H' => 'hour' , 'i' => 'min' , 's' => 'sec' );
$format = $db -> columns [ $type ][ 'format' ];
$date = array ();
if ( isset ( $data [ 'hour' ]) && isset ( $data [ 'meridian' ]) && $data [ 'hour' ] != 12 && 'pm' == $data [ 'meridian' ]) {
$data [ 'hour' ] = $data [ 'hour' ] + 12 ;
}
if ( isset ( $data [ 'hour' ]) && isset ( $data [ 'meridian' ]) && $data [ 'hour' ] == 12 && 'am' == $data [ 'meridian' ]) {
$data [ 'hour' ] = '00' ;
}
foreach ( $dateFields as $key => $val ) {
if ( in_array ( $val , array ( 'hour' , 'min' , 'sec' ))) {
if ( ! isset ( $data [ $val ]) || $data [ $val ] === '0' || empty ( $data [ $val ])) {
$data [ $val ] = '00' ;
} else {
$data [ $val ] = sprintf ( '%02d' , $data [ $val ]);
}
}
if ( in_array ( $type , array ( 'datetime' , 'timestamp' , 'date' )) && ! isset ( $data [ $val ]) || isset ( $data [ $val ]) && ( empty ( $data [ $val ]) || $data [ $val ][ 0 ] === '-' )) {
return null ;
} elseif ( isset ( $data [ $val ]) && ! empty ( $data [ $val ])) {
$date [ $key ] = $data [ $val ];
}
}
$date = str_replace ( array_keys ( $date ), array_values ( $date ), $format );
2008-10-26 15:02:01 +00:00
if ( $type == 'time' && $date == '00:00:00' ) {
return null ;
}
2008-05-30 11:40:08 +00:00
if ( $useNewDate && ( ! empty ( $date ))) {
return $date ;
}
}
return $data ;
}
/**
* Returns an array of table metadata ( column names and types ) from the database .
* $field => keys ( type , null , default , key , length , extra )
*
* @ param mixed $field Set to true to reload schema , or a string to return a specific field
* @ return array Array of table metadata
* @ access public
*/
function schema ( $field = false ) {
if ( ! is_array ( $this -> _schema ) || $field === true ) {
$db =& ConnectionManager :: getDataSource ( $this -> useDbConfig );
2008-08-27 04:55:15 +00:00
$db -> cacheSources = ( $this -> cacheSources && $db -> cacheSources );
2008-05-30 11:40:08 +00:00
if ( $db -> isInterfaceSupported ( 'describe' ) && $this -> useTable !== false ) {
$this -> _schema = $db -> describe ( $this , $field );
} elseif ( $this -> useTable === false ) {
$this -> _schema = array ();
}
}
if ( is_string ( $field )) {
if ( isset ( $this -> _schema [ $field ])) {
return $this -> _schema [ $field ];
} else {
return null ;
}
}
return $this -> _schema ;
}
/**
* Returns an associative array of field names and column types .
*
* @ return array Field types indexed by field name
* @ access public
*/
function getColumnTypes () {
$columns = $this -> schema ();
if ( empty ( $columns )) {
trigger_error ( __ ( '(Model::getColumnTypes) Unable to build model field data. If you are using a model without a database table, try implementing schema()' , true ), E_USER_WARNING );
}
$cols = array ();
foreach ( $columns as $field => $values ) {
$cols [ $field ] = $values [ 'type' ];
}
return $cols ;
}
/**
2008-10-31 19:05:30 +00:00
* Returns the column type of a column in the model .
2008-05-30 11:40:08 +00:00
*
* @ param string $column The name of the model column
* @ return string Column type
* @ access public
*/
function getColumnType ( $column ) {
2008-11-10 19:53:04 +00:00
$db =& ConnectionManager :: getDataSource ( $this -> useDbConfig );
2008-05-30 11:40:08 +00:00
$cols = $this -> schema ();
$model = null ;
2008-11-10 19:53:04 +00:00
$column = str_replace ( array ( $db -> startQuote , $db -> endQuote ), '' , $column );
2008-05-30 11:40:08 +00:00
if ( strpos ( $column , '.' )) {
list ( $model , $column ) = explode ( '.' , $column );
}
if ( $model != $this -> alias && isset ( $this -> { $model })) {
return $this -> { $model } -> getColumnType ( $column );
}
if ( isset ( $cols [ $column ]) && isset ( $cols [ $column ][ 'type' ])) {
return $cols [ $column ][ 'type' ];
}
return null ;
}
/**
2008-10-31 19:05:30 +00:00
* Returns true if the supplied field exists in the model ' s database table .
2008-05-30 11:40:08 +00:00
*
* @ param mixed $name Name of field to look for , or an array of names
* @ return mixed If $name is a string , returns a boolean indicating whether the field exists .
* If $name is an array of field names , returns the first field that exists ,
* or false if none exist .
* @ access public
*/
function hasField ( $name ) {
if ( is_array ( $name )) {
foreach ( $name as $n ) {
if ( $this -> hasField ( $n )) {
return $n ;
}
}
return false ;
}
if ( empty ( $this -> _schema )) {
$this -> schema ();
}
if ( $this -> _schema != null ) {
return isset ( $this -> _schema [ $name ]);
}
return false ;
}
/**
* Initializes the model for writing a new record , loading the default values
2008-10-31 19:05:30 +00:00
* for those fields that are not defined in $data . Especially helpful for
* saving data in loops .
2008-05-30 11:40:08 +00:00
*
* @ param mixed $data Optional data array to assign to the model after it is created . If null or false ,
* schema data defaults are not merged .
* @ param boolean $filterKey If true , overwrites any primary key input with an empty value
* @ return array The current Model :: data ; after merging $data and / or defaults from database
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 75 / Saving - Your - Data
2008-05-30 11:40:08 +00:00
*/
function create ( $data = array (), $filterKey = false ) {
$defaults = array ();
$this -> id = false ;
$this -> data = array ();
2008-11-19 15:53:41 +00:00
$this -> __exists = null ;
2008-05-30 11:40:08 +00:00
$this -> validationErrors = array ();
if ( $data !== null && $data !== false ) {
foreach ( $this -> schema () as $field => $properties ) {
if ( $this -> primaryKey !== $field && isset ( $properties [ 'default' ])) {
$defaults [ $field ] = $properties [ 'default' ];
}
}
$this -> set ( Set :: filter ( $defaults ));
$this -> set ( $data );
}
if ( $filterKey ) {
$this -> set ( $this -> primaryKey , false );
}
return $this -> data ;
}
/**
* Returns a list of fields from the database , and sets the current model
* data ( Model :: $data ) with the record found .
*
* @ param mixed $fields String of single fieldname , or an array of fieldnames .
* @ param mixed $id The ID of the record to read
* @ return array Array of database fields , or false if not found
* @ access public
*/
function read ( $fields = null , $id = null ) {
$this -> validationErrors = array ();
if ( $id != null ) {
$this -> id = $id ;
}
$id = $this -> id ;
if ( is_array ( $this -> id )) {
$id = $this -> id [ 0 ];
}
if ( $id !== null && $id !== false ) {
$this -> data = $this -> find ( array ( $this -> alias . '.' . $this -> primaryKey => $id ), $fields );
return $this -> data ;
} else {
return false ;
}
}
/**
2008-10-31 19:05:30 +00:00
* Returns the contents of a single field given the supplied conditions , in the
* supplied order .
2008-05-30 11:40:08 +00:00
*
* @ param string $name Name of field to get
* @ param array $conditions SQL conditions ( defaults to NULL )
* @ param string $order SQL ORDER BY fragment
* @ return string field contents , or false if not found
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 453 / field
2008-05-30 11:40:08 +00:00
*/
function field ( $name , $conditions = null , $order = null ) {
if ( $conditions === null && $this -> id !== false ) {
$conditions = array ( $this -> alias . '.' . $this -> primaryKey => $this -> id );
}
if ( $this -> recursive >= 1 ) {
$recursive = - 1 ;
} else {
$recursive = $this -> recursive ;
}
if ( $data = $this -> find ( $conditions , $name , $order , $recursive )) {
if ( strpos ( $name , '.' ) === false ) {
if ( isset ( $data [ $this -> alias ][ $name ])) {
return $data [ $this -> alias ][ $name ];
}
} else {
$name = explode ( '.' , $name );
if ( isset ( $data [ $name [ 0 ]][ $name [ 1 ]])) {
return $data [ $name [ 0 ]][ $name [ 1 ]];
}
}
if ( isset ( $data [ 0 ]) && count ( $data [ 0 ]) > 0 ) {
$name = key ( $data [ 0 ]);
return $data [ 0 ][ $name ];
}
} else {
return false ;
}
}
/**
2008-10-31 19:05:30 +00:00
* Saves the value of a single field to the database , based on the current
* model ID .
2008-05-30 11:40:08 +00:00
*
* @ param string $name Name of the table field
* @ param mixed $value Value of the field
2008-07-05 11:02:09 +00:00
* @ param array $validate See $options param in Model :: save () . Does not respect 'fieldList' key if passed
2008-06-20 20:17:23 +00:00
* @ return boolean See Model :: save ()
2008-05-30 11:40:08 +00:00
* @ access public
* @ see Model :: save ()
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 75 / Saving - Your - Data
2008-05-30 11:40:08 +00:00
*/
function saveField ( $name , $value , $validate = false ) {
$id = $this -> id ;
$this -> create ( false );
2008-06-20 20:17:23 +00:00
if ( is_array ( $validate )) {
2008-07-05 11:02:09 +00:00
$options = array_merge ( array ( 'validate' => false , 'fieldList' => array ( $name )), $validate );
2008-06-20 20:17:23 +00:00
} else {
$options = array ( 'validate' => $validate , 'fieldList' => array ( $name ));
}
2008-07-05 11:02:09 +00:00
return $this -> save ( array ( $this -> alias => array ( $this -> primaryKey => $id , $name => $value )), $options );
2008-05-30 11:40:08 +00:00
}
/**
2008-11-08 02:54:07 +00:00
* Saves model data ( based on white - list , if supplied ) to the database . By
2008-10-31 19:05:30 +00:00
* default , validation occurs before save .
2008-05-30 11:40:08 +00:00
*
* @ param array $data Data to save .
2008-08-23 21:31:38 +00:00
* @ param mixed $validate Either a boolean , or an array .
* If a boolean , indicates whether or not to validate before saving .
* If an array , allows control of validate , callbacks , and fieldList
2008-05-30 11:40:08 +00:00
* @ param array $fieldList List of fields to allow to be written
* @ return mixed On success Model :: $data if its not empty or true , false on failure
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 75 / Saving - Your - Data
2008-05-30 11:40:08 +00:00
*/
function save ( $data = null , $validate = true , $fieldList = array ()) {
$defaults = array ( 'validate' => true , 'fieldList' => array (), 'callbacks' => true );
2008-09-04 01:00:08 +00:00
$_whitelist = $this -> whitelist ;
2008-05-30 11:40:08 +00:00
$fields = array ();
if ( ! is_array ( $validate )) {
$options = array_merge ( $defaults , compact ( 'validate' , 'fieldList' , 'callbacks' ));
} else {
$options = array_merge ( $defaults , $validate );
}
if ( ! empty ( $options [ 'fieldList' ])) {
$this -> whitelist = $options [ 'fieldList' ];
} elseif ( $options [ 'fieldList' ] === null ) {
$this -> whitelist = array ();
}
$this -> set ( $data );
if ( empty ( $this -> data ) && ! $this -> hasField ( array ( 'created' , 'updated' , 'modified' ))) {
return false ;
}
foreach ( array ( 'created' , 'updated' , 'modified' ) as $field ) {
2008-09-04 01:00:08 +00:00
$keyPresentAndEmpty = (
isset ( $this -> data [ $this -> alias ]) &&
array_key_exists ( $field , $this -> data [ $this -> alias ]) &&
$this -> data [ $this -> alias ][ $field ] === null
);
if ( $keyPresentAndEmpty ) {
2008-05-30 11:40:08 +00:00
unset ( $this -> data [ $this -> alias ][ $field ]);
}
}
2008-06-15 02:58:23 +00:00
$this -> exists ();
2008-05-30 11:40:08 +00:00
$dateFields = array ( 'modified' , 'updated' );
2008-06-15 02:58:23 +00:00
if ( ! $this -> __exists ) {
2008-05-30 11:40:08 +00:00
$dateFields [] = 'created' ;
}
if ( isset ( $this -> data [ $this -> alias ])) {
$fields = array_keys ( $this -> data [ $this -> alias ]);
}
if ( $options [ 'validate' ] && ! $this -> validates ( $options )) {
$this -> whitelist = $_whitelist ;
return false ;
}
2008-09-04 01:00:08 +00:00
$db =& ConnectionManager :: getDataSource ( $this -> useDbConfig );
2008-05-30 11:40:08 +00:00
foreach ( $dateFields as $updateCol ) {
if ( $this -> hasField ( $updateCol ) && ! in_array ( $updateCol , $fields )) {
2008-12-17 04:13:45 +00:00
$default = array ( 'formatter' => 'date' );
$colType = array_merge ( $default , $db -> columns [ $this -> getColumnType ( $updateCol )]);
if ( ! array_key_exists ( 'format' , $colType )) {
2008-05-30 11:40:08 +00:00
$time = strtotime ( 'now' );
} else {
$time = $colType [ 'formatter' ]( $colType [ 'format' ]);
}
if ( ! empty ( $this -> whitelist )) {
$this -> whitelist [] = $updateCol ;
}
$this -> set ( $updateCol , $time );
}
}
2008-06-20 20:17:23 +00:00
if ( $options [ 'callbacks' ] === true || $options [ 'callbacks' ] === 'before' ) {
2008-12-17 04:13:45 +00:00
$result = $this -> Behaviors -> trigger ( $this , 'beforeSave' , array ( $options ), array (
'break' => true , 'breakOn' => false
));
if ( ! $result || ! $this -> beforeSave ( $options )) {
2008-05-30 11:40:08 +00:00
$this -> whitelist = $_whitelist ;
return false ;
}
}
$fields = $values = array ();
if ( isset ( $this -> data [ $this -> alias ][ $this -> primaryKey ]) && empty ( $this -> data [ $this -> alias ][ $this -> primaryKey ])) {
unset ( $this -> data [ $this -> alias ][ $this -> primaryKey ]);
}
foreach ( $this -> data as $n => $v ) {
if ( isset ( $this -> hasAndBelongsToMany [ $n ])) {
if ( isset ( $v [ $n ])) {
$v = $v [ $n ];
}
$joined [ $n ] = $v ;
} else {
if ( $n === $this -> alias ) {
foreach ( array ( 'created' , 'updated' , 'modified' ) as $field ) {
if ( array_key_exists ( $field , $v ) && empty ( $v [ $field ])) {
unset ( $v [ $field ]);
}
}
foreach ( $v as $x => $y ) {
if ( $this -> hasField ( $x ) && ( empty ( $this -> whitelist ) || in_array ( $x , $this -> whitelist ))) {
list ( $fields [], $values []) = array ( $x , $y );
}
}
}
}
}
$count = count ( $fields );
2008-06-15 02:58:23 +00:00
if ( ! $this -> __exists && $count > 0 ) {
2008-05-30 11:40:08 +00:00
$this -> id = false ;
}
$success = true ;
$created = false ;
if ( $count > 0 ) {
2008-12-17 04:13:45 +00:00
$cache = $this -> _prepareUpdateFields ( array_combine ( $fields , $values ));
2008-05-30 11:40:08 +00:00
if ( ! empty ( $this -> id )) {
2008-12-17 04:13:45 +00:00
$success = ( bool ) $db -> update ( $this , $fields , $values );
2008-05-30 11:40:08 +00:00
} else {
foreach ( $this -> _schema as $field => $properties ) {
if ( $this -> primaryKey === $field ) {
2008-12-17 04:13:45 +00:00
$fInfo = $this -> _schema [ $field ];
$isUUID = (
( $fInfo [ 'type' ] === 'string' && $fInfo [ 'length' ] === 36 ) ||
( $fInfo [ 'type' ] === 'binary' && $fInfo [ 'length' ] === 16 )
);
2008-05-30 11:40:08 +00:00
if ( empty ( $this -> data [ $this -> alias ][ $this -> primaryKey ]) && $isUUID ) {
list ( $fields [], $values []) = array ( $this -> primaryKey , String :: uuid ());
}
break ;
}
}
if ( ! $db -> create ( $this , $fields , $values )) {
$success = $created = false ;
} else {
$created = true ;
}
}
2008-12-17 04:13:45 +00:00
if ( $success && ! empty ( $this -> belongsTo )) {
$this -> updateCounterCache ( $cache , $created );
}
2008-05-30 11:40:08 +00:00
}
if ( ! empty ( $joined ) && $success === true ) {
$this -> __saveMulti ( $joined , $this -> id );
}
if ( $success && $count > 0 ) {
if ( ! empty ( $this -> data )) {
$success = $this -> data ;
}
2008-06-20 20:17:23 +00:00
if ( $options [ 'callbacks' ] === true || $options [ 'callbacks' ] === 'after' ) {
2008-05-30 11:40:08 +00:00
$this -> Behaviors -> trigger ( $this , 'afterSave' , array ( $created , $options ));
$this -> afterSave ( $created );
}
if ( ! empty ( $this -> data )) {
$success = Set :: merge ( $success , $this -> data );
}
$this -> data = false ;
$this -> __exists = null ;
$this -> _clearCache ();
$this -> validationErrors = array ();
}
$this -> whitelist = $_whitelist ;
return $success ;
}
/**
* Saves model hasAndBelongsToMany data to the database .
*
* @ param array $joined Data to save
* @ param mixed $id ID of record in this model
* @ access private
*/
function __saveMulti ( $joined , $id ) {
$db =& ConnectionManager :: getDataSource ( $this -> useDbConfig );
2008-10-29 07:19:26 +00:00
foreach ( $joined as $assoc => $data ) {
2008-05-30 11:40:08 +00:00
if ( isset ( $this -> hasAndBelongsToMany [ $assoc ])) {
list ( $join ) = $this -> joinModel ( $this -> hasAndBelongsToMany [ $assoc ][ 'with' ]);
2008-10-29 07:19:26 +00:00
2008-05-30 11:40:08 +00:00
$conditions = array ( $join . '.' . $this -> hasAndBelongsToMany [ $assoc ][ 'foreignKey' ] => $id );
2008-10-29 07:19:26 +00:00
$links = $this -> { $join } -> find ( 'all' , array (
'conditions' => $conditions ,
'recursive' => - 1 ,
'fields' => $this -> hasAndBelongsToMany [ $assoc ][ 'associationForeignKey' ]
));
2008-05-30 11:40:08 +00:00
2008-10-23 13:29:32 +00:00
$isUUID = ! empty ( $this -> { $join } -> primaryKey ) && (( $this -> { $join } -> _schema [ $this -> { $join } -> primaryKey ][ 'type' ] === 'string' && $this -> { $join } -> _schema [ $this -> { $join } -> primaryKey ][ 'length' ] === 36 )
|| ( $this -> { $join } -> _schema [ $this -> { $join } -> primaryKey ][ 'type' ] === 'binary' && $this -> { $join } -> _schema [ $this -> { $join } -> primaryKey ][ 'length' ] === 16 ));
2008-10-29 07:19:26 +00:00
$newData = $newValues = array ();
2008-12-30 16:09:25 +00:00
$primaryAdded = false ;
$fields = array (
$db -> name ( $this -> hasAndBelongsToMany [ $assoc ][ 'foreignKey' ]),
$db -> name ( $this -> hasAndBelongsToMany [ $assoc ][ 'associationForeignKey' ])
);
$idField = $db -> name ( $this -> { $join } -> primaryKey );
if ( $isUUID && ! in_array ( $idField , $fields )) {
$fields [] = $idField ;
$primaryAdded = true ;
}
2008-10-29 07:19:26 +00:00
2008-10-30 00:11:32 +00:00
foreach (( array ) $data as $row ) {
2008-11-09 20:55:51 +00:00
if (( is_string ( $row ) && ( strlen ( $row ) == 36 || strlen ( $row ) == 16 )) || is_numeric ( $row )) {
$values = array (
2008-10-29 07:19:26 +00:00
$db -> value ( $id , $this -> getColumnType ( $this -> primaryKey )),
$db -> value ( $row )
);
2008-12-30 16:09:25 +00:00
if ( $isUUID && $primaryAdded ) {
2008-10-29 07:19:26 +00:00
$values [] = $db -> value ( String :: uuid ());
2008-05-30 11:40:08 +00:00
}
2008-10-29 07:19:26 +00:00
$values = join ( ',' , $values );
$newValues [] = " ( { $values } ) " ;
unset ( $values );
2008-11-09 20:55:51 +00:00
} elseif ( isset ( $row [ $this -> hasAndBelongsToMany [ $assoc ][ 'associationForeignKey' ]])) {
2008-10-29 07:19:26 +00:00
$newData [] = $row ;
}
}
2009-01-16 04:09:44 +00:00
if ( $this -> hasAndBelongsToMany [ $assoc ][ 'unique' ]) {
2008-10-29 07:19:26 +00:00
$associationForeignKey = " { $join } . " . $this -> hasAndBelongsToMany [ $assoc ][ 'associationForeignKey' ];
$oldLinks = Set :: extract ( $links , " { n}. { $associationForeignKey } " );
if ( ! empty ( $oldLinks )) {
$conditions [ $associationForeignKey ] = $oldLinks ;
$db -> delete ( $this -> { $join }, $conditions );
2008-05-30 11:40:08 +00:00
}
}
2009-01-16 04:09:44 +00:00
if ( ! empty ( $newData )) {
foreach ( $newData as $data ) {
$data [ $this -> hasAndBelongsToMany [ $assoc ][ 'foreignKey' ]] = $id ;
$this -> { $join } -> create ( $data );
$this -> { $join } -> save ();
}
}
2008-05-30 11:40:08 +00:00
if ( ! empty ( $newValues )) {
2008-10-23 13:29:32 +00:00
$fields = join ( ',' , $fields );
2008-05-30 11:40:08 +00:00
$db -> insertMulti ( $this -> { $join }, $fields , $newValues );
}
}
}
}
/**
* Updates the counter cache of belongsTo associations after a save or delete operation
*
* @ param array $keys Optional foreign key data , defaults to the information $this -> data
* @ param boolean $created True if a new record was created , otherwise only associations with
* 'counterScope' defined get updated
* @ return void
* @ access public
*/
function updateCounterCache ( $keys = array (), $created = false ) {
2008-12-17 04:13:45 +00:00
$keys = empty ( $keys ) ? $this -> data [ $this -> alias ] : $keys ;
$keys [ 'old' ] = isset ( $keys [ 'old' ]) ? $keys [ 'old' ] : array ();
2008-05-30 11:40:08 +00:00
foreach ( $this -> belongsTo as $parent => $assoc ) {
2008-12-17 04:13:45 +00:00
$foreignKey = $assoc [ 'foreignKey' ];
$fkQuoted = $this -> escapeField ( $assoc [ 'foreignKey' ]);
2008-05-30 11:40:08 +00:00
if ( ! empty ( $assoc [ 'counterCache' ])) {
if ( $assoc [ 'counterCache' ] === true ) {
$assoc [ 'counterCache' ] = Inflector :: underscore ( $this -> alias ) . '_count' ;
}
2008-12-17 04:13:45 +00:00
if ( ! $this -> { $parent } -> hasField ( $assoc [ 'counterCache' ])) {
continue ;
2008-05-30 11:40:08 +00:00
}
2008-12-17 04:13:45 +00:00
if ( ! array_key_exists ( $foreignKey , $keys )) {
$keys [ $foreignKey ] = $this -> field ( $foreignKey );
}
$recursive = ( isset ( $assoc [ 'counterScope' ]) ? 1 : - 1 );
$conditions = ( $recursive == 1 ) ? ( array ) $assoc [ 'counterScope' ] : array ();
if ( isset ( $keys [ 'old' ][ $foreignKey ])) {
if ( $keys [ 'old' ][ $foreignKey ] == $keys [ $foreignKey ]) {
continue ;
2008-05-30 11:40:08 +00:00
}
2008-12-17 04:13:45 +00:00
$conditions [ $fkQuoted ] = $keys [ 'old' ][ $foreignKey ];
$count = intval ( $this -> find ( 'count' , compact ( 'conditions' , 'recursive' )));
2008-05-30 11:40:08 +00:00
$this -> { $parent } -> updateAll (
2008-12-17 04:13:45 +00:00
array ( $assoc [ 'counterCache' ] => $count ),
array ( $this -> { $parent } -> escapeField () => $keys [ 'old' ][ $foreignKey ])
2008-05-30 11:40:08 +00:00
);
}
2008-12-17 04:13:45 +00:00
$conditions [ $fkQuoted ] = $keys [ $foreignKey ];
if ( $recursive == 1 ) {
$conditions = array_merge ( $conditions , ( array ) $assoc [ 'counterScope' ]);
}
$count = intval ( $this -> find ( 'count' , compact ( 'conditions' , 'recursive' )));
$this -> { $parent } -> updateAll (
array ( $assoc [ 'counterCache' ] => $count ),
array ( $this -> { $parent } -> escapeField () => $keys [ $foreignKey ])
);
}
}
}
/**
* Helper method for Model :: updateCounterCache () . Checks the fields to be updated for
*
* @ param array $data The fields of the record that will be updated
* @ return array Returns updated foreign key values , along with an 'old' key containing the old
* values , or empty if no foreign keys are updated .
* @ access protected
*/
function _prepareUpdateFields ( $data ) {
$foreignKeys = array ();
foreach ( $this -> belongsTo as $assoc => $info ) {
if ( $info [ 'counterCache' ]) {
$foreignKeys [ $assoc ] = $info [ 'foreignKey' ];
2008-05-30 11:40:08 +00:00
}
}
2008-12-17 04:13:45 +00:00
$included = array_intersect ( $foreignKeys , array_keys ( $data ));
if ( empty ( $included ) || empty ( $this -> id )) {
return array ();
}
$old = $this -> find ( 'first' , array (
'conditions' => array ( 'id' => $this -> id ),
'fields' => array_values ( $included ),
'recursive' => - 1
));
return array_merge ( $data , array ( 'old' => $old [ $this -> alias ]));
2008-05-30 11:40:08 +00:00
}
/**
2008-10-31 19:05:30 +00:00
* Saves multiple individual records for a single model ; Also works with a single record , as well as
* all its associated records .
2008-05-30 11:40:08 +00:00
*
* @ param array $data Record data to save . This can be either a numerically - indexed array ( for saving multiple
* records of the same type ), or an array indexed by association name .
* @ param array $options Options to use when saving record data , which are as follows :
* - validate : Set to false to disable validation , true to validate each record before
* saving , 'first' to validate * all * records before any are saved , or 'only' to only
* validate the records , but not save them .
* - atomic : If true ( default ), will attempt to save all records in a single transaction .
* Should be set to false if database / table does not support transactions .
* If false , we return an array similar to the $data array passed , but values are set to true / false
* depending on whether each record saved successfully .
* - fieldList : Equivalent to the $fieldList parameter in Model :: save ()
* @ return mixed True on success , or false on failure
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 84 / Saving - Related - Model - Data - hasOne - hasMany - belongsTo
* @ link http :// book . cakephp . org / view / 75 / Saving - Your - Data
2008-05-30 11:40:08 +00:00
*/
function saveAll ( $data = null , $options = array ()) {
if ( empty ( $data )) {
$data = $this -> data ;
}
$db =& ConnectionManager :: getDataSource ( $this -> useDbConfig );
$options = array_merge ( array ( 'validate' => true , 'atomic' => true ), $options );
$this -> validationErrors = $validationErrors = array ();
$validates = true ;
$return = array ();
if ( $options [ 'atomic' ] && $options [ 'validate' ] !== 'only' ) {
$db -> begin ( $this );
}
if ( Set :: numeric ( array_keys ( $data ))) {
while ( $validates ) {
2008-05-31 22:01:47 +00:00
foreach ( $data as $key => $record ) {
2008-09-03 16:44:48 +00:00
if ( ! $currentValidates = $this -> __save ( $this , $record , $options )) {
2008-08-26 13:31:07 +00:00
$validationErrors [ $key ] = $this -> validationErrors ;
2008-05-30 11:40:08 +00:00
}
2008-09-19 15:27:43 +00:00
2008-09-03 16:44:48 +00:00
if ( $options [ 'validate' ] === 'only' || $options [ 'validate' ] === 'first' ) {
$validating = true ;
if ( $options [ 'atomic' ]) {
$validates = $validates && $currentValidates ;
} else {
$validates = $currentValidates ;
}
} else {
$validating = false ;
$validates = $currentValidates ;
}
2008-09-19 15:27:43 +00:00
2008-05-30 11:40:08 +00:00
if ( ! $options [ 'atomic' ]) {
$return [] = $validates ;
} elseif ( ! $validates && ! $validating ) {
break ;
}
}
$this -> validationErrors = $validationErrors ;
switch ( true ) {
case ( $options [ 'validate' ] === 'only' ) :
2008-06-27 06:07:00 +00:00
return ( $options [ 'atomic' ] ? $validates : $return );
2008-05-30 11:40:08 +00:00
break ;
case ( $options [ 'validate' ] === 'first' ) :
$options [ 'validate' ] = true ;
continue ;
break ;
default :
if ( $options [ 'atomic' ]) {
if ( $validates && ( $db -> commit ( $this ) !== false )) {
return true ;
}
$db -> rollback ( $this );
return false ;
}
return $return ;
break ;
}
}
return $return ;
}
$associations = $this -> getAssociated ();
while ( $validates ) {
foreach ( $data as $association => $values ) {
if ( isset ( $associations [ $association ])) {
switch ( $associations [ $association ]) {
case 'belongsTo' :
if ( $this -> __save ( $this -> { $association }, $values , $options )) {
$data [ $this -> alias ][ $this -> belongsTo [ $association ][ 'foreignKey' ]] = $this -> { $association } -> id ;
2008-10-29 00:22:52 +00:00
unset ( $data [ $association ]);
2008-05-30 11:40:08 +00:00
} else {
$validationErrors [ $association ] = $this -> { $association } -> validationErrors ;
$validates = false ;
}
if ( ! $options [ 'atomic' ]) {
$return [ $association ][] = $validates ;
}
break ;
}
}
}
2008-10-29 00:22:52 +00:00
if ( ! $this -> __save ( $this , $data , $options )) {
2008-05-30 11:40:08 +00:00
$validationErrors [ $this -> alias ] = $this -> validationErrors ;
$validates = false ;
}
if ( ! $options [ 'atomic' ]) {
2008-06-27 06:07:00 +00:00
$return [ $this -> alias ] = $validates ;
2008-05-30 11:40:08 +00:00
}
$validating = ( $options [ 'validate' ] === 'only' || $options [ 'validate' ] === 'first' );
foreach ( $data as $association => $values ) {
if ( ! $validates && ! $validating ) {
break ;
}
if ( isset ( $associations [ $association ])) {
$type = $associations [ $association ];
switch ( $type ) {
case 'hasOne' :
$values [ $this -> { $type }[ $association ][ 'foreignKey' ]] = $this -> id ;
if ( ! $this -> __save ( $this -> { $association }, $values , $options )) {
$validationErrors [ $association ] = $this -> { $association } -> validationErrors ;
$validates = false ;
}
if ( ! $options [ 'atomic' ]) {
$return [ $association ][] = $validates ;
}
break ;
case 'hasMany' :
foreach ( $values as $i => $value ) {
$values [ $i ][ $this -> { $type }[ $association ][ 'foreignKey' ]] = $this -> id ;
}
$_options = array_merge ( $options , array ( 'atomic' => false ));
if ( $_options [ 'validate' ] === 'first' ) {
$_options [ 'validate' ] = 'only' ;
}
$_return = $this -> { $association } -> saveAll ( $values , $_options );
if ( $_return === false || ( is_array ( $_return ) && in_array ( false , $_return , true ))) {
$validationErrors [ $association ] = $this -> { $association } -> validationErrors ;
$validates = false ;
}
if ( is_array ( $_return )) {
foreach ( $_return as $val ) {
if ( ! isset ( $return [ $association ])) {
$return [ $association ] = array ();
} elseif ( ! is_array ( $return [ $association ])) {
$return [ $association ] = array ( $return [ $association ]);
}
$return [ $association ][] = $val ;
}
} else {
2008-06-20 20:17:23 +00:00
$return [ $association ] = $_return ;
2008-05-30 11:40:08 +00:00
}
break ;
}
}
}
$this -> validationErrors = $validationErrors ;
2008-06-27 06:07:00 +00:00
2008-05-30 11:40:08 +00:00
if ( isset ( $validationErrors [ $this -> alias ])) {
$this -> validationErrors = $validationErrors [ $this -> alias ];
}
switch ( true ) {
case ( $options [ 'validate' ] === 'only' ) :
2008-06-27 06:07:00 +00:00
return ( $options [ 'atomic' ] ? $validates : $return );
2008-05-30 11:40:08 +00:00
break ;
case ( $options [ 'validate' ] === 'first' ) :
$options [ 'validate' ] = true ;
continue ;
break ;
default :
if ( $options [ 'atomic' ]) {
if ( $validates ) {
return ( $db -> commit ( $this ) !== false );
} else {
$db -> rollback ( $this );
}
}
return $return ;
break ;
}
}
}
/**
2008-10-31 19:05:30 +00:00
* Private helper method used by saveAll .
2008-05-30 11:40:08 +00:00
*
2008-09-25 16:49:56 +00:00
* @ return boolean Success
2008-05-30 11:40:08 +00:00
* @ access private
* @ see Model :: saveAll ()
*/
function __save ( & $model , $data , $options ) {
if ( $options [ 'validate' ] === 'first' || $options [ 'validate' ] === 'only' ) {
if ( ! ( $model -> create ( $data ) && $model -> validates ( $options ))) {
return false ;
}
} elseif ( ! ( $model -> create ( null ) !== null && $model -> save ( $data , $options ))) {
return false ;
}
return true ;
}
/**
2008-10-31 19:05:30 +00:00
* Updates multiple model records based on a set of conditions .
2008-05-30 11:40:08 +00:00
*
2008-07-31 15:38:23 +00:00
* @ param array $fields Set of fields and values , indexed by fields .
2008-07-29 01:18:57 +00:00
* Fields are treated as SQL snippets , to insert literal values manually escape your data .
2008-05-30 11:40:08 +00:00
* @ param mixed $conditions Conditions to match , true for all records
* @ return boolean True on success , false on failure
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 75 / Saving - Your - Data
2008-05-30 11:40:08 +00:00
*/
function updateAll ( $fields , $conditions = true ) {
$db =& ConnectionManager :: getDataSource ( $this -> useDbConfig );
return $db -> update ( $this , $fields , null , $conditions );
}
/**
2008-10-31 19:05:30 +00:00
* Alias for del () .
2008-05-30 11:40:08 +00:00
*
* @ param mixed $id ID of record to delete
* @ param boolean $cascade Set to true to delete records that depend on this record
* @ return boolean True on success
* @ access public
* @ see Model :: del ()
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 691 / remove
2008-05-30 11:40:08 +00:00
*/
function remove ( $id = null , $cascade = true ) {
return $this -> del ( $id , $cascade );
}
/**
2008-10-31 19:05:30 +00:00
* Removes record for given ID . If no ID is given , the current ID is used . Returns true on success .
2008-05-30 11:40:08 +00:00
*
* @ param mixed $id ID of record to delete
* @ param boolean $cascade Set to true to delete records that depend on this record
* @ return boolean True on success
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 690 / del
2008-05-30 11:40:08 +00:00
*/
function del ( $id = null , $cascade = true ) {
if ( ! empty ( $id )) {
$this -> id = $id ;
}
$id = $this -> id ;
if ( $this -> exists () && $this -> beforeDelete ( $cascade )) {
$db =& ConnectionManager :: getDataSource ( $this -> useDbConfig );
if ( ! $this -> Behaviors -> trigger ( $this , 'beforeDelete' , array ( $cascade ), array ( 'break' => true , 'breakOn' => false ))) {
return false ;
}
$this -> _deleteDependent ( $id , $cascade );
$this -> _deleteLinks ( $id );
$this -> id = $id ;
if ( ! empty ( $this -> belongsTo )) {
$keys = $this -> find ( 'first' , array ( 'fields' , $this -> __collectForeignKeys ()));
}
if ( $db -> delete ( $this )) {
if ( ! empty ( $this -> belongsTo )) {
$this -> updateCounterCache ( $keys [ $this -> alias ]);
}
$this -> Behaviors -> trigger ( $this , 'afterDelete' );
$this -> afterDelete ();
$this -> _clearCache ();
$this -> id = false ;
$this -> __exists = null ;
return true ;
}
}
return false ;
}
/**
2008-10-31 19:05:30 +00:00
* Alias for del () .
2008-05-30 11:40:08 +00:00
*
* @ param mixed $id ID of record to delete
* @ param boolean $cascade Set to true to delete records that depend on this record
* @ return boolean True on success
* @ access public
* @ see Model :: del ()
*/
function delete ( $id = null , $cascade = true ) {
return $this -> del ( $id , $cascade );
}
/**
2008-10-31 19:05:30 +00:00
* Cascades model deletes through associated hasMany and hasOne child records .
2008-05-30 11:40:08 +00:00
*
* @ param string $id ID of record that was deleted
* @ param boolean $cascade Set to true to delete records that depend on this record
2008-09-25 16:49:56 +00:00
* @ return void
2008-05-30 11:40:08 +00:00
* @ access protected
*/
function _deleteDependent ( $id , $cascade ) {
if ( ! empty ( $this -> __backAssociation )) {
$savedAssociatons = $this -> __backAssociation ;
$this -> __backAssociation = array ();
}
foreach ( array_merge ( $this -> hasMany , $this -> hasOne ) as $assoc => $data ) {
if ( $data [ 'dependent' ] === true && $cascade === true ) {
$model =& $this -> { $assoc };
2008-06-16 03:11:32 +00:00
$conditions = array ( $model -> escapeField ( $data [ 'foreignKey' ]) => $id );
if ( $data [ 'conditions' ]) {
2008-07-31 00:16:16 +00:00
$conditions = array_merge ( $data [ 'conditions' ], $conditions );
2008-06-16 03:11:32 +00:00
}
2008-05-30 11:40:08 +00:00
$model -> recursive = - 1 ;
if ( isset ( $data [ 'exclusive' ]) && $data [ 'exclusive' ]) {
2008-06-16 03:11:32 +00:00
$model -> deleteAll ( $conditions );
2008-05-30 11:40:08 +00:00
} else {
2008-06-16 03:11:32 +00:00
$records = $model -> find ( 'all' , array ( 'conditions' => $conditions , 'fields' => $model -> primaryKey ));
2008-05-30 11:40:08 +00:00
if ( ! empty ( $records )) {
foreach ( $records as $record ) {
$model -> delete ( $record [ $model -> alias ][ $model -> primaryKey ]);
}
}
}
}
}
if ( isset ( $savedAssociatons )) {
$this -> __backAssociation = $savedAssociatons ;
}
}
/**
2008-10-31 19:05:30 +00:00
* Cascades model deletes through HABTM join keys .
2008-05-30 11:40:08 +00:00
*
* @ param string $id ID of record that was deleted
2008-09-25 16:49:56 +00:00
* @ return void
2008-05-30 11:40:08 +00:00
* @ access protected
*/
function _deleteLinks ( $id ) {
$db =& ConnectionManager :: getDataSource ( $this -> useDbConfig );
foreach ( $this -> hasAndBelongsToMany as $assoc => $data ) {
$records = $this -> { $data [ 'with' ]} -> find ( 'all' , array (
2009-01-14 22:01:01 +00:00
'conditions' => array_merge ( array ( $this -> { $data [ 'with' ]} -> escapeField ( $data [ 'foreignKey' ]) => $id )),
2008-05-30 11:40:08 +00:00
'fields' => $this -> { $data [ 'with' ]} -> primaryKey ,
'recursive' => - 1
));
if ( ! empty ( $records )) {
foreach ( $records as $record ) {
$this -> { $data [ 'with' ]} -> delete ( $record [ $this -> { $data [ 'with' ]} -> alias ][ $this -> { $data [ 'with' ]} -> primaryKey ]);
}
}
}
}
/**
2008-10-31 19:05:30 +00:00
* Deletes multiple model records based on a set of conditions .
2008-05-30 11:40:08 +00:00
*
* @ param mixed $conditions Conditions to match
* @ param boolean $cascade Set to true to delete records that depend on this record
* @ param boolean $callbacks Run callbacks ( not being used )
* @ return boolean True on success , false on failure
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 692 / deleteAll
2008-05-30 11:40:08 +00:00
*/
function deleteAll ( $conditions , $cascade = true , $callbacks = false ) {
if ( empty ( $conditions )) {
return false ;
}
$db =& ConnectionManager :: getDataSource ( $this -> useDbConfig );
if ( ! $cascade && ! $callbacks ) {
return $db -> delete ( $this , $conditions );
} else {
$ids = Set :: extract (
$this -> find ( 'all' , array_merge ( array ( 'fields' => " { $this -> alias } . { $this -> primaryKey } " , 'recursive' => 0 ), compact ( 'conditions' ))),
" { n}. { $this -> alias } . { $this -> primaryKey } "
);
if ( empty ( $ids )) {
return false ;
}
if ( $callbacks ) {
$_id = $this -> id ;
2008-10-22 02:37:05 +00:00
$result = true ;
2008-05-30 11:40:08 +00:00
foreach ( $ids as $id ) {
2008-10-22 02:37:05 +00:00
$result = ( $result && $this -> delete ( $id , $cascade ));
2008-05-30 11:40:08 +00:00
}
$this -> id = $_id ;
2008-10-22 02:37:05 +00:00
return $result ;
2008-05-30 11:40:08 +00:00
} else {
foreach ( $ids as $id ) {
$this -> _deleteLinks ( $id );
if ( $cascade ) {
$this -> _deleteDependent ( $id , $cascade );
}
}
return $db -> delete ( $this , array ( $this -> alias . '.' . $this -> primaryKey => $ids ));
}
}
}
/**
2008-10-31 19:05:30 +00:00
* Collects foreign keys from associations .
2008-05-30 11:40:08 +00:00
*
2008-09-25 16:49:56 +00:00
* @ return array
2008-05-30 11:40:08 +00:00
* @ access private
*/
function __collectForeignKeys ( $type = 'belongsTo' ) {
$result = array ();
foreach ( $this -> { $type } as $assoc => $data ) {
if ( isset ( $data [ 'foreignKey' ]) && is_string ( $data [ 'foreignKey' ])) {
$result [ $assoc ] = $data [ 'foreignKey' ];
}
}
return $result ;
}
/**
2008-10-31 19:05:30 +00:00
* Returns true if a record with the currently set ID exists .
2008-05-30 11:40:08 +00:00
*
* @ param boolean $reset if true will force database query
* @ return boolean True if such a record exists
* @ access public
*/
function exists ( $reset = false ) {
2008-06-21 02:33:04 +00:00
if ( is_array ( $reset )) {
extract ( $reset , EXTR_OVERWRITE );
}
2008-05-30 11:40:08 +00:00
if ( $this -> getID () === false || $this -> useTable === false ) {
return false ;
}
if ( $this -> __exists !== null && $reset !== true ) {
return $this -> __exists ;
}
2008-06-20 20:17:23 +00:00
$conditions = array ( $this -> alias . '.' . $this -> primaryKey => $this -> getID ());
2008-06-21 02:33:04 +00:00
$query = array ( 'conditions' => $conditions , 'recursive' => - 1 , 'callbacks' => false );
2008-06-20 20:17:23 +00:00
2008-06-21 02:33:04 +00:00
if ( is_array ( $reset )) {
$query = array_merge ( $query , $reset );
}
return $this -> __exists = ( $this -> find ( 'count' , $query ) > 0 );
2008-05-30 11:40:08 +00:00
}
/**
2008-10-31 19:05:30 +00:00
* Returns true if a record that meets given conditions exists .
2008-05-30 11:40:08 +00:00
*
* @ param array $conditions SQL conditions array
* @ return boolean True if such a record exists
* @ access public
*/
function hasAny ( $conditions = null ) {
return ( $this -> find ( 'count' , array ( 'conditions' => $conditions , 'recursive' => - 1 )) != false );
}
/**
2008-10-31 19:05:30 +00:00
* Returns a result set array .
2008-05-30 11:40:08 +00:00
*
* Also used to perform new - notation finds , where the first argument is type of find operation to perform
2008-10-03 21:23:13 +00:00
* ( all / first / count / neighbors / list / threaded ),
2008-10-03 18:06:15 +00:00
* second parameter options for finding ( indexed array , including : 'conditions' , 'limit' ,
2008-05-30 11:40:08 +00:00
* 'recursive' , 'page' , 'fields' , 'offset' , 'order' )
*
* Eg : find ( 'all' , array (
* 'conditions' => array ( 'name' => 'Thomas Anderson' ),
* 'fields' => array ( 'name' , 'email' ),
* 'order' => 'field3 DESC' ,
* 'recursive' => 2 ,
* 'group' => 'type' ));
*
* Specifying 'fields' for new - notation 'list' :
* - If no fields are specified , then 'id' is used for key and 'model->displayField' is used for value .
* - If a single field is specified , 'id' is used for key and specified field is used for value .
* - If three fields are specified , they are used ( in order ) for key , value and group .
* - Otherwise , first and second fields are used for key and value .
*
2008-10-03 21:23:13 +00:00
* @ param array $conditions SQL conditions array , or type of find operation ( all / first / count / neighbors / list / threaded )
2008-05-30 11:40:08 +00:00
* @ param mixed $fields Either a single string of a field name , or an array of field names , or options for matching
* @ param string $order SQL ORDER BY conditions ( e . g . " price DESC " or " name ASC " )
* @ param integer $recursive The number of levels deep to fetch associated records
* @ return array Array of records
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 449 / find
2008-05-30 11:40:08 +00:00
*/
function find ( $conditions = null , $fields = array (), $order = null , $recursive = null ) {
2008-09-21 04:09:16 +00:00
if ( ! is_string ( $conditions ) || ( is_string ( $conditions ) && ! array_key_exists ( $conditions , $this -> _findMethods ))) {
2008-05-30 11:40:08 +00:00
$type = 'first' ;
$query = array_merge ( compact ( 'conditions' , 'fields' , 'order' , 'recursive' ), array ( 'limit' => 1 ));
} else {
list ( $type , $query ) = array ( $conditions , $fields );
}
$db =& ConnectionManager :: getDataSource ( $this -> useDbConfig );
$this -> findQueryType = $type ;
$this -> id = $this -> getID ();
$query = array_merge (
array (
2008-06-21 02:33:04 +00:00
'conditions' => null , 'fields' => null , 'joins' => array (), 'limit' => null ,
'offset' => null , 'order' => null , 'page' => null , 'group' => null , 'callbacks' => true
2008-05-30 11:40:08 +00:00
),
2008-06-19 17:06:50 +00:00
( array ) $query
2008-05-30 11:40:08 +00:00
);
if ( $type != 'all' ) {
2008-09-21 04:09:16 +00:00
if ( $this -> _findMethods [ $type ] === true ) {
2008-05-30 11:40:08 +00:00
$query = $this -> { '_find' . ucfirst ( $type )}( 'before' , $query );
}
}
if ( ! is_numeric ( $query [ 'page' ]) || intval ( $query [ 'page' ]) < 1 ) {
$query [ 'page' ] = 1 ;
}
if ( $query [ 'page' ] > 1 && ! empty ( $query [ 'limit' ])) {
$query [ 'offset' ] = ( $query [ 'page' ] - 1 ) * $query [ 'limit' ];
}
if ( $query [ 'order' ] === null && $this -> order !== null ) {
$query [ 'order' ] = $this -> order ;
}
$query [ 'order' ] = array ( $query [ 'order' ]);
2008-06-21 02:33:04 +00:00
if ( $query [ 'callbacks' ] === true || $query [ 'callbacks' ] === 'before' ) {
2008-09-21 04:09:16 +00:00
$return = $this -> Behaviors -> trigger ( $this , 'beforeFind' , array ( $query ), array (
'break' => true , 'breakOn' => false , 'modParams' => true
));
2008-07-30 16:26:48 +00:00
$query = ( is_array ( $return )) ? $return : $query ;
2008-05-30 11:40:08 +00:00
2008-06-21 02:33:04 +00:00
if ( $return === false ) {
return null ;
}
2008-05-30 11:40:08 +00:00
2008-06-21 02:33:04 +00:00
$return = $this -> beforeFind ( $query );
2008-07-30 16:26:48 +00:00
$query = ( is_array ( $return )) ? $return : $query ;
2008-05-30 11:40:08 +00:00
2008-06-21 02:33:04 +00:00
if ( $return === false ) {
return null ;
}
2008-05-30 11:40:08 +00:00
}
$results = $db -> read ( $this , $query );
$this -> resetAssociations ();
$this -> findQueryType = null ;
2008-09-04 01:00:08 +00:00
if ( $query [ 'callbacks' ] === true || $query [ 'callbacks' ] === 'after' ) {
$results = $this -> __filterResults ( $results );
}
2008-05-30 11:40:08 +00:00
if ( $type === 'all' ) {
2008-06-21 02:33:04 +00:00
return $results ;
2008-05-30 11:40:08 +00:00
} else {
2008-09-21 04:09:16 +00:00
if ( $this -> _findMethods [ $type ] === true ) {
2008-05-30 11:40:08 +00:00
return $this -> { '_find' . ucfirst ( $type )}( 'after' , $query , $results );
}
}
}
/**
* Handles the before / after filter logic for find ( 'first' ) operations . Only called by Model :: find () .
*
* @ param string $state Either " before " or " after "
* @ param array $query
* @ param array $data
* @ return array
* @ access protected
2008-10-31 19:05:30 +00:00
* @ see Model :: find ()
2008-05-30 11:40:08 +00:00
*/
function _findFirst ( $state , $query , $results = array ()) {
if ( $state == 'before' ) {
$query [ 'limit' ] = 1 ;
if ( empty ( $query [ 'conditions' ]) && ! empty ( $this -> id )) {
$query [ 'conditions' ] = array ( $this -> escapeField () => $this -> id );
}
return $query ;
} elseif ( $state == 'after' ) {
if ( empty ( $results [ 0 ])) {
return false ;
}
return $results [ 0 ];
}
}
/**
* Handles the before / after filter logic for find ( 'count' ) operations . Only called by Model :: find () .
*
* @ param string $state Either " before " or " after "
* @ param array $query
* @ param array $data
* @ return int The number of records found , or false
* @ access protected
2008-10-31 19:05:30 +00:00
* @ see Model :: find ()
2008-05-30 11:40:08 +00:00
*/
function _findCount ( $state , $query , $results = array ()) {
if ( $state == 'before' ) {
2008-10-01 15:27:29 +00:00
$db =& ConnectionManager :: getDataSource ( $this -> useDbConfig );
2008-05-30 11:40:08 +00:00
if ( empty ( $query [ 'fields' ])) {
$query [ 'fields' ] = $db -> calculate ( $this , 'count' );
2008-08-14 16:52:29 +00:00
} elseif ( is_string ( $query [ 'fields' ]) && ! preg_match ( '/count/i' , $query [ 'fields' ])) {
2008-10-01 15:27:29 +00:00
$query [ 'fields' ] = $db -> calculate ( $this , 'count' , array (
$db -> expression ( $query [ 'fields' ]), 'count'
));
2008-05-30 11:40:08 +00:00
}
$query [ 'order' ] = false ;
return $query ;
} elseif ( $state == 'after' ) {
if ( isset ( $results [ 0 ][ 0 ][ 'count' ])) {
return intval ( $results [ 0 ][ 0 ][ 'count' ]);
} elseif ( isset ( $results [ 0 ][ $this -> alias ][ 'count' ])) {
return intval ( $results [ 0 ][ $this -> alias ][ 'count' ]);
}
return false ;
}
}
/**
* Handles the before / after filter logic for find ( 'list' ) operations . Only called by Model :: find () .
*
* @ param string $state Either " before " or " after "
* @ param array $query
* @ param array $data
* @ return array Key / value pairs of primary keys / display field values of all records found
* @ access protected
2008-10-31 19:05:30 +00:00
* @ see Model :: find ()
2008-05-30 11:40:08 +00:00
*/
function _findList ( $state , $query , $results = array ()) {
if ( $state == 'before' ) {
if ( empty ( $query [ 'fields' ])) {
$query [ 'fields' ] = array ( " { $this -> alias } . { $this -> primaryKey } " , " { $this -> alias } . { $this -> displayField } " );
$list = array ( " { n}. { $this -> alias } . { $this -> primaryKey } " , " { n}. { $this -> alias } . { $this -> displayField } " , null );
} else {
if ( ! is_array ( $query [ 'fields' ])) {
$query [ 'fields' ] = String :: tokenize ( $query [ 'fields' ]);
}
2008-06-10 17:27:12 +00:00
2008-05-30 11:40:08 +00:00
if ( count ( $query [ 'fields' ]) == 1 ) {
2008-06-10 17:27:12 +00:00
if ( strpos ( $query [ 'fields' ][ 0 ], '.' ) === false ) {
$query [ 'fields' ][ 0 ] = $this -> alias . '.' . $query [ 'fields' ][ 0 ];
}
2008-05-30 11:40:08 +00:00
$list = array ( " { n}. { $this -> alias } . { $this -> primaryKey } " , '{n}.' . $query [ 'fields' ][ 0 ], null );
$query [ 'fields' ] = array ( " { $this -> alias } . { $this -> primaryKey } " , $query [ 'fields' ][ 0 ]);
} elseif ( count ( $query [ 'fields' ]) == 3 ) {
2008-06-11 08:54:27 +00:00
for ( $i = 0 ; $i < 3 ; $i ++ ) {
2008-06-10 17:27:12 +00:00
if ( strpos ( $query [ 'fields' ][ $i ], '.' ) === false ) {
$query [ 'fields' ][ $i ] = $this -> alias . '.' . $query [ 'fields' ][ $i ];
}
}
2008-05-30 11:40:08 +00:00
$list = array ( '{n}.' . $query [ 'fields' ][ 0 ], '{n}.' . $query [ 'fields' ][ 1 ], '{n}.' . $query [ 'fields' ][ 2 ]);
} else {
2008-06-11 08:54:27 +00:00
for ( $i = 0 ; $i < 2 ; $i ++ ) {
2008-06-10 17:27:12 +00:00
if ( strpos ( $query [ 'fields' ][ $i ], '.' ) === false ) {
$query [ 'fields' ][ $i ] = $this -> alias . '.' . $query [ 'fields' ][ $i ];
}
}
2008-05-30 11:40:08 +00:00
$list = array ( '{n}.' . $query [ 'fields' ][ 0 ], '{n}.' . $query [ 'fields' ][ 1 ], null );
}
}
if ( ! isset ( $query [ 'recursive' ]) || $query [ 'recursive' ] === null ) {
$query [ 'recursive' ] = - 1 ;
}
list ( $query [ 'list' ][ 'keyPath' ], $query [ 'list' ][ 'valuePath' ], $query [ 'list' ][ 'groupPath' ]) = $list ;
return $query ;
} elseif ( $state == 'after' ) {
if ( empty ( $results )) {
return array ();
}
2008-09-04 01:00:08 +00:00
$lst = $query [ 'list' ];
return Set :: combine ( $results , $lst [ 'keyPath' ], $lst [ 'valuePath' ], $lst [ 'groupPath' ]);
2008-05-30 11:40:08 +00:00
}
}
2008-06-26 19:33:44 +00:00
/**
2008-10-31 19:05:30 +00:00
* Detects the previous field 's value, then uses logic to find the ' wrapping '
* rows and return them .
2008-06-26 19:42:07 +00:00
*
2008-06-26 19:33:44 +00:00
* @ param string $state Either " before " or " after "
2008-06-26 19:42:07 +00:00
* @ param mixed $query
* @ param array $results
2008-09-25 16:49:56 +00:00
* @ return array
2008-06-26 19:33:44 +00:00
* @ access protected
*/
function _findNeighbors ( $state , $query , $results = array ()) {
if ( $state == 'before' ) {
$query = array_merge ( array ( 'recursive' => 0 ), $query );
extract ( $query );
$conditions = ( array ) $conditions ;
if ( isset ( $field ) && isset ( $value )) {
if ( strpos ( $field , '.' ) === false ) {
2008-06-26 19:42:07 +00:00
$field = $this -> alias . '.' . $field ;
}
2008-06-26 19:33:44 +00:00
} else {
$field = $this -> alias . '.' . $this -> primaryKey ;
$value = $this -> id ;
}
$query [ 'conditions' ] = array_merge ( $conditions , array ( $field . ' <' => $value ));
$query [ 'order' ] = $field . ' DESC' ;
$query [ 'limit' ] = 1 ;
$query [ 'field' ] = $field ;
$query [ 'value' ] = $value ;
2008-06-26 19:42:07 +00:00
return $query ;
2008-06-26 19:33:44 +00:00
} elseif ( $state == 'after' ) {
extract ( $query );
unset ( $query [ 'conditions' ][ $field . ' <' ]);
2008-06-26 19:42:07 +00:00
$return = array ();
if ( isset ( $results [ 0 ])) {
2008-06-26 19:33:44 +00:00
$prevVal = Set :: extract ( '/' . str_replace ( '.' , '/' , $field ), $results [ 0 ]);
$query [ 'conditions' ][ $field . ' >=' ] = $prevVal [ 0 ];
$query [ 'conditions' ][ $field . ' !=' ] = $value ;
$query [ 'limit' ] = 2 ;
} else {
$return [ 'prev' ] = null ;
$query [ 'conditions' ][ $field . ' >' ] = $value ;
$query [ 'limit' ] = 1 ;
2008-06-26 19:42:07 +00:00
}
2008-06-26 19:33:44 +00:00
$query [ 'order' ] = $field . ' ASC' ;
$return2 = $this -> find ( 'all' , $query );
if ( ! array_key_exists ( 'prev' , $return )) {
2008-06-26 19:42:07 +00:00
$return [ 'prev' ] = $return2 [ 0 ];
2008-06-26 19:33:44 +00:00
}
if ( count ( $return2 ) == 2 ) {
2008-06-26 19:42:07 +00:00
$return [ 'next' ] = $return2 [ 1 ];
} elseif ( count ( $return2 ) == 1 && ! $return [ 'prev' ]) {
$return [ 'next' ] = $return2 [ 0 ];
2008-06-26 19:33:44 +00:00
} else {
$return [ 'next' ] = null ;
}
return $return ;
}
}
/**
2008-08-01 16:49:56 +00:00
* In the event of ambiguous results returned ( multiple top level results , with different parent_ids )
* top level results with different parent_ids to the first result will be dropped
*
2008-06-26 19:42:07 +00:00
* @ param mixed $state
* @ param mixed $query
* @ param array $results
2008-06-26 19:33:44 +00:00
* @ return array Threaded results
* @ access protected
*/
function _findThreaded ( $state , $query , $results = array ()) {
if ( $state == 'before' ) {
return $query ;
} elseif ( $state == 'after' ) {
$return = $idMap = array ();
2008-07-05 14:10:42 +00:00
$ids = Set :: extract ( $results , '{n}.' . $this -> alias . '.' . $this -> primaryKey );
2008-06-26 19:33:44 +00:00
foreach ( $results as $result ) {
$result [ 'children' ] = array ();
2008-07-05 12:37:18 +00:00
$id = $result [ $this -> alias ][ $this -> primaryKey ];
2008-06-26 19:33:44 +00:00
$parentId = $result [ $this -> alias ][ 'parent_id' ];
if ( isset ( $idMap [ $id ][ 'children' ])) {
2008-07-05 12:37:18 +00:00
$idMap [ $id ] = array_merge ( $result , ( array ) $idMap [ $id ]);
2008-06-26 19:33:44 +00:00
} else {
2008-07-05 12:37:18 +00:00
$idMap [ $id ] = array_merge ( $result , array ( 'children' => array ()));
2008-06-26 19:33:44 +00:00
}
2008-07-05 14:10:42 +00:00
if ( ! $parentId || ! in_array ( $parentId , $ids )) {
2008-06-26 19:33:44 +00:00
$return [] =& $idMap [ $id ];
2008-07-05 14:10:42 +00:00
} else {
$idMap [ $parentId ][ 'children' ][] =& $idMap [ $id ];
2008-06-26 19:33:44 +00:00
}
}
2008-08-01 16:49:56 +00:00
if ( count ( $return ) > 1 ) {
$ids = array_unique ( Set :: extract ( '/' . $this -> alias . '/parent_id' , $return ));
if ( count ( $ids ) > 1 ) {
$root = $return [ 0 ][ $this -> alias ][ 'parent_id' ];
foreach ( $return as $key => $value ) {
if ( $value [ $this -> alias ][ 'parent_id' ] != $root ) {
2008-08-07 15:36:26 +00:00
unset ( $return [ $key ]);
2008-08-01 16:49:56 +00:00
}
2008-08-07 15:36:26 +00:00
}
2008-08-01 16:49:56 +00:00
}
}
2008-06-26 19:33:44 +00:00
return $return ;
}
2008-06-26 19:42:07 +00:00
}
2008-05-30 11:40:08 +00:00
/**
2008-10-31 19:05:30 +00:00
* Passes query results through model and behavior afterFilter () methods .
2008-05-30 11:40:08 +00:00
*
* @ param array Results to filter
* @ param boolean $primary If this is the primary model results ( results from model where the find operation was performed )
* @ return array Set of filtered results
* @ access private
*/
function __filterResults ( $results , $primary = true ) {
$return = $this -> Behaviors -> trigger ( $this , 'afterFind' , array ( $results , $primary ), array ( 'modParams' => true ));
if ( $return !== true ) {
$results = $return ;
}
return $this -> afterFind ( $results , $primary );
}
/**
2008-10-31 19:05:30 +00:00
* Called only when bindTo < ModelName > () is used .
2008-05-30 11:40:08 +00:00
* This resets the association arrays for the model back
2008-10-31 19:05:30 +00:00
* to those originally defined in the model .
2008-05-30 11:40:08 +00:00
*
* @ return boolean Success
* @ access public
*/
function resetAssociations () {
if ( ! empty ( $this -> __backAssociation )) {
foreach ( $this -> __associations as $type ) {
if ( isset ( $this -> __backAssociation [ $type ])) {
$this -> { $type } = $this -> __backAssociation [ $type ];
}
}
$this -> __backAssociation = array ();
}
foreach ( $this -> __associations as $type ) {
foreach ( $this -> { $type } as $key => $name ) {
if ( ! empty ( $this -> { $key } -> __backAssociation )) {
$this -> { $key } -> resetAssociations ();
}
}
}
$this -> __backAssociation = array ();
return true ;
}
/**
2008-10-31 19:05:30 +00:00
* Returns false if any fields passed match any ( by default , all if $or = false ) of their matching values .
2008-05-30 11:40:08 +00:00
*
* @ param array $fields Field / value pairs to search ( if no values specified , they are pulled from $this -> data )
* @ param boolean $or If false , all fields specified must match in order for a false return value
* @ return boolean False if any records matching any fields are found
* @ access public
*/
function isUnique ( $fields , $or = true ) {
if ( ! is_array ( $fields )) {
$fields = func_get_args ();
if ( is_bool ( $fields [ count ( $fields ) - 1 ])) {
$or = $fields [ count ( $fields ) - 1 ];
unset ( $fields [ count ( $fields ) - 1 ]);
}
}
foreach ( $fields as $field => $value ) {
if ( is_numeric ( $field )) {
unset ( $fields [ $field ]);
$field = $value ;
if ( isset ( $this -> data [ $this -> alias ][ $field ])) {
$value = $this -> data [ $this -> alias ][ $field ];
} else {
$value = null ;
}
}
if ( strpos ( $field , '.' ) === false ) {
unset ( $fields [ $field ]);
$fields [ $this -> alias . '.' . $field ] = $value ;
}
}
if ( $or ) {
$fields = array ( 'or' => $fields );
}
if ( ! empty ( $this -> id )) {
2008-05-31 12:36:38 +00:00
$fields [ $this -> alias . '.' . $this -> primaryKey . ' !=' ] = $this -> id ;
2008-05-30 11:40:08 +00:00
}
2008-09-26 00:46:53 +00:00
return ( $this -> find ( 'count' , array ( 'conditions' => $fields , 'recursive' => - 1 )) == 0 );
2008-05-30 11:40:08 +00:00
}
/**
2008-10-31 19:05:30 +00:00
* Returns a resultset for a given SQL statement . Custom SQL queries should be performed with this method .
2008-05-30 11:40:08 +00:00
*
* @ param string $sql SQL statement
* @ return array Resultset
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 456 / query
2008-05-30 11:40:08 +00:00
*/
function query () {
$params = func_get_args ();
$db =& ConnectionManager :: getDataSource ( $this -> useDbConfig );
return call_user_func_array ( array ( & $db , 'query' ), $params );
}
/**
2008-10-31 19:05:30 +00:00
* Returns true if all fields pass validation .
2008-05-30 11:40:08 +00:00
*
* @ param string $options An optional array of custom options to be made available in the beforeValidate callback
* @ return boolean True if there are no errors
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 410 / Validating - Data - from - the - Controller
2008-05-30 11:40:08 +00:00
*/
function validates ( $options = array ()) {
$errors = $this -> invalidFields ( $options );
if ( is_array ( $errors )) {
return count ( $errors ) === 0 ;
}
return $errors ;
}
/**
2008-10-31 19:05:30 +00:00
* Returns an array of fields that have failed validation .
2008-05-30 11:40:08 +00:00
*
* @ param string $options An optional array of custom options to be made available in the beforeValidate callback
* @ return array Array of invalid fields
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 410 / Validating - Data - from - the - Controller
2008-05-30 11:40:08 +00:00
*/
function invalidFields ( $options = array ()) {
2008-09-04 01:00:08 +00:00
if (
! $this -> Behaviors -> trigger (
$this ,
'beforeValidate' ,
array ( $options ),
array ( 'break' => true , 'breakOn' => false )
) ||
$this -> beforeValidate ( $options ) === false
) {
2008-05-30 11:40:08 +00:00
return $this -> validationErrors ;
}
if ( ! isset ( $this -> validate ) || empty ( $this -> validate )) {
return $this -> validationErrors ;
}
2008-09-04 01:00:08 +00:00
2008-05-30 11:40:08 +00:00
$data = $this -> data ;
$methods = array_map ( 'strtolower' , get_class_methods ( $this ));
$behaviorMethods = array_keys ( $this -> Behaviors -> methods ());
if ( isset ( $data [ $this -> alias ])) {
$data = $data [ $this -> alias ];
} elseif ( ! is_array ( $data )) {
$data = array ();
}
$Validation =& Validation :: getInstance ();
2008-06-15 02:58:23 +00:00
$this -> exists ();
2008-05-30 11:40:08 +00:00
2008-08-27 08:01:00 +00:00
$_validate = $this -> validate ;
if ( array_key_exists ( 'fieldList' , $options ) && is_array ( $options [ 'fieldList' ]) && ! empty ( $options [ 'fieldList' ])) {
2008-08-27 16:43:15 +00:00
$validate = array ();
2008-08-27 08:01:00 +00:00
foreach ( $options [ 'fieldList' ] as $f ) {
if ( ! empty ( $this -> validate [ $f ])) {
$validate [ $f ] = $this -> validate [ $f ];
}
}
$this -> validate = $validate ;
}
2008-08-27 16:43:15 +00:00
2008-05-30 11:40:08 +00:00
foreach ( $this -> validate as $fieldName => $ruleSet ) {
if ( ! is_array ( $ruleSet ) || ( is_array ( $ruleSet ) && isset ( $ruleSet [ 'rule' ]))) {
$ruleSet = array ( $ruleSet );
}
2008-09-04 01:00:08 +00:00
$default = array (
'allowEmpty' => null ,
'required' => null ,
'rule' => 'blank' ,
'last' => false ,
'on' => null
);
2008-05-30 11:40:08 +00:00
foreach ( $ruleSet as $index => $validator ) {
if ( ! is_array ( $validator )) {
$validator = array ( 'rule' => $validator );
}
$validator = array_merge ( $default , $validator );
if ( isset ( $validator [ 'message' ])) {
$message = $validator [ 'message' ];
} else {
$message = __ ( 'This field cannot be left blank' , true );
}
2008-09-04 01:00:08 +00:00
if (
empty ( $validator [ 'on' ]) || ( $validator [ 'on' ] == 'create' &&
! $this -> __exists ) || ( $validator [ 'on' ] == 'update' && $this -> __exists
)) {
$required = (
( ! isset ( $data [ $fieldName ]) && $validator [ 'required' ] === true ) ||
(
isset ( $data [ $fieldName ]) && ( empty ( $data [ $fieldName ]) &&
! is_numeric ( $data [ $fieldName ])) && $validator [ 'allowEmpty' ] === false
)
);
2008-09-19 15:27:43 +00:00
2008-09-04 01:00:08 +00:00
if ( $required ) {
2008-05-30 11:40:08 +00:00
$this -> invalidate ( $fieldName , $message );
if ( $validator [ 'last' ]) {
break ;
}
} elseif ( array_key_exists ( $fieldName , $data )) {
if ( empty ( $data [ $fieldName ]) && $data [ $fieldName ] != '0' && $validator [ 'allowEmpty' ] === true ) {
break ;
}
if ( is_array ( $validator [ 'rule' ])) {
$rule = $validator [ 'rule' ][ 0 ];
unset ( $validator [ 'rule' ][ 0 ]);
$ruleParams = array_merge ( array ( $data [ $fieldName ]), array_values ( $validator [ 'rule' ]));
} else {
$rule = $validator [ 'rule' ];
$ruleParams = array ( $data [ $fieldName ]);
}
$valid = true ;
if ( in_array ( strtolower ( $rule ), $methods )) {
2008-08-01 06:28:59 +00:00
$ruleParams [] = $validator ;
2008-05-30 11:40:08 +00:00
$ruleParams [ 0 ] = array ( $fieldName => $ruleParams [ 0 ]);
$valid = $this -> dispatchMethod ( $rule , $ruleParams );
} elseif ( in_array ( $rule , $behaviorMethods ) || in_array ( strtolower ( $rule ), $behaviorMethods )) {
2008-09-04 01:00:08 +00:00
$ruleParams [] = $validator ;
2008-05-30 11:40:08 +00:00
$ruleParams [ 0 ] = array ( $fieldName => $ruleParams [ 0 ]);
$valid = $this -> Behaviors -> dispatchMethod ( $this , $rule , $ruleParams );
} elseif ( method_exists ( $Validation , $rule )) {
$valid = $Validation -> dispatchMethod ( $rule , $ruleParams );
} elseif ( ! is_array ( $validator [ 'rule' ])) {
$valid = preg_match ( $rule , $data [ $fieldName ]);
}
2008-08-01 06:28:59 +00:00
if ( ! $valid || ( is_string ( $valid ) && strlen ( $valid ) > 0 )) {
if ( is_string ( $valid ) && strlen ( $valid ) > 0 ) {
$validator [ 'message' ] = $valid ;
} elseif ( ! isset ( $validator [ 'message' ])) {
2008-05-30 11:40:08 +00:00
if ( is_string ( $index )) {
$validator [ 'message' ] = $index ;
2008-07-30 16:26:48 +00:00
} elseif ( is_numeric ( $index ) && count ( $ruleSet ) > 1 ) {
$validator [ 'message' ] = $index + 1 ;
2008-05-30 11:40:08 +00:00
} else {
2008-07-30 16:26:48 +00:00
$validator [ 'message' ] = $message ;
2008-05-30 11:40:08 +00:00
}
}
$this -> invalidate ( $fieldName , $validator [ 'message' ]);
if ( $validator [ 'last' ]) {
break ;
}
}
}
}
}
}
2008-08-27 08:01:00 +00:00
$this -> validate = $_validate ;
2008-05-30 11:40:08 +00:00
return $this -> validationErrors ;
}
/**
2008-10-31 19:05:30 +00:00
* Marks a field as invalid , optionally setting the name of validation
* rule ( in case of multiple validation for field ) that was broken .
2008-05-30 11:40:08 +00:00
*
* @ param string $field The name of the field to invalidate
2008-09-26 15:27:36 +00:00
* @ param mixed $value Name of validation rule that was not failed . If no validation key
2008-09-26 15:14:31 +00:00
* is provided , defaults to true .
2008-05-30 11:40:08 +00:00
* @ access public
*/
function invalidate ( $field , $value = true ) {
if ( ! is_array ( $this -> validationErrors )) {
$this -> validationErrors = array ();
}
$this -> validationErrors [ $field ] = $value ;
}
/**
2008-10-31 19:05:30 +00:00
* Returns true if given field name is a foreign key in this model .
2008-05-30 11:40:08 +00:00
*
* @ param string $field Returns true if the input string ends in " _id "
* @ return boolean True if the field is a foreign key listed in the belongsTo array .
* @ access public
*/
function isForeignKey ( $field ) {
$foreignKeys = array ();
if ( ! empty ( $this -> belongsTo )) {
foreach ( $this -> belongsTo as $assoc => $data ) {
$foreignKeys [] = $data [ 'foreignKey' ];
}
}
return in_array ( $field , $foreignKeys );
}
/**
2008-10-31 19:05:30 +00:00
* Returns the display field for this model .
2008-05-30 11:40:08 +00:00
*
* @ return string The name of the display field for this Model ( i . e . 'name' , 'title' ) .
* @ access public
2008-12-17 04:13:45 +00:00
* @ deprecated
2008-05-30 11:40:08 +00:00
*/
function getDisplayField () {
return $this -> displayField ;
}
/**
2008-10-31 19:05:30 +00:00
* Escapes the field name and prepends the model name . Escaping is done according to the current database driver ' s rules .
2008-05-30 11:40:08 +00:00
*
* @ param string $field Field to escape ( e . g : id )
* @ param string $alias Alias for the model ( e . g : Post )
* @ return string The name of the escaped field for this Model ( i . e . id becomes `Post` . `id` ) .
* @ access public
*/
function escapeField ( $field = null , $alias = null ) {
if ( empty ( $alias )) {
$alias = $this -> alias ;
}
if ( empty ( $field )) {
$field = $this -> primaryKey ;
}
$db =& ConnectionManager :: getDataSource ( $this -> useDbConfig );
if ( strpos ( $field , $db -> name ( $alias )) === 0 ) {
return $field ;
}
return $db -> name ( $alias . '.' . $field );
}
/**
* Returns the current record ' s ID
*
* @ param integer $list Index on which the composed ID is located
* @ return mixed The ID of the current record , false if no ID
* @ access public
*/
function getID ( $list = 0 ) {
if ( empty ( $this -> id ) || ( is_array ( $this -> id ) && isset ( $this -> id [ 0 ]) && empty ( $this -> id [ 0 ]))) {
return false ;
}
if ( ! is_array ( $this -> id )) {
return $this -> id ;
}
if ( empty ( $this -> id )) {
return false ;
}
if ( isset ( $this -> id [ $list ]) && ! empty ( $this -> id [ $list ])) {
return $this -> id [ $list ];
} elseif ( isset ( $this -> id [ $list ])) {
return false ;
}
foreach ( $this -> id as $id ) {
return $id ;
}
return false ;
}
/**
2008-10-31 19:05:30 +00:00
* Returns the ID of the last record this model inserted .
2008-05-30 11:40:08 +00:00
*
* @ return mixed Last inserted ID
* @ access public
*/
function getLastInsertID () {
return $this -> getInsertID ();
}
/**
2008-10-31 19:05:30 +00:00
* Returns the ID of the last record this model inserted .
2008-05-30 11:40:08 +00:00
*
* @ return mixed Last inserted ID
* @ access public
*/
function getInsertID () {
return $this -> __insertID ;
}
/**
2008-10-31 19:05:30 +00:00
* Sets the ID of the last record this model inserted
2008-05-30 11:40:08 +00:00
*
* @ param mixed Last inserted ID
* @ access public
*/
function setInsertID ( $id ) {
$this -> __insertID = $id ;
}
/**
2008-10-31 19:05:30 +00:00
* Returns the number of rows returned from the last query .
2008-05-30 11:40:08 +00:00
*
* @ return int Number of rows
* @ access public
*/
function getNumRows () {
$db =& ConnectionManager :: getDataSource ( $this -> useDbConfig );
return $db -> lastNumRows ();
}
/**
2008-10-31 19:05:30 +00:00
* Returns the number of rows affected by the last query .
2008-05-30 11:40:08 +00:00
*
* @ return int Number of rows
* @ access public
*/
function getAffectedRows () {
$db =& ConnectionManager :: getDataSource ( $this -> useDbConfig );
return $db -> lastAffected ();
}
/**
2008-10-31 19:05:30 +00:00
* Sets the DataSource to which this model is bound .
2008-05-30 11:40:08 +00:00
*
2008-06-18 17:46:56 +00:00
* @ param string $dataSource The name of the DataSource , as defined in app / config / database . php
2008-05-30 11:40:08 +00:00
* @ return boolean True on success
* @ access public
*/
function setDataSource ( $dataSource = null ) {
$oldConfig = $this -> useDbConfig ;
if ( $dataSource != null ) {
$this -> useDbConfig = $dataSource ;
}
$db =& ConnectionManager :: getDataSource ( $this -> useDbConfig );
if ( ! empty ( $oldConfig ) && isset ( $db -> config [ 'prefix' ])) {
$oldDb =& ConnectionManager :: getDataSource ( $oldConfig );
2008-08-19 01:18:33 +00:00
if ( ! isset ( $this -> tablePrefix ) || ( ! isset ( $oldDb -> config [ 'prefix' ]) || $this -> tablePrefix == $oldDb -> config [ 'prefix' ])) {
2008-05-30 11:40:08 +00:00
$this -> tablePrefix = $db -> config [ 'prefix' ];
}
} elseif ( isset ( $db -> config [ 'prefix' ])) {
$this -> tablePrefix = $db -> config [ 'prefix' ];
}
if ( empty ( $db ) || $db == null || ! is_object ( $db )) {
return $this -> cakeError ( 'missingConnection' , array ( array ( 'className' => $this -> alias )));
}
}
/**
* Gets the DataSource to which this model is bound .
* Not safe for use with some versions of PHP4 , because this class is overloaded .
*
* @ return object A DataSource object
* @ access public
*/
function & getDataSource () {
$db =& ConnectionManager :: getDataSource ( $this -> useDbConfig );
return $db ;
}
/**
2008-10-31 19:05:30 +00:00
* Gets all the models with which this model is associated .
2008-05-30 11:40:08 +00:00
*
* @ param string $type Only result associations of this type
* @ return array Associations
* @ access public
*/
function getAssociated ( $type = null ) {
if ( $type == null ) {
$associated = array ();
foreach ( $this -> __associations as $assoc ) {
if ( ! empty ( $this -> { $assoc })) {
$models = array_keys ( $this -> { $assoc });
foreach ( $models as $m ) {
$associated [ $m ] = $assoc ;
}
}
}
return $associated ;
} elseif ( in_array ( $type , $this -> __associations )) {
if ( empty ( $this -> { $type })) {
return array ();
}
return array_keys ( $this -> { $type });
} else {
$assoc = array_merge ( $this -> hasOne , $this -> hasMany , $this -> belongsTo , $this -> hasAndBelongsToMany );
if ( array_key_exists ( $type , $assoc )) {
foreach ( $this -> __associations as $a ) {
if ( isset ( $this -> { $a }[ $type ])) {
$assoc [ $type ][ 'association' ] = $a ;
break ;
}
}
return $assoc [ $type ];
}
return null ;
}
}
/**
* Gets the name and fields to be used by a join model . This allows specifying join fields in the association definition .
*
* @ param object $model The model to be joined
* @ param mixed $with The 'with' key of the model association
* @ param array $keys Any join keys which must be merged with the keys queried
* @ return array
2008-09-25 16:49:56 +00:00
* @ access public
2008-05-30 11:40:08 +00:00
*/
function joinModel ( $assoc , $keys = array ()) {
if ( is_string ( $assoc )) {
return array ( $assoc , array_keys ( $this -> { $assoc } -> schema ()));
} elseif ( is_array ( $assoc )) {
$with = key ( $assoc );
return array ( $with , array_unique ( array_merge ( $assoc [ $with ], $keys )));
} else {
trigger_error ( sprintf ( __ ( 'Invalid join model settings in %s' , true ), $model -> alias ), E_USER_WARNING );
}
}
/**
2008-10-31 19:05:30 +00:00
* Called before each find operation . Return false if you want to halt the find
* call , otherwise return the ( modified ) query data .
2008-05-30 11:40:08 +00:00
*
* @ param array $queryData Data used to execute this query , i . e . conditions , order , etc .
* @ return mixed true if the operation should continue , false if it should abort ; or , modified $queryData to continue with new $queryData
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 680 / beforeFind
2008-05-30 11:40:08 +00:00
*/
function beforeFind ( $queryData ) {
return true ;
}
/**
2008-10-31 19:05:30 +00:00
* Called after each find operation . Can be used to modify any results returned by find () .
2008-11-08 02:54:07 +00:00
* Return value should be the ( modified ) results .
2008-05-30 11:40:08 +00:00
*
* @ param mixed $results The results of the find operation
* @ param boolean $primary Whether this model is being queried directly ( vs . being queried as an association )
* @ return mixed Result of the find operation
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 681 / afterFind
2008-05-30 11:40:08 +00:00
*/
function afterFind ( $results , $primary = false ) {
return $results ;
}
/**
2008-10-31 19:05:30 +00:00
* Called before each save operation , after validation . Return a non - true result
* to halt the save .
2008-05-30 11:40:08 +00:00
*
* @ return boolean True if the operation should continue , false if it should abort
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 683 / beforeSave
2008-05-30 11:40:08 +00:00
*/
2008-09-23 18:50:27 +00:00
function beforeSave ( $options = array ()) {
2008-05-30 11:40:08 +00:00
return true ;
}
/**
2008-11-08 02:54:07 +00:00
* Called after each successful save operation .
2008-05-30 11:40:08 +00:00
*
* @ param boolean $created True if this save created a new record
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 684 / afterSave
2008-05-30 11:40:08 +00:00
*/
function afterSave ( $created ) {
}
/**
2008-11-08 02:54:07 +00:00
* Called after every deletion operation .
2008-05-30 11:40:08 +00:00
*
* @ param boolean $cascade If true records that depend on this record will also be deleted
* @ return boolean True if the operation should continue , false if it should abort
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 685 / beforeDelete
2008-05-30 11:40:08 +00:00
*/
function beforeDelete ( $cascade = true ) {
return true ;
}
/**
2008-10-31 19:05:30 +00:00
* Called after every deletion operation .
2008-05-30 11:40:08 +00:00
*
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 686 / afterDelete
2008-05-30 11:40:08 +00:00
*/
function afterDelete () {
}
/**
2008-11-08 02:54:07 +00:00
* Called during save operations , before validation . Please note that custom
2008-10-31 19:05:30 +00:00
* validation rules can be defined in $validate .
2008-05-30 11:40:08 +00:00
*
* @ return boolean True if validate operation should continue , false to abort
2008-09-30 00:13:15 +00:00
* @ param $options array Options passed from model :: save (), see $options of model :: save () .
2008-05-30 11:40:08 +00:00
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 682 / beforeValidate
2008-05-30 11:40:08 +00:00
*/
2008-09-23 18:50:27 +00:00
function beforeValidate ( $options = array ()) {
2008-05-30 11:40:08 +00:00
return true ;
}
/**
2008-10-31 19:05:30 +00:00
* Called when a DataSource - level error occurs .
2008-05-30 11:40:08 +00:00
*
* @ access public
2008-10-31 19:05:30 +00:00
* @ link http :// book . cakephp . org / view / 687 / onError
2008-05-30 11:40:08 +00:00
*/
function onError () {
}
/**
2008-10-31 19:05:30 +00:00
* Private method . Clears cache for this model .
2008-05-30 11:40:08 +00:00
*
* @ param string $type If null this deletes cached views if Cache . check is true
* Will be used to allow deleting query cache also
* @ return boolean true on delete
* @ access protected
* @ todo
*/
function _clearCache ( $type = null ) {
if ( $type === null ) {
if ( Configure :: read ( 'Cache.check' ) === true ) {
$assoc [] = strtolower ( Inflector :: pluralize ( $this -> alias ));
2008-10-26 18:51:38 +00:00
$assoc [] = strtolower ( Inflector :: underscore ( Inflector :: pluralize ( $this -> alias )));
2008-05-30 11:40:08 +00:00
foreach ( $this -> __associations as $key => $association ) {
foreach ( $this -> $association as $key => $className ) {
$check = strtolower ( Inflector :: pluralize ( $className [ 'className' ]));
if ( ! in_array ( $check , $assoc )) {
$assoc [] = strtolower ( Inflector :: pluralize ( $className [ 'className' ]));
2008-10-26 18:51:38 +00:00
$assoc [] = strtolower ( Inflector :: underscore ( Inflector :: pluralize ( $className [ 'className' ])));
2008-05-30 11:40:08 +00:00
}
}
}
clearCache ( $assoc );
return true ;
}
} else {
//Will use for query cache deleting
}
}
/**
2008-10-31 19:05:30 +00:00
* Called when serializing a model .
2008-05-30 11:40:08 +00:00
*
* @ return array Set of object variable names this model has
* @ access private
*/
function __sleep () {
$return = array_keys ( get_object_vars ( $this ));
return $return ;
}
/**
2008-10-31 19:05:30 +00:00
* Called when de - serializing a model .
2008-05-30 11:40:08 +00:00
*
* @ access private
2008-09-25 16:49:56 +00:00
* @ todo
2008-05-30 11:40:08 +00:00
*/
function __wakeup () {
}
2008-06-27 06:19:04 +00:00
/**
* @ deprecated
* @ see Model :: find ( 'all' )
*/
function findAll ( $conditions = null , $fields = null , $order = null , $limit = null , $page = 1 , $recursive = null ) {
//trigger_error(__('(Model::findAll) Deprecated, use Model::find("all")', true), E_USER_WARNING);
return $this -> find ( 'all' , compact ( 'conditions' , 'fields' , 'order' , 'limit' , 'page' , 'recursive' ));
}
/**
* @ deprecated
* @ see Model :: find ( 'count' )
*/
function findCount ( $conditions = null , $recursive = 0 ) {
//trigger_error(__('(Model::findCount) Deprecated, use Model::find("count")', true), E_USER_WARNING);
return $this -> find ( 'count' , compact ( 'conditions' , 'recursive' ));
}
/**
* @ deprecated
* @ see Model :: find ( 'threaded' )
*/
function findAllThreaded ( $conditions = null , $fields = null , $order = null ) {
//trigger_error(__('(Model::findAllThreaded) Deprecated, use Model::find("threaded")', true), E_USER_WARNING);
return $this -> find ( 'threaded' , compact ( 'conditions' , 'fields' , 'order' ));
}
/**
* @ deprecated
* @ see Model :: find ( 'neighbors' )
*/
function findNeighbours ( $conditions = null , $field , $value ) {
//trigger_error(__('(Model::findNeighbours) Deprecated, use Model::find("neighbors")', true), E_USER_WARNING);
$query = compact ( 'conditions' , 'field' , 'value' );
$query [ 'fields' ] = $field ;
if ( is_array ( $field )) {
$query [ 'field' ] = $field [ 0 ];
}
return $this -> find ( 'neighbors' , $query );
}
2008-05-30 11:40:08 +00:00
}
if ( ! defined ( 'CAKEPHP_UNIT_TEST_EXECUTION' )) {
Overloadable :: overload ( 'Model' );
}
2008-08-07 15:36:26 +00:00
?>