Model.php 106 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386
  1. <?php
  2. /**
  3. * Object-relational mapper.
  4. *
  5. * DBO-backed object data model, for mapping database tables to Cake objects.
  6. *
  7. * PHP versions 5
  8. *
  9. * CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
  10. * Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
  11. *
  12. * Licensed under The MIT License
  13. * Redistributions of files must retain the above copyright notice.
  14. *
  15. * @copyright Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
  16. * @link http://cakephp.org CakePHP(tm) Project
  17. * @package Cake.Model
  18. * @since CakePHP(tm) v 0.10.0.0
  19. * @license MIT License (http://www.opensource.org/licenses/mit-license.php)
  20. */
  21. App::uses('ClassRegistry', 'Utility');
  22. App::uses('Validation', 'Utility');
  23. App::uses('String', 'Utility');
  24. App::uses('Hash', 'Utility');
  25. App::uses('BehaviorCollection', 'Model');
  26. App::uses('ModelBehavior', 'Model');
  27. App::uses('ModelValidator', 'Model');
  28. App::uses('ConnectionManager', 'Model');
  29. App::uses('Xml', 'Utility');
  30. App::uses('CakeEvent', 'Event');
  31. App::uses('CakeEventListener', 'Event');
  32. App::uses('CakeEventManager', 'Event');
  33. /**
  34. * Object-relational mapper.
  35. *
  36. * DBO-backed object data model.
  37. * Automatically selects a database table name based on a pluralized lowercase object class name
  38. * (i.e. class 'User' => table 'users'; class 'Man' => table 'men')
  39. * The table is required to have at least 'id auto_increment' primary key.
  40. *
  41. * @package Cake.Model
  42. * @link http://book.cakephp.org/2.0/en/models.html
  43. */
  44. class Model extends Object implements CakeEventListener {
  45. /**
  46. * The name of the DataSource connection that this Model uses
  47. *
  48. * The value must be an attribute name that you defined in `app/Config/database.php`
  49. * or created using `ConnectionManager::create()`.
  50. *
  51. * @var string
  52. * @link http://book.cakephp.org/2.0/en/models/model-attributes.html#usedbconfig
  53. */
  54. public $useDbConfig = 'default';
  55. /**
  56. * Custom database table name, or null/false if no table association is desired.
  57. *
  58. * @var string
  59. * @link http://book.cakephp.org/2.0/en/models/model-attributes.html#usetable
  60. */
  61. public $useTable = null;
  62. /**
  63. * Custom display field name. Display fields are used by Scaffold, in SELECT boxes' OPTION elements.
  64. *
  65. * This field is also used in `find('list')` when called with no extra parameters in the fields list
  66. *
  67. * @var string
  68. * @link http://book.cakephp.org/2.0/en/models/model-attributes.html#displayfield
  69. */
  70. public $displayField = null;
  71. /**
  72. * Value of the primary key ID of the record that this model is currently pointing to.
  73. * Automatically set after database insertions.
  74. *
  75. * @var mixed
  76. */
  77. public $id = false;
  78. /**
  79. * Container for the data that this model gets from persistent storage (usually, a database).
  80. *
  81. * @var array
  82. * @link http://book.cakephp.org/2.0/en/models/model-attributes.html#data
  83. */
  84. public $data = array();
  85. /**
  86. * Holds physical schema/database name for this model. Automatically set during Model creation.
  87. *
  88. * @var string
  89. * @access public
  90. */
  91. public $schemaName = null;
  92. /**
  93. * Table name for this Model.
  94. *
  95. * @var string
  96. */
  97. public $table = false;
  98. /**
  99. * The name of the primary key field for this model.
  100. *
  101. * @var string
  102. * @link http://book.cakephp.org/2.0/en/models/model-attributes.html#primaryKey
  103. */
  104. public $primaryKey = null;
  105. /**
  106. * Field-by-field table metadata.
  107. *
  108. * @var array
  109. */
  110. protected $_schema = null;
  111. /**
  112. * List of validation rules. It must be an array with the field name as key and using
  113. * as value one of the following possibilities
  114. *
  115. * ### Validating using regular expressions
  116. *
  117. * {{{
  118. * public $validate = array(
  119. * 'name' => '/^[a-z].+$/i'
  120. * );
  121. * }}}
  122. *
  123. * ### Validating using methods (no parameters)
  124. *
  125. * {{{
  126. * public $validate = array(
  127. * 'name' => 'notEmpty'
  128. * );
  129. * }}}
  130. *
  131. * ### Validating using methods (with parameters)
  132. *
  133. * {{{
  134. * public $validate = array(
  135. * 'age' => array(
  136. * 'rule' => array('between', 5, 25)
  137. * )
  138. * );
  139. * }}}
  140. *
  141. * ### Validating using custom method
  142. *
  143. * {{{
  144. * public $validate = array(
  145. * 'password' => array(
  146. * 'rule' => array('customValidation')
  147. * )
  148. * );
  149. * public function customValidation($data) {
  150. * // $data will contain array('password' => 'value')
  151. * if (isset($this->data[$this->alias]['password2'])) {
  152. * return $this->data[$this->alias]['password2'] === current($data);
  153. * }
  154. * return true;
  155. * }
  156. * }}}
  157. *
  158. * ### Validations with messages
  159. *
  160. * The messages will be used in Model::$validationErrors and can be used in the FormHelper
  161. *
  162. * {{{
  163. * public $validate = array(
  164. * 'age' => array(
  165. * 'rule' => array('between', 5, 25),
  166. * 'message' => array('The age must be between %d and %d.')
  167. * )
  168. * );
  169. * }}}
  170. *
  171. * ### Multiple validations to the same field
  172. *
  173. * {{{
  174. * public $validate = array(
  175. * 'login' => array(
  176. * array(
  177. * 'rule' => 'alphaNumeric',
  178. * 'message' => 'Only alphabets and numbers allowed',
  179. * 'last' => true
  180. * ),
  181. * array(
  182. * 'rule' => array('minLength', 8),
  183. * 'message' => array('Minimum length of %d characters')
  184. * )
  185. * )
  186. * );
  187. * }}}
  188. *
  189. * ### Valid keys in validations
  190. *
  191. * - `rule`: String with method name, regular expression (started by slash) or array with method and parameters
  192. * - `message`: String with the message or array if have multiple parameters. See http://php.net/sprintf
  193. * - `last`: Boolean value to indicate if continue validating the others rules if the current fail [Default: true]
  194. * - `required`: Boolean value to indicate if the field must be present on save
  195. * - `allowEmpty`: Boolean value to indicate if the field can be empty
  196. * - `on`: Possible values: `update`, `create`. Indicate to apply this rule only on update or create
  197. *
  198. * @var array
  199. * @link http://book.cakephp.org/2.0/en/models/model-attributes.html#validate
  200. * @link http://book.cakephp.org/2.0/en/models/data-validation.html
  201. */
  202. public $validate = array();
  203. /**
  204. * List of validation errors.
  205. *
  206. * @var array
  207. */
  208. public $validationErrors = array();
  209. /**
  210. * Name of the validation string domain to use when translating validation errors.
  211. *
  212. * @var string
  213. */
  214. public $validationDomain = null;
  215. /**
  216. * Database table prefix for tables in model.
  217. *
  218. * @var string
  219. * @link http://book.cakephp.org/2.0/en/models/model-attributes.html#tableprefix
  220. */
  221. public $tablePrefix = null;
  222. /**
  223. * Name of the model.
  224. *
  225. * @var string
  226. * @link http://book.cakephp.org/2.0/en/models/model-attributes.html#name
  227. */
  228. public $name = null;
  229. /**
  230. * Alias name for model.
  231. *
  232. * @var string
  233. */
  234. public $alias = null;
  235. /**
  236. * List of table names included in the model description. Used for associations.
  237. *
  238. * @var array
  239. */
  240. public $tableToModel = array();
  241. /**
  242. * Whether or not to cache queries for this model. This enables in-memory
  243. * caching only, the results are not stored beyond the current request.
  244. *
  245. * @var boolean
  246. * @link http://book.cakephp.org/2.0/en/models/model-attributes.html#cachequeries
  247. */
  248. public $cacheQueries = false;
  249. /**
  250. * Detailed list of belongsTo associations.
  251. *
  252. * ### Basic usage
  253. *
  254. * `public $belongsTo = array('Group', 'Department');`
  255. *
  256. * ### Detailed configuration
  257. *
  258. * {{{
  259. * public $belongsTo = array(
  260. * 'Group',
  261. * 'Department' => array(
  262. * 'className' => 'Department',
  263. * 'foreignKey' => 'department_id'
  264. * )
  265. * );
  266. * }}}
  267. *
  268. * ### Possible keys in association
  269. *
  270. * - `className`: the classname of the model being associated to the current model.
  271. * If you're defining a 'Profile belongsTo User' relationship, the className key should equal 'User.'
  272. * - `foreignKey`: the name of the foreign key found in the current model. This is
  273. * especially handy if you need to define multiple belongsTo relationships. The default
  274. * value for this key is the underscored, singular name of the other model, suffixed with '_id'.
  275. * - `conditions`: An SQL fragment used to filter related model records. It's good
  276. * practice to use model names in SQL fragments: 'User.active = 1' is always
  277. * better than just 'active = 1.'
  278. * - `type`: the type of the join to use in the SQL query, default is LEFT which
  279. * may not fit your needs in all situations, INNER may be helpful when you want
  280. * everything from your main and associated models or nothing at all!(effective
  281. * when used with some conditions of course). (NB: type value is in lower case - i.e. left, inner)
  282. * - `fields`: A list of fields to be retrieved when the associated model data is
  283. * fetched. Returns all fields by default.
  284. * - `order`: An SQL fragment that defines the sorting order for the returned associated rows.
  285. * - `counterCache`: If set to true the associated Model will automatically increase or
  286. * decrease the "[singular_model_name]_count" field in the foreign table whenever you do
  287. * a save() or delete(). If its a string then its the field name to use. The value in the
  288. * counter field represents the number of related rows.
  289. * - `counterScope`: Optional conditions array to use for updating counter cache field.
  290. *
  291. * @var array
  292. * @link http://book.cakephp.org/2.0/en/models/associations-linking-models-together.html#belongsto
  293. */
  294. public $belongsTo = array();
  295. /**
  296. * Detailed list of hasOne associations.
  297. *
  298. * ### Basic usage
  299. *
  300. * `public $hasOne = array('Profile', 'Address');`
  301. *
  302. * ### Detailed configuration
  303. *
  304. * {{{
  305. * public $hasOne = array(
  306. * 'Profile',
  307. * 'Address' => array(
  308. * 'className' => 'Address',
  309. * 'foreignKey' => 'user_id'
  310. * )
  311. * );
  312. * }}}
  313. *
  314. * ### Possible keys in association
  315. *
  316. * - `className`: the classname of the model being associated to the current model.
  317. * If you're defining a 'User hasOne Profile' relationship, the className key should equal 'Profile.'
  318. * - `foreignKey`: the name of the foreign key found in the other model. This is
  319. * especially handy if you need to define multiple hasOne relationships.
  320. * The default value for this key is the underscored, singular name of the
  321. * current model, suffixed with '_id'. In the example above it would default to 'user_id'.
  322. * - `conditions`: An SQL fragment used to filter related model records. It's good
  323. * practice to use model names in SQL fragments: "Profile.approved = 1" is
  324. * always better than just "approved = 1."
  325. * - `fields`: A list of fields to be retrieved when the associated model data is
  326. * fetched. Returns all fields by default.
  327. * - `order`: An SQL fragment that defines the sorting order for the returned associated rows.
  328. * - `dependent`: When the dependent key is set to true, and the model's delete()
  329. * method is called with the cascade parameter set to true, associated model
  330. * records are also deleted. In this case we set it true so that deleting a
  331. * User will also delete her associated Profile.
  332. *
  333. * @var array
  334. * @link http://book.cakephp.org/2.0/en/models/associations-linking-models-together.html#hasone
  335. */
  336. public $hasOne = array();
  337. /**
  338. * Detailed list of hasMany associations.
  339. *
  340. * ### Basic usage
  341. *
  342. * `public $hasMany = array('Comment', 'Task');`
  343. *
  344. * ### Detailed configuration
  345. *
  346. * {{{
  347. * public $hasMany = array(
  348. * 'Comment',
  349. * 'Task' => array(
  350. * 'className' => 'Task',
  351. * 'foreignKey' => 'user_id'
  352. * )
  353. * );
  354. * }}}
  355. *
  356. * ### Possible keys in association
  357. *
  358. * - `className`: the classname of the model being associated to the current model.
  359. * If you're defining a 'User hasMany Comment' relationship, the className key should equal 'Comment.'
  360. * - `foreignKey`: the name of the foreign key found in the other model. This is
  361. * especially handy if you need to define multiple hasMany relationships. The default
  362. * value for this key is the underscored, singular name of the actual model, suffixed with '_id'.
  363. * - `conditions`: An SQL fragment used to filter related model records. It's good
  364. * practice to use model names in SQL fragments: "Comment.status = 1" is always
  365. * better than just "status = 1."
  366. * - `fields`: A list of fields to be retrieved when the associated model data is
  367. * fetched. Returns all fields by default.
  368. * - `order`: An SQL fragment that defines the sorting order for the returned associated rows.
  369. * - `limit`: The maximum number of associated rows you want returned.
  370. * - `offset`: The number of associated rows to skip over (given the current
  371. * conditions and order) before fetching and associating.
  372. * - `dependent`: When dependent is set to true, recursive model deletion is
  373. * possible. In this example, Comment records will be deleted when their
  374. * associated User record has been deleted.
  375. * - `exclusive`: When exclusive is set to true, recursive model deletion does
  376. * the delete with a deleteAll() call, instead of deleting each entity separately.
  377. * This greatly improves performance, but may not be ideal for all circumstances.
  378. * - `finderQuery`: A complete SQL query CakePHP can use to fetch associated model
  379. * records. This should be used in situations that require very custom results.
  380. *
  381. * @var array
  382. * @link http://book.cakephp.org/2.0/en/models/associations-linking-models-together.html#hasmany
  383. */
  384. public $hasMany = array();
  385. /**
  386. * Detailed list of hasAndBelongsToMany associations.
  387. *
  388. * ### Basic usage
  389. *
  390. * `public $hasAndBelongsToMany = array('Role', 'Address');`
  391. *
  392. * ### Detailed configuration
  393. *
  394. * {{{
  395. * public $hasAndBelongsToMany = array(
  396. * 'Role',
  397. * 'Address' => array(
  398. * 'className' => 'Address',
  399. * 'foreignKey' => 'user_id',
  400. * 'associationForeignKey' => 'address_id',
  401. * 'joinTable' => 'addresses_users'
  402. * )
  403. * );
  404. * }}}
  405. *
  406. * ### Possible keys in association
  407. *
  408. * - `className`: the classname of the model being associated to the current model.
  409. * If you're defining a 'Recipe HABTM Tag' relationship, the className key should equal 'Tag.'
  410. * - `joinTable`: The name of the join table used in this association (if the
  411. * current table doesn't adhere to the naming convention for HABTM join tables).
  412. * - `with`: Defines the name of the model for the join table. By default CakePHP
  413. * will auto-create a model for you. Using the example above it would be called
  414. * RecipesTag. By using this key you can override this default name. The join
  415. * table model can be used just like any "regular" model to access the join table directly.
  416. * - `foreignKey`: the name of the foreign key found in the current model.
  417. * This is especially handy if you need to define multiple HABTM relationships.
  418. * The default value for this key is the underscored, singular name of the
  419. * current model, suffixed with '_id'.
  420. * - `associationForeignKey`: the name of the foreign key found in the other model.
  421. * This is especially handy if you need to define multiple HABTM relationships.
  422. * The default value for this key is the underscored, singular name of the other
  423. * model, suffixed with '_id'.
  424. * - `unique`: If true (default value) cake will first delete existing relationship
  425. * records in the foreign keys table before inserting new ones, when updating a
  426. * record. So existing associations need to be passed again when updating.
  427. * To prevent deletion of existing relationship records, set this key to a string 'keepExisting'.
  428. * - `conditions`: An SQL fragment used to filter related model records. It's good
  429. * practice to use model names in SQL fragments: "Comment.status = 1" is always
  430. * better than just "status = 1."
  431. * - `fields`: A list of fields to be retrieved when the associated model data is
  432. * fetched. Returns all fields by default.
  433. * - `order`: An SQL fragment that defines the sorting order for the returned associated rows.
  434. * - `limit`: The maximum number of associated rows you want returned.
  435. * - `offset`: The number of associated rows to skip over (given the current
  436. * conditions and order) before fetching and associating.
  437. * - `finderQuery`, `deleteQuery`, `insertQuery`: A complete SQL query CakePHP
  438. * can use to fetch, delete, or create new associated model records. This should
  439. * be used in situations that require very custom results.
  440. *
  441. * @var array
  442. * @link http://book.cakephp.org/2.0/en/models/associations-linking-models-together.html#hasandbelongstomany-habtm
  443. */
  444. public $hasAndBelongsToMany = array();
  445. /**
  446. * List of behaviors to load when the model object is initialized. Settings can be
  447. * passed to behaviors by using the behavior name as index. Eg:
  448. *
  449. * public $actsAs = array('Translate', 'MyBehavior' => array('setting1' => 'value1'))
  450. *
  451. * @var array
  452. * @link http://book.cakephp.org/2.0/en/models/behaviors.html#using-behaviors
  453. */
  454. public $actsAs = null;
  455. /**
  456. * Holds the Behavior objects currently bound to this model.
  457. *
  458. * @var BehaviorCollection
  459. */
  460. public $Behaviors = null;
  461. /**
  462. * Whitelist of fields allowed to be saved.
  463. *
  464. * @var array
  465. */
  466. public $whitelist = array();
  467. /**
  468. * Whether or not to cache sources for this model.
  469. *
  470. * @var boolean
  471. */
  472. public $cacheSources = true;
  473. /**
  474. * Type of find query currently executing.
  475. *
  476. * @var string
  477. */
  478. public $findQueryType = null;
  479. /**
  480. * Number of associations to recurse through during find calls. Fetches only
  481. * the first level by default.
  482. *
  483. * @var integer
  484. * @link http://book.cakephp.org/2.0/en/models/model-attributes.html#recursive
  485. */
  486. public $recursive = 1;
  487. /**
  488. * The column name(s) and direction(s) to order find results by default.
  489. *
  490. * public $order = "Post.created DESC";
  491. * public $order = array("Post.view_count DESC", "Post.rating DESC");
  492. *
  493. * @var string
  494. * @link http://book.cakephp.org/2.0/en/models/model-attributes.html#order
  495. */
  496. public $order = null;
  497. /**
  498. * Array of virtual fields this model has. Virtual fields are aliased
  499. * SQL expressions. Fields added to this property will be read as other fields in a model
  500. * but will not be saveable.
  501. *
  502. * `public $virtualFields = array('two' => '1 + 1');`
  503. *
  504. * Is a simplistic example of how to set virtualFields
  505. *
  506. * @var array
  507. * @link http://book.cakephp.org/2.0/en/models/model-attributes.html#virtualfields
  508. */
  509. public $virtualFields = array();
  510. /**
  511. * Default list of association keys.
  512. *
  513. * @var array
  514. */
  515. protected $_associationKeys = array(
  516. 'belongsTo' => array('className', 'foreignKey', 'conditions', 'fields', 'order', 'counterCache'),
  517. 'hasOne' => array('className', 'foreignKey', 'conditions', 'fields', 'order', 'dependent'),
  518. 'hasMany' => array('className', 'foreignKey', 'conditions', 'fields', 'order', 'limit', 'offset', 'dependent', 'exclusive', 'finderQuery', 'counterQuery'),
  519. 'hasAndBelongsToMany' => array('className', 'joinTable', 'with', 'foreignKey', 'associationForeignKey', 'conditions', 'fields', 'order', 'limit', 'offset', 'unique', 'finderQuery', 'deleteQuery', 'insertQuery')
  520. );
  521. /**
  522. * Holds provided/generated association key names and other data for all associations.
  523. *
  524. * @var array
  525. */
  526. protected $_associations = array('belongsTo', 'hasOne', 'hasMany', 'hasAndBelongsToMany');
  527. /**
  528. * Holds model associations temporarily to allow for dynamic (un)binding.
  529. *
  530. * @var array
  531. */
  532. public $__backAssociation = array();
  533. /**
  534. * Back inner association
  535. *
  536. * @var array
  537. */
  538. public $__backInnerAssociation = array();
  539. /**
  540. * Back original association
  541. *
  542. * @var array
  543. */
  544. public $__backOriginalAssociation = array();
  545. /**
  546. * Back containable association
  547. *
  548. * @var array
  549. */
  550. public $__backContainableAssociation = array();
  551. /**
  552. * The ID of the model record that was last inserted.
  553. *
  554. * @var integer
  555. */
  556. protected $_insertID = null;
  557. /**
  558. * Has the datasource been configured.
  559. *
  560. * @var boolean
  561. * @see Model::getDataSource
  562. */
  563. protected $_sourceConfigured = false;
  564. /**
  565. * List of valid finder method options, supplied as the first parameter to find().
  566. *
  567. * @var array
  568. */
  569. public $findMethods = array(
  570. 'all' => true, 'first' => true, 'count' => true,
  571. 'neighbors' => true, 'list' => true, 'threaded' => true
  572. );
  573. /**
  574. * Instance of the CakeEventManager this model is using
  575. * to dispatch inner events.
  576. *
  577. * @var CakeEventManager
  578. */
  579. protected $_eventManager = null;
  580. /**
  581. * Instance of the ModelValidator
  582. *
  583. * @var ModelValidator
  584. */
  585. protected $_validator = null;
  586. /**
  587. * Constructor. Binds the model's database table to the object.
  588. *
  589. * If `$id` is an array it can be used to pass several options into the model.
  590. *
  591. * - id - The id to start the model on.
  592. * - table - The table to use for this model.
  593. * - ds - The connection name this model is connected to.
  594. * - name - The name of the model eg. Post.
  595. * - alias - The alias of the model, this is used for registering the instance in the `ClassRegistry`.
  596. * eg. `ParentThread`
  597. *
  598. * ### Overriding Model's __construct method.
  599. *
  600. * When overriding Model::__construct() be careful to include and pass in all 3 of the
  601. * arguments to `parent::__construct($id, $table, $ds);`
  602. *
  603. * ### Dynamically creating models
  604. *
  605. * You can dynamically create model instances using the $id array syntax.
  606. *
  607. * {{{
  608. * $Post = new Model(array('table' => 'posts', 'name' => 'Post', 'ds' => 'connection2'));
  609. * }}}
  610. *
  611. * Would create a model attached to the posts table on connection2. Dynamic model creation is useful
  612. * when you want a model object that contains no associations or attached behaviors.
  613. *
  614. * @param mixed $id Set this ID for this model on startup, can also be an array of options, see above.
  615. * @param string $table Name of database table to use.
  616. * @param string $ds DataSource connection name.
  617. */
  618. public function __construct($id = false, $table = null, $ds = null) {
  619. parent::__construct();
  620. if (is_array($id)) {
  621. extract(array_merge(
  622. array(
  623. 'id' => $this->id, 'table' => $this->useTable, 'ds' => $this->useDbConfig,
  624. 'name' => $this->name, 'alias' => $this->alias
  625. ),
  626. $id
  627. ));
  628. }
  629. if ($this->name === null) {
  630. $this->name = (isset($name) ? $name : get_class($this));
  631. }
  632. if ($this->alias === null) {
  633. $this->alias = (isset($alias) ? $alias : $this->name);
  634. }
  635. if ($this->primaryKey === null) {
  636. $this->primaryKey = 'id';
  637. }
  638. ClassRegistry::addObject($this->alias, $this);
  639. $this->id = $id;
  640. unset($id);
  641. if ($table === false) {
  642. $this->useTable = false;
  643. } elseif ($table) {
  644. $this->useTable = $table;
  645. }
  646. if ($ds !== null) {
  647. $this->useDbConfig = $ds;
  648. }
  649. if (is_subclass_of($this, 'AppModel')) {
  650. $merge = array('actsAs', 'findMethods');
  651. $parentClass = get_parent_class($this);
  652. if ($parentClass !== 'AppModel') {
  653. $this->_mergeVars($merge, $parentClass);
  654. }
  655. $this->_mergeVars($merge, 'AppModel');
  656. }
  657. $this->_mergeVars(array('findMethods'), 'Model');
  658. $this->Behaviors = new BehaviorCollection();
  659. if ($this->useTable !== false) {
  660. if ($this->useTable === null) {
  661. $this->useTable = Inflector::tableize($this->name);
  662. }
  663. if ($this->displayField == null) {
  664. unset($this->displayField);
  665. }
  666. $this->table = $this->useTable;
  667. $this->tableToModel[$this->table] = $this->alias;
  668. } elseif ($this->table === false) {
  669. $this->table = Inflector::tableize($this->name);
  670. }
  671. if ($this->tablePrefix === null) {
  672. unset($this->tablePrefix);
  673. }
  674. $this->_createLinks();
  675. $this->Behaviors->init($this->alias, $this->actsAs);
  676. }
  677. /**
  678. * Returns a list of all events that will fire in the model during it's lifecycle.
  679. * You can override this function to add you own listener callbacks
  680. *
  681. * @return array
  682. */
  683. public function implementedEvents() {
  684. return array(
  685. 'Model.beforeFind' => array('callable' => 'beforeFind', 'passParams' => true),
  686. 'Model.afterFind' => array('callable' => 'afterFind', 'passParams' => true),
  687. 'Model.beforeValidate' => array('callable' => 'beforeValidate', 'passParams' => true),
  688. 'Model.afterValidate' => array('callable' => 'afterValidate'),
  689. 'Model.beforeSave' => array('callable' => 'beforeSave', 'passParams' => true),
  690. 'Model.afterSave' => array('callable' => 'afterSave', 'passParams' => true),
  691. 'Model.beforeDelete' => array('callable' => 'beforeDelete', 'passParams' => true),
  692. 'Model.afterDelete' => array('callable' => 'afterDelete'),
  693. );
  694. }
  695. /**
  696. * Returns the CakeEventManager manager instance that is handling any callbacks.
  697. * You can use this instance to register any new listeners or callbacks to the
  698. * model events, or create your own events and trigger them at will.
  699. *
  700. * @return CakeEventManager
  701. */
  702. public function getEventManager() {
  703. if (empty($this->_eventManager)) {
  704. $this->_eventManager = new CakeEventManager();
  705. $this->_eventManager->attach($this->Behaviors);
  706. $this->_eventManager->attach($this);
  707. }
  708. return $this->_eventManager;
  709. }
  710. /**
  711. * Handles custom method calls, like findBy<field> for DB models,
  712. * and custom RPC calls for remote data sources.
  713. *
  714. * @param string $method Name of method to call.
  715. * @param array $params Parameters for the method.
  716. * @return mixed Whatever is returned by called method
  717. */
  718. public function __call($method, $params) {
  719. $result = $this->Behaviors->dispatchMethod($this, $method, $params);
  720. if ($result !== array('unhandled')) {
  721. return $result;
  722. }
  723. $return = $this->getDataSource()->query($method, $params, $this);
  724. return $return;
  725. }
  726. /**
  727. * Handles the lazy loading of model associations by looking in the association arrays for the requested variable
  728. *
  729. * @param string $name variable tested for existence in class
  730. * @return boolean true if the variable exists (if is a not loaded model association it will be created), false otherwise
  731. */
  732. public function __isset($name) {
  733. $className = false;
  734. foreach ($this->_associations as $type) {
  735. if (isset($name, $this->{$type}[$name])) {
  736. $className = empty($this->{$type}[$name]['className']) ? $name : $this->{$type}[$name]['className'];
  737. break;
  738. } elseif (isset($name, $this->__backAssociation[$type][$name])) {
  739. $className = empty($this->__backAssociation[$type][$name]['className']) ?
  740. $name : $this->__backAssociation[$type][$name]['className'];
  741. break;
  742. } elseif ($type == 'hasAndBelongsToMany') {
  743. foreach ($this->{$type} as $k => $relation) {
  744. if (empty($relation['with'])) {
  745. continue;
  746. }
  747. if (is_array($relation['with'])) {
  748. if (key($relation['with']) === $name) {
  749. $className = $name;
  750. }
  751. } else {
  752. list($plugin, $class) = pluginSplit($relation['with']);
  753. if ($class === $name) {
  754. $className = $relation['with'];
  755. }
  756. }
  757. if ($className) {
  758. $assocKey = $k;
  759. $dynamic = !empty($relation['dynamicWith']);
  760. break(2);
  761. }
  762. }
  763. }
  764. }
  765. if (!$className) {
  766. return false;
  767. }
  768. list($plugin, $className) = pluginSplit($className);
  769. if (!ClassRegistry::isKeySet($className) && !empty($dynamic)) {
  770. $this->{$className} = new AppModel(array(
  771. 'name' => $className,
  772. 'table' => $this->hasAndBelongsToMany[$assocKey]['joinTable'],
  773. 'ds' => $this->useDbConfig
  774. ));
  775. } else {
  776. $this->_constructLinkedModel($name, $className, $plugin);
  777. }
  778. if (!empty($assocKey)) {
  779. $this->hasAndBelongsToMany[$assocKey]['joinTable'] = $this->{$name}->table;
  780. if (count($this->{$name}->schema()) <= 2 && $this->{$name}->primaryKey !== false) {
  781. $this->{$name}->primaryKey = $this->hasAndBelongsToMany[$assocKey]['foreignKey'];
  782. }
  783. }
  784. return true;
  785. }
  786. /**
  787. * Returns the value of the requested variable if it can be set by __isset()
  788. *
  789. * @param string $name variable requested for it's value or reference
  790. * @return mixed value of requested variable if it is set
  791. */
  792. public function __get($name) {
  793. if ($name === 'displayField') {
  794. return $this->displayField = $this->hasField(array('title', 'name', $this->primaryKey));
  795. }
  796. if ($name === 'tablePrefix') {
  797. $this->setDataSource();
  798. if (property_exists($this, 'tablePrefix') && !empty($this->tablePrefix)) {
  799. return $this->tablePrefix;
  800. }
  801. return $this->tablePrefix = null;
  802. }
  803. if (isset($this->{$name})) {
  804. return $this->{$name};
  805. }
  806. }
  807. /**
  808. * Bind model associations on the fly.
  809. *
  810. * If `$reset` is false, association will not be reset
  811. * to the originals defined in the model
  812. *
  813. * Example: Add a new hasOne binding to the Profile model not
  814. * defined in the model source code:
  815. *
  816. * `$this->User->bindModel( array('hasOne' => array('Profile')) );`
  817. *
  818. * Bindings that are not made permanent will be reset by the next Model::find() call on this
  819. * model.
  820. *
  821. * @param array $params Set of bindings (indexed by binding type)
  822. * @param boolean $reset Set to false to make the binding permanent
  823. * @return boolean Success
  824. * @link http://book.cakephp.org/2.0/en/models/associations-linking-models-together.html#creating-and-destroying-associations-on-the-fly
  825. */
  826. public function bindModel($params, $reset = true) {
  827. foreach ($params as $assoc => $model) {
  828. if ($reset === true && !isset($this->__backAssociation[$assoc])) {
  829. $this->__backAssociation[$assoc] = $this->{$assoc};
  830. }
  831. foreach ($model as $key => $value) {
  832. $assocName = $key;
  833. if (is_numeric($key)) {
  834. $assocName = $value;
  835. $value = array();
  836. }
  837. $this->{$assoc}[$assocName] = $value;
  838. if (property_exists($this, $assocName)) {
  839. unset($this->{$assocName});
  840. }
  841. if ($reset === false && isset($this->__backAssociation[$assoc])) {
  842. $this->__backAssociation[$assoc][$assocName] = $value;
  843. }
  844. }
  845. }
  846. $this->_createLinks();
  847. return true;
  848. }
  849. /**
  850. * Turn off associations on the fly.
  851. *
  852. * If $reset is false, association will not be reset
  853. * to the originals defined in the model
  854. *
  855. * Example: Turn off the associated Model Support request,
  856. * to temporarily lighten the User model:
  857. *
  858. * `$this->User->unbindModel( array('hasMany' => array('Supportrequest')) );`
  859. *
  860. * unbound models that are not made permanent will reset with the next call to Model::find()
  861. *
  862. * @param array $params Set of bindings to unbind (indexed by binding type)
  863. * @param boolean $reset Set to false to make the unbinding permanent
  864. * @return boolean Success
  865. * @link http://book.cakephp.org/2.0/en/models/associations-linking-models-together.html#creating-and-destroying-associations-on-the-fly
  866. */
  867. public function unbindModel($params, $reset = true) {
  868. foreach ($params as $assoc => $models) {
  869. if ($reset === true && !isset($this->__backAssociation[$assoc])) {
  870. $this->__backAssociation[$assoc] = $this->{$assoc};
  871. }
  872. foreach ($models as $model) {
  873. if ($reset === false && isset($this->__backAssociation[$assoc][$model])) {
  874. unset($this->__backAssociation[$assoc][$model]);
  875. }
  876. unset($this->{$assoc}[$model]);
  877. }
  878. }
  879. return true;
  880. }
  881. /**
  882. * Create a set of associations.
  883. *
  884. * @return void
  885. */
  886. protected function _createLinks() {
  887. foreach ($this->_associations as $type) {
  888. if (!is_array($this->{$type})) {
  889. $this->{$type} = explode(',', $this->{$type});
  890. foreach ($this->{$type} as $i => $className) {
  891. $className = trim($className);
  892. unset ($this->{$type}[$i]);
  893. $this->{$type}[$className] = array();
  894. }
  895. }
  896. if (!empty($this->{$type})) {
  897. foreach ($this->{$type} as $assoc => $value) {
  898. $plugin = null;
  899. if (is_numeric($assoc)) {
  900. unset ($this->{$type}[$assoc]);
  901. $assoc = $value;
  902. $value = array();
  903. if (strpos($assoc, '.') !== false) {
  904. list($plugin, $assoc) = pluginSplit($assoc, true);
  905. $this->{$type}[$assoc] = array('className' => $plugin . $assoc);
  906. } else {
  907. $this->{$type}[$assoc] = $value;
  908. }
  909. }
  910. $this->_generateAssociation($type, $assoc);
  911. }
  912. }
  913. }
  914. }
  915. /**
  916. * Protected helper method to create associated models of a given class.
  917. *
  918. * @param string $assoc Association name
  919. * @param string $className Class name
  920. * @param string $plugin name of the plugin where $className is located
  921. * examples: public $hasMany = array('Assoc' => array('className' => 'ModelName'));
  922. * usage: $this->Assoc->modelMethods();
  923. *
  924. * public $hasMany = array('ModelName');
  925. * usage: $this->ModelName->modelMethods();
  926. * @return void
  927. */
  928. protected function _constructLinkedModel($assoc, $className = null, $plugin = null) {
  929. if (empty($className)) {
  930. $className = $assoc;
  931. }
  932. if (!isset($this->{$assoc}) || $this->{$assoc}->name !== $className) {
  933. if ($plugin) {
  934. $plugin .= '.';
  935. }
  936. $model = array('class' => $plugin . $className, 'alias' => $assoc);
  937. $this->{$assoc} = ClassRegistry::init($model);
  938. if ($plugin) {
  939. ClassRegistry::addObject($plugin . $className, $this->{$assoc});
  940. }
  941. if ($assoc) {
  942. $this->tableToModel[$this->{$assoc}->table] = $assoc;
  943. }
  944. }
  945. }
  946. /**
  947. * Build an array-based association from string.
  948. *
  949. * @param string $type 'belongsTo', 'hasOne', 'hasMany', 'hasAndBelongsToMany'
  950. * @param string $assocKey
  951. * @return void
  952. */
  953. protected function _generateAssociation($type, $assocKey) {
  954. $class = $assocKey;
  955. $dynamicWith = false;
  956. foreach ($this->_associationKeys[$type] as $key) {
  957. if (!isset($this->{$type}[$assocKey][$key]) || $this->{$type}[$assocKey][$key] === null) {
  958. $data = '';
  959. switch ($key) {
  960. case 'fields':
  961. $data = '';
  962. break;
  963. case 'foreignKey':
  964. $data = (($type == 'belongsTo') ? Inflector::underscore($assocKey) : Inflector::singularize($this->table)) . '_id';
  965. break;
  966. case 'associationForeignKey':
  967. $data = Inflector::singularize($this->{$class}->table) . '_id';
  968. break;
  969. case 'with':
  970. $data = Inflector::camelize(Inflector::singularize($this->{$type}[$assocKey]['joinTable']));
  971. $dynamicWith = true;
  972. break;
  973. case 'joinTable':
  974. $tables = array($this->table, $this->{$class}->table);
  975. sort ($tables);
  976. $data = $tables[0] . '_' . $tables[1];
  977. break;
  978. case 'className':
  979. $data = $class;
  980. break;
  981. case 'unique':
  982. $data = true;
  983. break;
  984. }
  985. $this->{$type}[$assocKey][$key] = $data;
  986. }
  987. if ($dynamicWith) {
  988. $this->{$type}[$assocKey]['dynamicWith'] = true;
  989. }
  990. }
  991. }
  992. /**
  993. * Sets a custom table for your controller class. Used by your controller to select a database table.
  994. *
  995. * @param string $tableName Name of the custom table
  996. * @throws MissingTableException when database table $tableName is not found on data source
  997. * @return void
  998. */
  999. public function setSource($tableName) {
  1000. $this->setDataSource($this->useDbConfig);
  1001. $db = ConnectionManager::getDataSource($this->useDbConfig);
  1002. $db->cacheSources = ($this->cacheSources && $db->cacheSources);
  1003. if (method_exists($db, 'listSources')) {
  1004. $sources = $db->listSources();
  1005. if (is_array($sources) && !in_array(strtolower($this->tablePrefix . $tableName), array_map('strtolower', $sources))) {
  1006. throw new MissingTableException(array(
  1007. 'table' => $this->tablePrefix . $tableName,
  1008. 'class' => $this->alias,
  1009. 'ds' => $this->useDbConfig,
  1010. ));
  1011. }
  1012. $this->_schema = null;
  1013. }
  1014. $this->table = $this->useTable = $tableName;
  1015. $this->tableToModel[$this->table] = $this->alias;
  1016. }
  1017. /**
  1018. * This function does two things:
  1019. *
  1020. * 1. it scans the array $one for the primary key,
  1021. * and if that's found, it sets the current id to the value of $one[id].
  1022. * For all other keys than 'id' the keys and values of $one are copied to the 'data' property of this object.
  1023. * 2. Returns an array with all of $one's keys and values.
  1024. * (Alternative indata: two strings, which are mangled to
  1025. * a one-item, two-dimensional array using $one for a key and $two as its value.)
  1026. *
  1027. * @param mixed $one Array or string of data
  1028. * @param string $two Value string for the alternative indata method
  1029. * @return array Data with all of $one's keys and values
  1030. * @link http://book.cakephp.org/2.0/en/models/saving-your-data.html
  1031. */
  1032. public function set($one, $two = null) {
  1033. if (!$one) {
  1034. return;
  1035. }
  1036. if (is_object($one)) {
  1037. if ($one instanceof SimpleXMLElement || $one instanceof DOMNode) {
  1038. $one = $this->_normalizeXmlData(Xml::toArray($one));
  1039. } else {
  1040. $one = Set::reverse($one);
  1041. }
  1042. }
  1043. if (is_array($one)) {
  1044. $data = $one;
  1045. if (empty($one[$this->alias])) {
  1046. if ($this->getAssociated(key($one)) === null) {
  1047. $data = array($this->alias => $one);
  1048. }
  1049. }
  1050. } else {
  1051. $data = array($this->alias => array($one => $two));
  1052. }
  1053. foreach ($data as $modelName => $fieldSet) {
  1054. if (is_array($fieldSet)) {
  1055. foreach ($fieldSet as $fieldName => $fieldValue) {
  1056. if (isset($this->validationErrors[$fieldName])) {
  1057. unset ($this->validationErrors[$fieldName]);
  1058. }
  1059. if ($modelName === $this->alias) {
  1060. if ($fieldName === $this->primaryKey) {
  1061. $this->id = $fieldValue;
  1062. }
  1063. }
  1064. if (is_array($fieldValue) || is_object($fieldValue)) {
  1065. $fieldValue = $this->deconstruct($fieldName, $fieldValue);
  1066. }
  1067. $this->data[$modelName][$fieldName] = $fieldValue;
  1068. }
  1069. }
  1070. }
  1071. return $data;
  1072. }
  1073. /**
  1074. * Normalize Xml::toArray() to use in Model::save()
  1075. *
  1076. * @param array $xml XML as array
  1077. * @return array
  1078. */
  1079. protected function _normalizeXmlData(array $xml) {
  1080. $return = array();
  1081. foreach ($xml as $key => $value) {
  1082. if (is_array($value)) {
  1083. $return[Inflector::camelize($key)] = $this->_normalizeXmlData($value);
  1084. } elseif ($key[0] === '@') {
  1085. $return[substr($key, 1)] = $value;
  1086. } else {
  1087. $return[$key] = $value;
  1088. }
  1089. }
  1090. return $return;
  1091. }
  1092. /**
  1093. * Deconstructs a complex data type (array or object) into a single field value.
  1094. *
  1095. * @param string $field The name of the field to be deconstructed
  1096. * @param mixed $data An array or object to be deconstructed into a field
  1097. * @return mixed The resulting data that should be assigned to a field
  1098. */
  1099. public function deconstruct($field, $data) {
  1100. if (!is_array($data)) {
  1101. return $data;
  1102. }
  1103. $type = $this->getColumnType($field);
  1104. if (in_array($type, array('datetime', 'timestamp', 'date', 'time'))) {
  1105. $useNewDate = (isset($data['year']) || isset($data['month']) ||
  1106. isset($data['day']) || isset($data['hour']) || isset($data['minute']));
  1107. $dateFields = array('Y' => 'year', 'm' => 'month', 'd' => 'day', 'H' => 'hour', 'i' => 'min', 's' => 'sec');
  1108. $timeFields = array('H' => 'hour', 'i' => 'min', 's' => 'sec');
  1109. $date = array();
  1110. if (isset($data['meridian']) && empty($data['meridian'])) {
  1111. return null;
  1112. }
  1113. if (
  1114. isset($data['hour']) &&
  1115. isset($data['meridian']) &&
  1116. !empty($data['hour']) &&
  1117. $data['hour'] != 12 &&
  1118. 'pm' == $data['meridian']
  1119. ) {
  1120. $data['hour'] = $data['hour'] + 12;
  1121. }
  1122. if (isset($data['hour']) && isset($data['meridian']) && $data['hour'] == 12 && 'am' == $data['meridian']) {
  1123. $data['hour'] = '00';
  1124. }
  1125. if ($type == 'time') {
  1126. foreach ($timeFields as $key => $val) {
  1127. if (!isset($data[$val]) || $data[$val] === '0' || $data[$val] === '00') {
  1128. $data[$val] = '00';
  1129. } elseif ($data[$val] !== '') {
  1130. $data[$val] = sprintf('%02d', $data[$val]);
  1131. }
  1132. if (!empty($data[$val])) {
  1133. $date[$key] = $data[$val];
  1134. } else {
  1135. return null;
  1136. }
  1137. }
  1138. }
  1139. if ($type == 'datetime' || $type == 'timestamp' || $type == 'date') {
  1140. foreach ($dateFields as $key => $val) {
  1141. if ($val == 'hour' || $val == 'min' || $val == 'sec') {
  1142. if (!isset($data[$val]) || $data[$val] === '0' || $data[$val] === '00') {
  1143. $data[$val] = '00';
  1144. } else {
  1145. $data[$val] = sprintf('%02d', $data[$val]);
  1146. }
  1147. }
  1148. if (!isset($data[$val]) || isset($data[$val]) && (empty($data[$val]) || $data[$val][0] === '-')) {
  1149. return null;
  1150. }
  1151. if (isset($data[$val]) && !empty($data[$val])) {
  1152. $date[$key] = $data[$val];
  1153. }
  1154. }
  1155. }
  1156. if ($useNewDate && !empty($date)) {
  1157. $format = $this->getDataSource()->columns[$type]['format'];
  1158. foreach (array('m', 'd', 'H', 'i', 's') as $index) {
  1159. if (isset($date[$index])) {
  1160. $date[$index] = sprintf('%02d', $date[$index]);
  1161. }
  1162. }
  1163. return str_replace(array_keys($date), array_values($date), $format);
  1164. }
  1165. }
  1166. return $data;
  1167. }
  1168. /**
  1169. * Returns an array of table metadata (column names and types) from the database.
  1170. * $field => keys(type, null, default, key, length, extra)
  1171. *
  1172. * @param mixed $field Set to true to reload schema, or a string to return a specific field
  1173. * @return array Array of table metadata
  1174. */
  1175. public function schema($field = false) {
  1176. if ($this->useTable !== false && (!is_array($this->_schema) || $field === true)) {
  1177. $db = $this->getDataSource();
  1178. $db->cacheSources = ($this->cacheSources && $db->cacheSources);
  1179. if (method_exists($db, 'describe') && $this->useTable !== false) {
  1180. $this->_schema = $db->describe($this);
  1181. } elseif ($this->useTable === false) {
  1182. $this->_schema = array();
  1183. }
  1184. }
  1185. if (is_string($field)) {
  1186. if (isset($this->_schema[$field])) {
  1187. return $this->_schema[$field];
  1188. } else {
  1189. return null;
  1190. }
  1191. }
  1192. return $this->_schema;
  1193. }
  1194. /**
  1195. * Returns an associative array of field names and column types.
  1196. *
  1197. * @return array Field types indexed by field name
  1198. */
  1199. public function getColumnTypes() {
  1200. $columns = $this->schema();
  1201. if (empty($columns)) {
  1202. trigger_error(__d('cake_dev', '(Model::getColumnTypes) Unable to build model field data. If you are using a model without a database table, try implementing schema()'), E_USER_WARNING);
  1203. }
  1204. $cols = array();
  1205. foreach ($columns as $field => $values) {
  1206. $cols[$field] = $values['type'];
  1207. }
  1208. return $cols;
  1209. }
  1210. /**
  1211. * Returns the column type of a column in the model.
  1212. *
  1213. * @param string $column The name of the model column
  1214. * @return string Column type
  1215. */
  1216. public function getColumnType($column) {
  1217. $db = $this->getDataSource();
  1218. $cols = $this->schema();
  1219. $model = null;
  1220. $startQuote = isset($db->startQuote) ? $db->startQuote : null;
  1221. $endQuote = isset($db->endQuote) ? $db->endQuote : null;
  1222. $column = str_replace(array($startQuote, $endQuote), '', $column);
  1223. if (strpos($column, '.')) {
  1224. list($model, $column) = explode('.', $column);
  1225. }
  1226. if ($model != $this->alias && isset($this->{$model})) {
  1227. return $this->{$model}->getColumnType($column);
  1228. }
  1229. if (isset($cols[$column]) && isset($cols[$column]['type'])) {
  1230. return $cols[$column]['type'];
  1231. }
  1232. return null;
  1233. }
  1234. /**
  1235. * Returns true if the supplied field exists in the model's database table.
  1236. *
  1237. * @param mixed $name Name of field to look for, or an array of names
  1238. * @param boolean $checkVirtual checks if the field is declared as virtual
  1239. * @return mixed If $name is a string, returns a boolean indicating whether the field exists.
  1240. * If $name is an array of field names, returns the first field that exists,
  1241. * or false if none exist.
  1242. */
  1243. public function hasField($name, $checkVirtual = false) {
  1244. if (is_array($name)) {
  1245. foreach ($name as $n) {
  1246. if ($this->hasField($n, $checkVirtual)) {
  1247. return $n;
  1248. }
  1249. }
  1250. return false;
  1251. }
  1252. if ($checkVirtual && !empty($this->virtualFields)) {
  1253. if ($this->isVirtualField($name)) {
  1254. return true;
  1255. }
  1256. }
  1257. if (empty($this->_schema)) {
  1258. $this->schema();
  1259. }
  1260. if ($this->_schema != null) {
  1261. return isset($this->_schema[$name]);
  1262. }
  1263. return false;
  1264. }
  1265. /**
  1266. * Check that a method is callable on a model. This will check both the model's own methods, its
  1267. * inherited methods and methods that could be callable through behaviors.
  1268. *
  1269. * @param string $method The method to be called.
  1270. * @return boolean True on method being callable.
  1271. */
  1272. public function hasMethod($method) {
  1273. if (method_exists($this, $method)) {
  1274. return true;
  1275. }
  1276. if ($this->Behaviors->hasMethod($method)) {
  1277. return true;
  1278. }
  1279. return false;
  1280. }
  1281. /**
  1282. * Returns true if the supplied field is a model Virtual Field
  1283. *
  1284. * @param string $field Name of field to look for
  1285. * @return boolean indicating whether the field exists as a model virtual field.
  1286. */
  1287. public function isVirtualField($field) {
  1288. if (empty($this->virtualFields) || !is_string($field)) {
  1289. return false;
  1290. }
  1291. if (isset($this->virtualFields[$field])) {
  1292. return true;
  1293. }
  1294. if (strpos($field, '.') !== false) {
  1295. list($model, $field) = explode('.', $field);
  1296. if ($model == $this->alias && isset($this->virtualFields[$field])) {
  1297. return true;
  1298. }
  1299. }
  1300. return false;
  1301. }
  1302. /**
  1303. * Returns the expression for a model virtual field
  1304. *
  1305. * @param string $field Name of field to look for
  1306. * @return mixed If $field is string expression bound to virtual field $field
  1307. * If $field is null, returns an array of all model virtual fields
  1308. * or false if none $field exist.
  1309. */
  1310. public function getVirtualField($field = null) {
  1311. if ($field == null) {
  1312. return empty($this->virtualFields) ? false : $this->virtualFields;
  1313. }
  1314. if ($this->isVirtualField($field)) {
  1315. if (strpos($field, '.') !== false) {
  1316. list($model, $field) = explode('.', $field);
  1317. }
  1318. return $this->virtualFields[$field];
  1319. }
  1320. return false;
  1321. }
  1322. /**
  1323. * Initializes the model for writing a new record, loading the default values
  1324. * for those fields that are not defined in $data, and clearing previous validation errors.
  1325. * Especially helpful for saving data in loops.
  1326. *
  1327. * @param mixed $data Optional data array to assign to the model after it is created. If null or false,
  1328. * schema data defaults are not merged.
  1329. * @param boolean $filterKey If true, overwrites any primary key input with an empty value
  1330. * @return array The current Model::data; after merging $data and/or defaults from database
  1331. * @link http://book.cakephp.org/2.0/en/models/saving-your-data.html#model-create-array-data-array
  1332. */
  1333. public function create($data = array(), $filterKey = false) {
  1334. $defaults = array();
  1335. $this->id = false;
  1336. $this->data = array();
  1337. $this->validationErrors = array();
  1338. if ($data !== null && $data !== false) {
  1339. foreach ($this->schema() as $field => $properties) {
  1340. if ($this->primaryKey !== $field && isset($properties['default']) && $properties['default'] !== '') {
  1341. $defaults[$field] = $properties['default'];
  1342. }
  1343. }
  1344. $this->set($defaults);
  1345. $this->set($data);
  1346. }
  1347. if ($filterKey) {
  1348. $this->set($this->primaryKey, false);
  1349. }
  1350. return $this->data;
  1351. }
  1352. /**
  1353. * Returns a list of fields from the database, and sets the current model
  1354. * data (Model::$data) with the record found.
  1355. *
  1356. * @param mixed $fields String of single field name, or an array of field names.
  1357. * @param mixed $id The ID of the record to read
  1358. * @return array Array of database fields, or false if not found
  1359. * @link http://book.cakephp.org/2.0/en/models/retrieving-your-data.html#model-read
  1360. */
  1361. public function read($fields = null, $id = null) {
  1362. $this->validationErrors = array();
  1363. if ($id != null) {
  1364. $this->id = $id;
  1365. }
  1366. $id = $this->id;
  1367. if (is_array($this->id)) {
  1368. $id = $this->id[0];
  1369. }
  1370. if ($id !== null && $id !== false) {
  1371. $this->data = $this->find('first', array(
  1372. 'conditions' => array($this->alias . '.' . $this->primaryKey => $id),
  1373. 'fields' => $fields
  1374. ));
  1375. return $this->data;
  1376. } else {
  1377. return false;
  1378. }
  1379. }
  1380. /**
  1381. * Returns the contents of a single field given the supplied conditions, in the
  1382. * supplied order.
  1383. *
  1384. * @param string $name Name of field to get
  1385. * @param array $conditions SQL conditions (defaults to NULL)
  1386. * @param string $order SQL ORDER BY fragment
  1387. * @return string field contents, or false if not found
  1388. * @link http://book.cakephp.org/2.0/en/models/retrieving-your-data.html#model-field
  1389. */
  1390. public function field($name, $conditions = null, $order = null) {
  1391. if ($conditions === null && $this->id !== false) {
  1392. $conditions = array($this->alias . '.' . $this->primaryKey => $this->id);
  1393. }
  1394. if ($this->recursive >= 1) {
  1395. $recursive = -1;
  1396. } else {
  1397. $recursive = $this->recursive;
  1398. }
  1399. $fields = $name;
  1400. if ($data = $this->find('first', compact('conditions', 'fields', 'order', 'recursive'))) {
  1401. if (strpos($name, '.') === false) {
  1402. if (isset($data[$this->alias][$name])) {
  1403. return $data[$this->alias][$name];
  1404. }
  1405. } else {
  1406. $name = explode('.', $name);
  1407. if (isset($data[$name[0]][$name[1]])) {
  1408. return $data[$name[0]][$name[1]];
  1409. }
  1410. }
  1411. if (isset($data[0]) && count($data[0]) > 0) {
  1412. return array_shift($data[0]);
  1413. }
  1414. } else {
  1415. return false;
  1416. }
  1417. }
  1418. /**
  1419. * Saves the value of a single field to the database, based on the current
  1420. * model ID.
  1421. *
  1422. * @param string $name Name of the table field
  1423. * @param mixed $value Value of the field
  1424. * @param array $validate See $options param in Model::save(). Does not respect 'fieldList' key if passed
  1425. * @return boolean See Model::save()
  1426. * @see Model::save()
  1427. * @link http://book.cakephp.org/2.0/en/models/saving-your-data.html#model-savefield-string-fieldname-string-fieldvalue-validate-false
  1428. */
  1429. public function saveField($name, $value, $validate = false) {
  1430. $id = $this->id;
  1431. $this->create(false);
  1432. if (is_array($validate)) {
  1433. $options = array_merge(array('validate' => false, 'fieldList' => array($name)), $validate);
  1434. } else {
  1435. $options = array('validate' => $validate, 'fieldList' => array($name));
  1436. }
  1437. return $this->save(array($this->alias => array($this->primaryKey => $id, $name => $value)), $options);
  1438. }
  1439. /**
  1440. * Saves model data (based on white-list, if supplied) to the database. By
  1441. * default, validation occurs before save.
  1442. *
  1443. * @param array $data Data to save.
  1444. * @param mixed $validate Either a boolean, or an array.
  1445. * If a boolean, indicates whether or not to validate before saving.
  1446. * If an array, allows control of validate, callbacks, and fieldList
  1447. * @param array $fieldList List of fields to allow to be written
  1448. * @return mixed On success Model::$data if its not empty or true, false on failure
  1449. * @link http://book.cakephp.org/2.0/en/models/saving-your-data.html
  1450. */
  1451. public function save($data = null, $validate = true, $fieldList = array()) {
  1452. $defaults = array('validate' => true, 'fieldList' => array(), 'callbacks' => true);
  1453. $_whitelist = $this->whitelist;
  1454. $fields = array();
  1455. if (!is_array($validate)) {
  1456. $options = array_merge($defaults, compact('validate', 'fieldList', 'callbacks'));
  1457. } else {
  1458. $options = array_merge($defaults, $validate);
  1459. }
  1460. if (!empty($options['fieldList'])) {
  1461. if (!empty($options['fieldList'][$this->alias]) && is_array($options['fieldList'][$this->alias])) {
  1462. $this->whitelist = $options['fieldList'][$this->alias];
  1463. } else {
  1464. $this->whitelist = $options['fieldList'];
  1465. }
  1466. } elseif ($options['fieldList'] === null) {
  1467. $this->whitelist = array();
  1468. }
  1469. $this->set($data);
  1470. if (empty($this->data) && !$this->hasField(array('created', 'updated', 'modified'))) {
  1471. return false;
  1472. }
  1473. foreach (array('created', 'updated', 'modified') as $field) {
  1474. $keyPresentAndEmpty = (
  1475. isset($this->data[$this->alias]) &&
  1476. array_key_exists($field, $this->data[$this->alias]) &&
  1477. $this->data[$this->alias][$field] === null
  1478. );
  1479. if ($keyPresentAndEmpty) {
  1480. unset($this->data[$this->alias][$field]);
  1481. }
  1482. }
  1483. $exists = $this->exists();
  1484. $dateFields = array('modified', 'updated');
  1485. if (!$exists) {
  1486. $dateFields[] = 'created';
  1487. }
  1488. if (isset($this->data[$this->alias])) {
  1489. $fields = array_keys($this->data[$this->alias]);
  1490. }
  1491. if ($options['validate'] && !$this->validates($options)) {
  1492. $this->whitelist = $_whitelist;
  1493. return false;
  1494. }
  1495. $db = $this->getDataSource();
  1496. foreach ($dateFields as $updateCol) {
  1497. if ($this->hasField($updateCol) && !in_array($updateCol, $fields)) {
  1498. $default = array('formatter' => 'date');
  1499. $colType = array_merge($default, $db->columns[$this->getColumnType($updateCol)]);
  1500. if (!array_key_exists('format', $colType)) {
  1501. $time = strtotime('now');
  1502. } else {
  1503. $time = call_user_func($colType['formatter'], $colType['format']);
  1504. }
  1505. if (!empty($this->whitelist)) {
  1506. $this->whitelist[] = $updateCol;
  1507. }
  1508. $this->set($updateCol, $time);
  1509. }
  1510. }
  1511. if ($options['callbacks'] === true || $options['callbacks'] === 'before') {
  1512. $event = new CakeEvent('Model.beforeSave', $this, array($options));
  1513. list($event->break, $event->breakOn) = array(true, array(false, null));
  1514. $this->getEventManager()->dispatch($event);
  1515. if (!$event->result) {
  1516. $this->whitelist = $_whitelist;
  1517. return false;
  1518. }
  1519. }
  1520. if (empty($this->data[$this->alias][$this->primaryKey])) {
  1521. unset($this->data[$this->alias][$this->primaryKey]);
  1522. }
  1523. $fields = $values = array();
  1524. foreach ($this->data as $n => $v) {
  1525. if (isset($this->hasAndBelongsToMany[$n])) {
  1526. if (isset($v[$n])) {
  1527. $v = $v[$n];
  1528. }
  1529. $joined[$n] = $v;
  1530. } else {
  1531. if ($n === $this->alias) {
  1532. foreach (array('created', 'updated', 'modified') as $field) {
  1533. if (array_key_exists($field, $v) && empty($v[$field])) {
  1534. unset($v[$field]);
  1535. }
  1536. }
  1537. foreach ($v as $x => $y) {
  1538. if ($this->hasField($x) && (empty($this->whitelist) || in_array($x, $this->whitelist))) {
  1539. list($fields[], $values[]) = array($x, $y);
  1540. }
  1541. }
  1542. }
  1543. }
  1544. }
  1545. $count = count($fields);
  1546. if (!$exists && $count > 0) {
  1547. $this->id = false;
  1548. }
  1549. $success = true;
  1550. $created = false;
  1551. if ($count > 0) {
  1552. $cache = $this->_prepareUpdateFields(array_combine($fields, $values));
  1553. if (!empty($this->id)) {
  1554. $success = (bool)$db->update($this, $fields, $values);
  1555. } else {
  1556. $fInfo = $this->schema($this->primaryKey);
  1557. $isUUID = ($fInfo['length'] == 36 &&
  1558. ($fInfo['type'] === 'string' || $fInfo['type'] === 'binary')
  1559. );
  1560. if (empty($this->data[$this->alias][$this->primaryKey]) && $isUUID) {
  1561. if (array_key_exists($this->primaryKey, $this->data[$this->alias])) {
  1562. $j = array_search($this->primaryKey, $fields);
  1563. $values[$j] = String::uuid();
  1564. } else {
  1565. list($fields[], $values[]) = array($this->primaryKey, String::uuid());
  1566. }
  1567. }
  1568. if (!$db->create($this, $fields, $values)) {
  1569. $success = $created = false;
  1570. } else {
  1571. $created = true;
  1572. }
  1573. }
  1574. if ($success && !empty($this->belongsTo)) {
  1575. $this->updateCounterCache($cache, $created);
  1576. }
  1577. }
  1578. if (!empty($joined) && $success === true) {
  1579. $this->_saveMulti($joined, $this->id, $db);
  1580. }
  1581. if ($success && $count > 0) {
  1582. if (!empty($this->data)) {
  1583. $success = $this->data;
  1584. if ($created) {
  1585. $this->data[$this->alias][$this->primaryKey] = $this->id;
  1586. }
  1587. }
  1588. if ($options['callbacks'] === true || $options['callbacks'] === 'after') {
  1589. $event = new CakeEvent('Model.afterSave', $this, array($created, $options));
  1590. $this->getEventManager()->dispatch($event);
  1591. }
  1592. if (!empty($this->data)) {
  1593. $success = Hash::merge($success, $this->data);
  1594. }
  1595. $this->data = false;
  1596. $this->_clearCache();
  1597. $this->validationErrors = array();
  1598. }
  1599. $this->whitelist = $_whitelist;
  1600. return $success;
  1601. }
  1602. /**
  1603. * Saves model hasAndBelongsToMany data to the database.
  1604. *
  1605. * @param array $joined Data to save
  1606. * @param mixed $id ID of record in this model
  1607. * @param DataSource $db
  1608. * @return void
  1609. */
  1610. protected function _saveMulti($joined, $id, $db) {
  1611. foreach ($joined as $assoc => $data) {
  1612. if (isset($this->hasAndBelongsToMany[$assoc])) {
  1613. list($join) = $this->joinModel($this->hasAndBelongsToMany[$assoc]['with']);
  1614. $keyInfo = $this->{$join}->schema($this->{$join}->primaryKey);
  1615. if ($with = $this->hasAndBelongsToMany[$assoc]['with']) {
  1616. $withModel = is_array($with) ? key($with) : $with;
  1617. list($pluginName, $withModel) = pluginSplit($withModel);
  1618. $dbMulti = $this->{$withModel}->getDataSource();
  1619. } else {
  1620. $dbMulti = $db;
  1621. }
  1622. $isUUID = !empty($this->{$join}->primaryKey) && (
  1623. $keyInfo['length'] == 36 && (
  1624. $keyInfo['type'] === 'string' ||
  1625. $keyInfo['type'] === 'binary'
  1626. )
  1627. );
  1628. $newData = $newValues = $newJoins = array();
  1629. $primaryAdded = false;
  1630. $fields = array(
  1631. $dbMulti->name($this->hasAndBelongsToMany[$assoc]['foreignKey']),
  1632. $dbMulti->name($this->hasAndBelongsToMany[$assoc]['associationForeignKey'])
  1633. );
  1634. $idField = $db->name($this->{$join}->primaryKey);
  1635. if ($isUUID && !in_array($idField, $fields)) {
  1636. $fields[] = $idField;
  1637. $primaryAdded = true;
  1638. }
  1639. foreach ((array)$data as $row) {
  1640. if ((is_string($row) && (strlen($row) == 36 || strlen($row) == 16)) || is_numeric($row)) {
  1641. $newJoins[] = $row;
  1642. $values = array($id, $row);
  1643. if ($isUUID && $primaryAdded) {
  1644. $values[] = String::uuid();
  1645. }
  1646. $newValues[$row] = $values;
  1647. unset($values);
  1648. } elseif (isset($row[$this->hasAndBelongsToMany[$assoc]['associationForeignKey']])) {
  1649. if (!empty($row[$this->{$join}->primaryKey])) {
  1650. $newJoins[] = $row[$this->hasAndBelongsToMany[$assoc]['associationForeignKey']];
  1651. }
  1652. $newData[] = $row;
  1653. } elseif (isset($row[$join]) && isset($row[$join][$this->hasAndBelongsToMany[$assoc]['associationForeignKey']])) {
  1654. if (!empty($row[$join][$this->{$join}->primaryKey])) {
  1655. $newJoins[] = $row[$join][$this->hasAndBelongsToMany[$assoc]['associationForeignKey']];
  1656. }
  1657. $newData[] = $row[$join];
  1658. }
  1659. }
  1660. $keepExisting = $this->hasAndBelongsToMany[$assoc]['unique'] === 'keepExisting';
  1661. if ($this->hasAndBelongsToMany[$assoc]['unique']) {
  1662. $conditions = array(
  1663. $join . '.' . $this->hasAndBelongsToMany[$assoc]['foreignKey'] => $id
  1664. );
  1665. if (!empty($this->hasAndBelongsToMany[$assoc]['conditions'])) {
  1666. $conditions = array_merge($conditions, (array)$this->hasAndBelongsToMany[$assoc]['conditions']);
  1667. }
  1668. $associationForeignKey = $this->{$join}->alias . '.' . $this->hasAndBelongsToMany[$assoc]['associationForeignKey'];
  1669. $links = $this->{$join}->find('all', array(
  1670. 'conditions' => $conditions,
  1671. 'recursive' => empty($this->hasAndBelongsToMany[$assoc]['conditions']) ? -1 : 0,
  1672. 'fields' => $associationForeignKey,
  1673. ));
  1674. $oldLinks = Hash::extract($links, "{n}.{$associationForeignKey}");
  1675. if (!empty($oldLinks)) {
  1676. if ($keepExisting && !empty($newJoins)) {
  1677. $conditions[$associationForeignKey] = array_diff($oldLinks, $newJoins);
  1678. } else {
  1679. $conditions[$associationForeignKey] = $oldLinks;
  1680. }
  1681. $dbMulti->delete($this->{$join}, $conditions);
  1682. }
  1683. }
  1684. if (!empty($newData)) {
  1685. foreach ($newData as $data) {
  1686. $data[$this->hasAndBelongsToMany[$assoc]['foreignKey']] = $id;
  1687. if (empty($data[$this->{$join}->primaryKey])) {
  1688. $this->{$join}->create();
  1689. }
  1690. $this->{$join}->save($data);
  1691. }
  1692. }
  1693. if (!empty($newValues)) {
  1694. if ($keepExisting && !empty($links)) {
  1695. foreach ($links as $link) {
  1696. $oldJoin = $link[$join][$this->hasAndBelongsToMany[$assoc]['associationForeignKey']];
  1697. if (! in_array($oldJoin, $newJoins) ) {
  1698. $conditions[$associationForeignKey] = $oldJoin;
  1699. $db->delete($this->{$join}, $conditions);
  1700. } else {
  1701. unset($newValues[$oldJoin]);
  1702. }
  1703. }
  1704. $newValues = array_values($newValues);
  1705. }
  1706. if (!empty($newValues)) {
  1707. $dbMulti->insertMulti($this->{$join}, $fields, $newValues);
  1708. }
  1709. }
  1710. }
  1711. }
  1712. }
  1713. /**
  1714. * Updates the counter cache of belongsTo associations after a save or delete operation
  1715. *
  1716. * @param array $keys Optional foreign key data, defaults to the information $this->data
  1717. * @param boolean $created True if a new record was created, otherwise only associations with
  1718. * 'counterScope' defined get updated
  1719. * @return void
  1720. */
  1721. public function updateCounterCache($keys = array(), $created = false) {
  1722. $keys = empty($keys) ? $this->data[$this->alias] : $keys;
  1723. $keys['old'] = isset($keys['old']) ? $keys['old'] : array();
  1724. foreach ($this->belongsTo as $parent => $assoc) {
  1725. if (!empty($assoc['counterCache'])) {
  1726. if (!is_array($assoc['counterCache'])) {
  1727. if (isset($assoc['counterScope'])) {
  1728. $assoc['counterCache'] = array($assoc['counterCache'] => $assoc['counterScope']);
  1729. } else {
  1730. $assoc['counterCache'] = array($assoc['counterCache'] => array());
  1731. }
  1732. }
  1733. $foreignKey = $assoc['foreignKey'];
  1734. $fkQuoted = $this->escapeField($assoc['foreignKey']);
  1735. foreach ($assoc['counterCache'] as $field => $conditions) {
  1736. if (!is_string($field)) {
  1737. $field = Inflector::underscore($this->alias) . '_count';
  1738. }
  1739. if (!$this->{$parent}->hasField($field)) {
  1740. continue;
  1741. }
  1742. if ($conditions === true) {
  1743. $conditions = array();
  1744. } else {
  1745. $conditions = (array)$conditions;
  1746. }
  1747. if (!array_key_exists($foreignKey, $keys)) {
  1748. $keys[$foreignKey] = $this->field($foreignKey);
  1749. }
  1750. $recursive = (empty($conditions) ? -1 : 0);
  1751. if (isset($keys['old'][$foreignKey])) {
  1752. if ($keys['old'][$foreignKey] != $keys[$foreignKey]) {
  1753. $conditions[$fkQuoted] = $keys['old'][$foreignKey];
  1754. $count = intval($this->find('count', compact('conditions', 'recursive')));
  1755. $this->{$parent}->updateAll(
  1756. array($field => $count),
  1757. array($this->{$parent}->escapeField() => $keys['old'][$foreignKey])
  1758. );
  1759. }
  1760. }
  1761. $conditions[$fkQuoted] = $keys[$foreignKey];
  1762. if ($recursive === 0) {
  1763. $conditions = array_merge($conditions, (array)$conditions);
  1764. }
  1765. $count = intval($this->find('count', compact('conditions', 'recursive')));
  1766. $this->{$parent}->updateAll(
  1767. array($field => $count),
  1768. array($this->{$parent}->escapeField() => $keys[$foreignKey])
  1769. );
  1770. }
  1771. }
  1772. }
  1773. }
  1774. /**
  1775. * Helper method for Model::updateCounterCache(). Checks the fields to be updated for
  1776. *
  1777. * @param array $data The fields of the record that will be updated
  1778. * @return array Returns updated foreign key values, along with an 'old' key containing the old
  1779. * values, or empty if no foreign keys are updated.
  1780. */
  1781. protected function _prepareUpdateFields($data) {
  1782. $foreignKeys = array();
  1783. foreach ($this->belongsTo as $assoc => $info) {
  1784. if ($info['counterCache']) {
  1785. $foreignKeys[$assoc] = $info['foreignKey'];
  1786. }
  1787. }
  1788. $included = array_intersect($foreignKeys, array_keys($data));
  1789. if (empty($included) || empty($this->id)) {
  1790. return array();
  1791. }
  1792. $old = $this->find('first', array(
  1793. 'conditions' => array($this->alias . '.' . $this->primaryKey => $this->id),
  1794. 'fields' => array_values($included),
  1795. 'recursive' => -1
  1796. ));
  1797. return array_merge($data, array('old' => $old[$this->alias]));
  1798. }
  1799. /**
  1800. * Backwards compatible passthrough method for:
  1801. * saveMany(), validateMany(), saveAssociated() and validateAssociated()
  1802. *
  1803. * Saves multiple individual records for a single model; Also works with a single record, as well as
  1804. * all its associated records.
  1805. *
  1806. * #### Options
  1807. *
  1808. * - validate: Set to false to disable validation, true to validate each record before saving,
  1809. * 'first' to validate *all* records before any are saved (default),
  1810. * or 'only' to only validate the records, but not save them.
  1811. * - atomic: If true (default), will attempt to save all records in a single transaction.
  1812. * Should be set to false if database/table does not support transactions.
  1813. * - fieldList: Equivalent to the $fieldList parameter in Model::save().
  1814. * It should be an associate array with model name as key and array of fields as value. Eg.
  1815. * {{{
  1816. * array(
  1817. * 'SomeModel' => array('field'),
  1818. * 'AssociatedModel' => array('field', 'otherfield')
  1819. * )
  1820. * }}}
  1821. * - deep: see saveMany/saveAssociated
  1822. *
  1823. * @param array $data Record data to save. This can be either a numerically-indexed array (for saving multiple
  1824. * records of the same type), or an array indexed by association name.
  1825. * @param array $options Options to use when saving record data, See $options above.
  1826. * @return mixed If atomic: True on success, or false on failure.
  1827. * Otherwise: array similar to the $data array passed, but values are set to true/false
  1828. * depending on whether each record saved successfully.
  1829. * @link http://book.cakephp.org/2.0/en/models/saving-your-data.html#model-saveassociated-array-data-null-array-options-array
  1830. * @link http://book.cakephp.org/2.0/en/models/saving-your-data.html#model-saveall-array-data-null-array-options-array
  1831. */
  1832. public function saveAll($data = null, $options = array()) {
  1833. $options = array_merge(array('validate' => 'first'), $options);
  1834. if (Hash::numeric(array_keys($data))) {
  1835. if ($options['validate'] === 'only') {
  1836. return $this->validateMany($data, $options);
  1837. }
  1838. return $this->saveMany($data, $options);
  1839. }
  1840. if ($options['validate'] === 'only') {
  1841. return $this->validateAssociated($data, $options);
  1842. }
  1843. return $this->saveAssociated($data, $options);
  1844. }
  1845. /**
  1846. * Saves multiple individual records for a single model
  1847. *
  1848. * #### Options
  1849. *
  1850. * - validate: Set to false to disable validation, true to validate each record before saving,
  1851. * 'first' to validate *all* records before any are saved (default),
  1852. * - atomic: If true (default), will attempt to save all records in a single transaction.
  1853. * Should be set to false if database/table does not support transactions.
  1854. * - fieldList: Equivalent to the $fieldList parameter in Model::save()
  1855. * - deep: If set to true, all associated data will be saved as well.
  1856. *
  1857. * @param array $data Record data to save. This should be a numerically-indexed array
  1858. * @param array $options Options to use when saving record data, See $options above.
  1859. * @return mixed If atomic: True on success, or false on failure.
  1860. * Otherwise: array similar to the $data array passed, but values are set to true/false
  1861. * depending on whether each record saved successfully.
  1862. * @link http://book.cakephp.org/2.0/en/models/saving-your-data.html#model-savemany-array-data-null-array-options-array
  1863. */
  1864. public function saveMany($data = null, $options = array()) {
  1865. if (empty($data)) {
  1866. $data = $this->data;
  1867. }
  1868. $options = array_merge(array('validate' => 'first', 'atomic' => true, 'deep' => false), $options);
  1869. $this->validationErrors = $validationErrors = array();
  1870. if (empty($data) && $options['validate'] !== false) {
  1871. $result = $this->save($data, $options);
  1872. if (!$options['atomic']) {
  1873. return array(!empty($result));
  1874. }
  1875. return !empty($result);
  1876. }
  1877. if ($options['validate'] === 'first') {
  1878. $validates = $this->validateMany($data, $options);
  1879. if ((!$validates && $options['atomic']) || (!$options['atomic'] && in_array(false, $validates, true))) {
  1880. return $validates;
  1881. }
  1882. $options['validate'] = false;
  1883. }
  1884. if ($options['atomic']) {
  1885. $db = $this->getDataSource();
  1886. $transactionBegun = $db->begin();
  1887. }
  1888. $return = array();
  1889. foreach ($data as $key => $record) {
  1890. $validates = $this->create(null) !== null;
  1891. $saved = false;
  1892. if ($validates) {
  1893. if ($options['deep']) {
  1894. $saved = $this->saveAssociated($record, array_merge($options, array('atomic' => false)));
  1895. } else {
  1896. $saved = $this->save($record, $options);
  1897. }
  1898. }
  1899. $validates = ($validates && ($saved === true || (is_array($saved) && !in_array(false, $saved, true))));
  1900. if (!$validates) {
  1901. $validationErrors[$key] = $this->validationErrors;
  1902. }
  1903. if (!$options['atomic']) {
  1904. $return[$key] = $validates;
  1905. } elseif (!$validates) {
  1906. break;
  1907. }
  1908. }
  1909. $this->validationErrors = $validationErrors;
  1910. if (!$options['atomic']) {
  1911. return $return;
  1912. }
  1913. if ($validates) {
  1914. if ($transactionBegun) {
  1915. return $db->commit() !== false;
  1916. } else {
  1917. return true;
  1918. }
  1919. }
  1920. $db->rollback();
  1921. return false;
  1922. }
  1923. /**
  1924. * Validates multiple individual records for a single model
  1925. *
  1926. * #### Options
  1927. *
  1928. * - atomic: If true (default), returns boolean. If false returns array.
  1929. * - fieldList: Equivalent to the $fieldList parameter in Model::save()
  1930. * - deep: If set to true, all associated data will be validated as well.
  1931. *
  1932. * Warning: This method could potentially change the passed argument `$data`,
  1933. * If you do not want this to happen, make a copy of `$data` before passing it
  1934. * to this method
  1935. *
  1936. * @param array $data Record data to validate. This should be a numerically-indexed array
  1937. * @param array $options Options to use when validating record data (see above), See also $options of validates().
  1938. * @return boolean True on success, or false on failure.
  1939. * @return mixed If atomic: True on success, or false on failure.
  1940. * Otherwise: array similar to the $data array passed, but values are set to true/false
  1941. * depending on whether each record validated successfully.
  1942. */
  1943. public function validateMany(&$data, $options = array()) {
  1944. return $this->validator()->validateMany($data, $options);
  1945. }
  1946. /**
  1947. * Saves a single record, as well as all its directly associated records.
  1948. *
  1949. * #### Options
  1950. *
  1951. * - `validate` Set to `false` to disable validation, `true` to validate each record before saving,
  1952. * 'first' to validate *all* records before any are saved(default),
  1953. * - `atomic` If true (default), will attempt to save all records in a single transaction.
  1954. * Should be set to false if database/table does not support transactions.
  1955. * - fieldList: Equivalent to the $fieldList parameter in Model::save().
  1956. * It should be an associate array with model name as key and array of fields as value. Eg.
  1957. * {{{
  1958. * array(
  1959. * 'SomeModel' => array('field'),
  1960. * 'AssociatedModel' => array('field', 'otherfield')
  1961. * )
  1962. * }}}
  1963. * - deep: If set to true, not only directly associated data is saved, but deeper nested associated data as well.
  1964. *
  1965. * @param array $data Record data to save. This should be an array indexed by association name.
  1966. * @param array $options Options to use when saving record data, See $options above.
  1967. * @return mixed If atomic: True on success, or false on failure.
  1968. * Otherwise: array similar to the $data array passed, but values are set to true/false
  1969. * depending on whether each record saved successfully.
  1970. * @link http://book.cakephp.org/2.0/en/models/saving-your-data.html#model-saveassociated-array-data-null-array-options-array
  1971. */
  1972. public function saveAssociated($data = null, $options = array()) {
  1973. if (empty($data)) {
  1974. $data = $this->data;
  1975. }
  1976. $options = array_merge(array('validate' => 'first', 'atomic' => true, 'deep' => false), $options);
  1977. $this->validationErrors = $validationErrors = array();
  1978. if (empty($data) && $options['validate'] !== false) {
  1979. $result = $this->save($data, $options);
  1980. if (!$options['atomic']) {
  1981. return array(!empty($result));
  1982. }
  1983. return !empty($result);
  1984. }
  1985. if ($options['validate'] === 'first') {
  1986. $validates = $this->validateAssociated($data, $options);
  1987. if ((!$validates && $options['atomic']) || (!$options['atomic'] && in_array(false, $validates, true))) {
  1988. return $validates;
  1989. }
  1990. $options['validate'] = false;
  1991. }
  1992. if ($options['atomic']) {
  1993. $db = $this->getDataSource();
  1994. $transactionBegun = $db->begin();
  1995. }
  1996. $associations = $this->getAssociated();
  1997. $return = array();
  1998. $validates = true;
  1999. foreach ($data as $association => $values) {
  2000. $notEmpty = !empty($values[$association]) || (!isset($values[$association]) && !empty($values));
  2001. if (isset($associations[$association]) && $associations[$association] === 'belongsTo' && $notEmpty) {
  2002. $validates = $this->{$association}->create(null) !== null;
  2003. $saved = false;
  2004. if ($validates) {
  2005. if ($options['deep']) {
  2006. $saved = $this->{$association}->saveAssociated($values, array_merge($options, array('atomic' => false)));
  2007. } else {
  2008. $saved = $this->{$association}->save($values, array_merge($options, array('atomic' => false)));
  2009. }
  2010. $validates = ($saved === true || (is_array($saved) && !in_array(false, $saved, true)));
  2011. }
  2012. if ($validates) {
  2013. $key = $this->belongsTo[$association]['foreignKey'];
  2014. if (isset($data[$this->alias])) {
  2015. $data[$this->alias][$key] = $this->{$association}->id;
  2016. } else {
  2017. $data = array_merge(array($key => $this->{$association}->id), $data, array($key => $this->{$association}->id));
  2018. }
  2019. } else {
  2020. $validationErrors[$association] = $this->{$association}->validationErrors;
  2021. }
  2022. $return[$association] = $validates;
  2023. }
  2024. }
  2025. if ($validates && !($this->create(null) !== null && $this->save($data, $options))) {
  2026. $validationErrors[$this->alias] = $this->validationErrors;
  2027. $validates = false;
  2028. }
  2029. $return[$this->alias] = $validates;
  2030. foreach ($data as $association => $values) {
  2031. if (!$validates) {
  2032. break;
  2033. }
  2034. $notEmpty = !empty($values[$association]) || (!isset($values[$association]) && !empty($values));
  2035. if (isset($associations[$association]) && $notEmpty) {
  2036. $type = $associations[$association];
  2037. $key = $this->{$type}[$association]['foreignKey'];
  2038. switch ($type) {
  2039. case 'hasOne':
  2040. if (isset($values[$association])) {
  2041. $values[$association][$key] = $this->id;
  2042. } else {
  2043. $values = array_merge(array($key => $this->id), $values, array($key => $this->id));
  2044. }
  2045. $validates = $this->{$association}->create(null) !== null;
  2046. $saved = false;
  2047. if ($validates) {
  2048. if ($options['deep']) {
  2049. $saved = $this->{$association}->saveAssociated($values, array_merge($options, array('atomic' => false)));
  2050. } else {
  2051. $saved = $this->{$association}->save($values, $options);
  2052. }
  2053. }
  2054. $validates = ($validates && ($saved === true || (is_array($saved) && !in_array(false, $saved, true))));
  2055. if (!$validates) {
  2056. $validationErrors[$association] = $this->{$association}->validationErrors;
  2057. }
  2058. $return[$association] = $validates;
  2059. break;
  2060. case 'hasMany':
  2061. foreach ($values as $i => $value) {
  2062. if (isset($values[$i][$association])) {
  2063. $values[$i][$association][$key] = $this->id;
  2064. } else {
  2065. $values[$i] = array_merge(array($key => $this->id), $value, array($key => $this->id));
  2066. }
  2067. }
  2068. $_return = $this->{$association}->saveMany($values, array_merge($options, array('atomic' => false)));
  2069. if (in_array(false, $_return, true)) {
  2070. $validationErrors[$association] = $this->{$association}->validationErrors;
  2071. $validates = false;
  2072. }
  2073. $return[$association] = $_return;
  2074. break;
  2075. }
  2076. }
  2077. }
  2078. $this->validationErrors = $validationErrors;
  2079. if (isset($validationErrors[$this->alias])) {
  2080. $this->validationErrors = $validationErrors[$this->alias];
  2081. }
  2082. if (!$options['atomic']) {
  2083. return $return;
  2084. }
  2085. if ($validates) {
  2086. if ($transactionBegun) {
  2087. return $db->commit() !== false;
  2088. } else {
  2089. return true;
  2090. }
  2091. }
  2092. $db->rollback();
  2093. return false;
  2094. }
  2095. /**
  2096. * Validates a single record, as well as all its directly associated records.
  2097. *
  2098. * #### Options
  2099. *
  2100. * - atomic: If true (default), returns boolean. If false returns array.
  2101. * - fieldList: Equivalent to the $fieldList parameter in Model::save()
  2102. * - deep: If set to true, not only directly associated data , but deeper nested associated data is validated as well.
  2103. *
  2104. * Warning: This method could potentially change the passed argument `$data`,
  2105. * If you do not want this to happen, make a copy of `$data` before passing it
  2106. * to this method
  2107. *
  2108. * @param array $data Record data to validate. This should be an array indexed by association name.
  2109. * @param array $options Options to use when validating record data (see above), See also $options of validates().
  2110. * @return array|boolean If atomic: True on success, or false on failure.
  2111. * Otherwise: array similar to the $data array passed, but values are set to true/false
  2112. * depending on whether each record validated successfully.
  2113. */
  2114. public function validateAssociated(&$data, $options = array()) {
  2115. return $this->validator()->validateAssociated($data, $options);
  2116. }
  2117. /**
  2118. * Updates multiple model records based on a set of conditions.
  2119. *
  2120. * @param array $fields Set of fields and values, indexed by fields.
  2121. * Fields are treated as SQL snippets, to insert literal values manually escape your data.
  2122. * @param mixed $conditions Conditions to match, true for all records
  2123. * @return boolean True on success, false on failure
  2124. * @link http://book.cakephp.org/2.0/en/models/saving-your-data.html#model-updateall-array-fields-array-conditions
  2125. */
  2126. public function updateAll($fields, $conditions = true) {
  2127. return $this->getDataSource()->update($this, $fields, null, $conditions);
  2128. }
  2129. /**
  2130. * Removes record for given ID. If no ID is given, the current ID is used. Returns true on success.
  2131. *
  2132. * @param mixed $id ID of record to delete
  2133. * @param boolean $cascade Set to true to delete records that depend on this record
  2134. * @return boolean True on success
  2135. * @link http://book.cakephp.org/2.0/en/models/deleting-data.html
  2136. */
  2137. public function delete($id = null, $cascade = true) {
  2138. if (!empty($id)) {
  2139. $this->id = $id;
  2140. }
  2141. $id = $this->id;
  2142. $event = new CakeEvent('Model.beforeDelete', $this, array($cascade));
  2143. list($event->break, $event->breakOn) = array(true, array(false, null));
  2144. $this->getEventManager()->dispatch($event);
  2145. if (!$event->isStopped()) {
  2146. if (!$this->exists()) {
  2147. return false;
  2148. }
  2149. $db = $this->getDataSource();
  2150. $this->_deleteDependent($id, $cascade);
  2151. $this->_deleteLinks($id);
  2152. $this->id = $id;
  2153. $updateCounterCache = false;
  2154. if (!empty($this->belongsTo)) {
  2155. foreach ($this->belongsTo as $parent => $assoc) {
  2156. if (!empty($assoc['counterCache'])) {
  2157. $updateCounterCache = true;
  2158. break;
  2159. }
  2160. }
  2161. $keys = $this->find('first', array(
  2162. 'fields' => $this->_collectForeignKeys(),
  2163. 'conditions' => array($this->alias . '.' . $this->primaryKey => $id),
  2164. 'recursive' => -1,
  2165. 'callbacks' => false
  2166. ));
  2167. }
  2168. if ($db->delete($this, array($this->alias . '.' . $this->primaryKey => $id))) {
  2169. if ($updateCounterCache) {
  2170. $this->updateCounterCache($keys[$this->alias]);
  2171. }
  2172. $this->getEventManager()->dispatch(new CakeEvent('Model.afterDelete', $this));
  2173. $this->_clearCache();
  2174. $this->id = false;
  2175. return true;
  2176. }
  2177. }
  2178. return false;
  2179. }
  2180. /**
  2181. * Cascades model deletes through associated hasMany and hasOne child records.
  2182. *
  2183. * @param string $id ID of record that was deleted
  2184. * @param boolean $cascade Set to true to delete records that depend on this record
  2185. * @return void
  2186. */
  2187. protected function _deleteDependent($id, $cascade) {
  2188. if (!empty($this->__backAssociation)) {
  2189. $savedAssociatons = $this->__backAssociation;
  2190. $this->__backAssociation = array();
  2191. }
  2192. if ($cascade === true) {
  2193. foreach (array_merge($this->hasMany, $this->hasOne) as $assoc => $data) {
  2194. if ($data['dependent'] === true) {
  2195. $model = $this->{$assoc};
  2196. if ($data['foreignKey'] === false && $data['conditions'] && in_array($this->name, $model->getAssociated('belongsTo'))) {
  2197. $model->recursive = 0;
  2198. $conditions = array($this->escapeField(null, $this->name) => $id);
  2199. } else {
  2200. $model->recursive = -1;
  2201. $conditions = array($model->escapeField($data['foreignKey']) => $id);
  2202. if ($data['conditions']) {
  2203. $conditions = array_merge((array)$data['conditions'], $conditions);
  2204. }
  2205. }
  2206. if (isset($data['exclusive']) && $data['exclusive']) {
  2207. $model->deleteAll($conditions);
  2208. } else {
  2209. $records = $model->find('all', array(
  2210. 'conditions' => $conditions, 'fields' => $model->primaryKey
  2211. ));
  2212. if (!empty($records)) {
  2213. foreach ($records as $record) {
  2214. $model->delete($record[$model->alias][$model->primaryKey]);
  2215. }
  2216. }
  2217. }
  2218. }
  2219. }
  2220. }
  2221. if (isset($savedAssociatons)) {
  2222. $this->__backAssociation = $savedAssociatons;
  2223. }
  2224. }
  2225. /**
  2226. * Cascades model deletes through HABTM join keys.
  2227. *
  2228. * @param string $id ID of record that was deleted
  2229. * @return void
  2230. */
  2231. protected function _deleteLinks($id) {
  2232. foreach ($this->hasAndBelongsToMany as $assoc => $data) {
  2233. list($plugin, $joinModel) = pluginSplit($data['with']);
  2234. $records = $this->{$joinModel}->find('all', array(
  2235. 'conditions' => array($this->{$joinModel}->escapeField($data['foreignKey']) => $id),
  2236. 'fields' => $this->{$joinModel}->primaryKey,
  2237. 'recursive' => -1,
  2238. 'callbacks' => false
  2239. ));
  2240. if (!empty($records)) {
  2241. foreach ($records as $record) {
  2242. $this->{$joinModel}->delete($record[$this->{$joinModel}->alias][$this->{$joinModel}->primaryKey]);
  2243. }
  2244. }
  2245. }
  2246. }
  2247. /**
  2248. * Deletes multiple model records based on a set of conditions.
  2249. *
  2250. * @param mixed $conditions Conditions to match
  2251. * @param boolean $cascade Set to true to delete records that depend on this record
  2252. * @param boolean $callbacks Run callbacks
  2253. * @return boolean True on success, false on failure
  2254. * @link http://book.cakephp.org/2.0/en/models/deleting-data.html#deleteall
  2255. */
  2256. public function deleteAll($conditions, $cascade = true, $callbacks = false) {
  2257. if (empty($conditions)) {
  2258. return false;
  2259. }
  2260. $db = $this->getDataSource();
  2261. if (!$cascade && !$callbacks) {
  2262. return $db->delete($this, $conditions);
  2263. } else {
  2264. $ids = $this->find('all', array_merge(array(
  2265. 'fields' => "{$this->alias}.{$this->primaryKey}",
  2266. 'recursive' => 0), compact('conditions'))
  2267. );
  2268. if ($ids === false) {
  2269. return false;
  2270. }
  2271. $ids = Hash::extract($ids, "{n}.{$this->alias}.{$this->primaryKey}");
  2272. if (empty($ids)) {
  2273. return true;
  2274. }
  2275. if ($callbacks) {
  2276. $_id = $this->id;
  2277. $result = true;
  2278. foreach ($ids as $id) {
  2279. $result = ($result && $this->delete($id, $cascade));
  2280. }
  2281. $this->id = $_id;
  2282. return $result;
  2283. } else {
  2284. foreach ($ids as $id) {
  2285. $this->_deleteLinks($id);
  2286. if ($cascade) {
  2287. $this->_deleteDependent($id, $cascade);
  2288. }
  2289. }
  2290. return $db->delete($this, array($this->alias . '.' . $this->primaryKey => $ids));
  2291. }
  2292. }
  2293. }
  2294. /**
  2295. * Collects foreign keys from associations.
  2296. *
  2297. * @param string $type
  2298. * @return array
  2299. */
  2300. protected function _collectForeignKeys($type = 'belongsTo') {
  2301. $result = array();
  2302. foreach ($this->{$type} as $assoc => $data) {
  2303. if (isset($data['foreignKey']) && is_string($data['foreignKey'])) {
  2304. $result[$assoc] = $data['foreignKey'];
  2305. }
  2306. }
  2307. return $result;
  2308. }
  2309. /**
  2310. * Returns true if a record with particular ID exists.
  2311. *
  2312. * If $id is not passed it calls Model::getID() to obtain the current record ID,
  2313. * and then performs a Model::find('count') on the currently configured datasource
  2314. * to ascertain the existence of the record in persistent storage.
  2315. *
  2316. * @param mixed $id ID of record to check for existence
  2317. * @return boolean True if such a record exists
  2318. */
  2319. public function exists($id = null) {
  2320. if ($id === null) {
  2321. $id = $this->getID();
  2322. }
  2323. if ($id === false) {
  2324. return false;
  2325. }
  2326. $conditions = array($this->alias . '.' . $this->primaryKey => $id);
  2327. $query = array('conditions' => $conditions, 'recursive' => -1, 'callbacks' => false);
  2328. return ($this->find('count', $query) > 0);
  2329. }
  2330. /**
  2331. * Returns true if a record that meets given conditions exists.
  2332. *
  2333. * @param array $conditions SQL conditions array
  2334. * @return boolean True if such a record exists
  2335. */
  2336. public function hasAny($conditions = null) {
  2337. return ($this->find('count', array('conditions' => $conditions, 'recursive' => -1)) != false);
  2338. }
  2339. /**
  2340. * Queries the datasource and returns a result set array.
  2341. *
  2342. * Also used to perform notation finds, where the first argument is type of find operation to perform
  2343. * (all / first / count / neighbors / list / threaded),
  2344. * second parameter options for finding ( indexed array, including: 'conditions', 'limit',
  2345. * 'recursive', 'page', 'fields', 'offset', 'order')
  2346. *
  2347. * Eg:
  2348. * {{{
  2349. * find('all', array(
  2350. * 'conditions' => array('name' => 'Thomas Anderson'),
  2351. * 'fields' => array('name', 'email'),
  2352. * 'order' => 'field3 DESC',
  2353. * 'recursive' => 2,
  2354. * 'group' => 'type'
  2355. * ));
  2356. * }}}
  2357. *
  2358. * In addition to the standard query keys above, you can provide Datasource, and behavior specific
  2359. * keys. For example, when using a SQL based datasource you can use the joins key to specify additional
  2360. * joins that should be part of the query.
  2361. *
  2362. * {{{
  2363. * find('all', array(
  2364. * 'conditions' => array('name' => 'Thomas Anderson'),
  2365. * 'joins' => array(
  2366. * array(
  2367. * 'alias' => 'Thought',
  2368. * 'table' => 'thoughts',
  2369. * 'type' => 'LEFT',
  2370. * 'conditions' => '`Thought`.`person_id` = `Person`.`id`'
  2371. * )
  2372. * )
  2373. * ));
  2374. * }}}
  2375. *
  2376. * Behaviors and find types can also define custom finder keys which are passed into find().
  2377. *
  2378. * Specifying 'fields' for notation 'list':
  2379. *
  2380. * - If no fields are specified, then 'id' is used for key and 'model->displayField' is used for value.
  2381. * - If a single field is specified, 'id' is used for key and specified field is used for value.
  2382. * - If three fields are specified, they are used (in order) for key, value and group.
  2383. * - Otherwise, first and second fields are used for key and value.
  2384. *
  2385. * Note: find(list) + database views have issues with MySQL 5.0. Try upgrading to MySQL 5.1 if you
  2386. * have issues with database views.
  2387. * @param string $type Type of find operation (all / first / count / neighbors / list / threaded)
  2388. * @param array $query Option fields (conditions / fields / joins / limit / offset / order / page / group / callbacks)
  2389. * @return array Array of records
  2390. * @link http://book.cakephp.org/2.0/en/models/deleting-data.html#deleteall
  2391. */
  2392. public function find($type = 'first', $query = array()) {
  2393. $this->findQueryType = $type;
  2394. $this->id = $this->getID();
  2395. $query = $this->buildQuery($type, $query);
  2396. if (is_null($query)) {
  2397. return null;
  2398. }
  2399. $results = $this->getDataSource()->read($this, $query);
  2400. $this->resetAssociations();
  2401. if ($query['callbacks'] === true || $query['callbacks'] === 'after') {
  2402. $results = $this->_filterResults($results);
  2403. }
  2404. $this->findQueryType = null;
  2405. if ($type === 'all') {
  2406. return $results;
  2407. } else {
  2408. if ($this->findMethods[$type] === true) {
  2409. return $this->{'_find' . ucfirst($type)}('after', $query, $results);
  2410. }
  2411. }
  2412. }
  2413. /**
  2414. * Builds the query array that is used by the data source to generate the query to fetch the data.
  2415. *
  2416. * @param string $type Type of find operation (all / first / count / neighbors / list / threaded)
  2417. * @param array $query Option fields (conditions / fields / joins / limit / offset / order / page / group / callbacks)
  2418. * @return array Query array or null if it could not be build for some reasons
  2419. * @see Model::find()
  2420. */
  2421. public function buildQuery($type = 'first', $query = array()) {
  2422. $query = array_merge(
  2423. array(
  2424. 'conditions' => null, 'fields' => null, 'joins' => array(), 'limit' => null,
  2425. 'offset' => null, 'order' => null, 'page' => 1, 'group' => null, 'callbacks' => true,
  2426. ),
  2427. (array)$query
  2428. );
  2429. if ($type !== 'all') {
  2430. if ($this->findMethods[$type] === true) {
  2431. $query = $this->{'_find' . ucfirst($type)}('before', $query);
  2432. }
  2433. }
  2434. if (!is_numeric($query['page']) || intval($query['page']) < 1) {
  2435. $query['page'] = 1;
  2436. }
  2437. if ($query['page'] > 1 && !empty($query['limit'])) {
  2438. $query['offset'] = ($query['page'] - 1) * $query['limit'];
  2439. }
  2440. if ($query['order'] === null && $this->order !== null) {
  2441. $query['order'] = $this->order;
  2442. }
  2443. $query['order'] = array($query['order']);
  2444. if ($query['callbacks'] === true || $query['callbacks'] === 'before') {
  2445. $event = new CakeEvent('Model.beforeFind', $this, array($query));
  2446. list($event->break, $event->breakOn, $event->modParams) = array(true, array(false, null), 0);
  2447. $this->getEventManager()->dispatch($event);
  2448. if ($event->isStopped()) {
  2449. return null;
  2450. }
  2451. $query = $event->result === true ? $event->data[0] : $event->result;
  2452. }
  2453. return $query;
  2454. }
  2455. /**
  2456. * Handles the before/after filter logic for find('first') operations. Only called by Model::find().
  2457. *
  2458. * @param string $state Either "before" or "after"
  2459. * @param array $query
  2460. * @param array $results
  2461. * @return array
  2462. * @see Model::find()
  2463. */
  2464. protected function _findFirst($state, $query, $results = array()) {
  2465. if ($state === 'before') {
  2466. $query['limit'] = 1;
  2467. return $query;
  2468. } elseif ($state === 'after') {
  2469. if (empty($results[0])) {
  2470. return false;
  2471. }
  2472. return $results[0];
  2473. }
  2474. }
  2475. /**
  2476. * Handles the before/after filter logic for find('count') operations. Only called by Model::find().
  2477. *
  2478. * @param string $state Either "before" or "after"
  2479. * @param array $query
  2480. * @param array $results
  2481. * @return integer The number of records found, or false
  2482. * @see Model::find()
  2483. */
  2484. protected function _findCount($state, $query, $results = array()) {
  2485. if ($state === 'before') {
  2486. if (!empty($query['type']) && isset($this->findMethods[$query['type']]) && $query['type'] !== 'count' ) {
  2487. $query['operation'] = 'count';
  2488. $query = $this->{'_find' . ucfirst($query['type'])}('before', $query);
  2489. }
  2490. $db = $this->getDataSource();
  2491. $query['order'] = false;
  2492. if (!method_exists($db, 'calculate')) {
  2493. return $query;
  2494. }
  2495. if (!empty($query['fields']) && is_array($query['fields'])) {
  2496. if (!preg_match('/^count/i', current($query['fields']))) {
  2497. unset($query['fields']);
  2498. }
  2499. }
  2500. if (empty($query['fields'])) {
  2501. $query['fields'] = $db->calculate($this, 'count');
  2502. } elseif (method_exists($db, 'expression') && is_string($query['fields']) && !preg_match('/count/i', $query['fields'])) {
  2503. $query['fields'] = $db->calculate($this, 'count', array(
  2504. $db->expression($query['fields']), 'count'
  2505. ));
  2506. }
  2507. return $query;
  2508. } elseif ($state === 'after') {
  2509. foreach (array(0, $this->alias) as $key) {
  2510. if (isset($results[0][$key]['count'])) {
  2511. if (($count = count($results)) > 1) {
  2512. return $count;
  2513. } else {
  2514. return intval($results[0][$key]['count']);
  2515. }
  2516. }
  2517. }
  2518. return false;
  2519. }
  2520. }
  2521. /**
  2522. * Handles the before/after filter logic for find('list') operations. Only called by Model::find().
  2523. *
  2524. * @param string $state Either "before" or "after"
  2525. * @param array $query
  2526. * @param array $results
  2527. * @return array Key/value pairs of primary keys/display field values of all records found
  2528. * @see Model::find()
  2529. */
  2530. protected function _findList($state, $query, $results = array()) {
  2531. if ($state === 'before') {
  2532. if (empty($query['fields'])) {
  2533. $query['fields'] = array("{$this->alias}.{$this->primaryKey}", "{$this->alias}.{$this->displayField}");
  2534. $list = array("{n}.{$this->alias}.{$this->primaryKey}", "{n}.{$this->alias}.{$this->displayField}", null);
  2535. } else {
  2536. if (!is_array($query['fields'])) {
  2537. $query['fields'] = String::tokenize($query['fields']);
  2538. }
  2539. if (count($query['fields']) === 1) {
  2540. if (strpos($query['fields'][0], '.') === false) {
  2541. $query['fields'][0] = $this->alias . '.' . $query['fields'][0];
  2542. }
  2543. $list = array("{n}.{$this->alias}.{$this->primaryKey}", '{n}.' . $query['fields'][0], null);
  2544. $query['fields'] = array("{$this->alias}.{$this->primaryKey}", $query['fields'][0]);
  2545. } elseif (count($query['fields']) === 3) {
  2546. for ($i = 0; $i < 3; $i++) {
  2547. if (strpos($query['fields'][$i], '.') === false) {
  2548. $query['fields'][$i] = $this->alias . '.' . $query['fields'][$i];
  2549. }
  2550. }
  2551. $list = array('{n}.' . $query['fields'][0], '{n}.' . $query['fields'][1], '{n}.' . $query['fields'][2]);
  2552. } else {
  2553. for ($i = 0; $i < 2; $i++) {
  2554. if (strpos($query['fields'][$i], '.') === false) {
  2555. $query['fields'][$i] = $this->alias . '.' . $query['fields'][$i];
  2556. }
  2557. }
  2558. $list = array('{n}.' . $query['fields'][0], '{n}.' . $query['fields'][1], null);
  2559. }
  2560. }
  2561. if (!isset($query['recursive']) || $query['recursive'] === null) {
  2562. $query['recursive'] = -1;
  2563. }
  2564. list($query['list']['keyPath'], $query['list']['valuePath'], $query['list']['groupPath']) = $list;
  2565. return $query;
  2566. } elseif ($state === 'after') {
  2567. if (empty($results)) {
  2568. return array();
  2569. }
  2570. $lst = $query['list'];
  2571. return Hash::combine($results, $lst['keyPath'], $lst['valuePath'], $lst['groupPath']);
  2572. }
  2573. }
  2574. /**
  2575. * Detects the previous field's value, then uses logic to find the 'wrapping'
  2576. * rows and return them.
  2577. *
  2578. * @param string $state Either "before" or "after"
  2579. * @param mixed $query
  2580. * @param array $results
  2581. * @return array
  2582. */
  2583. protected function _findNeighbors($state, $query, $results = array()) {
  2584. if ($state === 'before') {
  2585. extract($query);
  2586. $conditions = (array)$conditions;
  2587. if (isset($field) && isset($value)) {
  2588. if (strpos($field, '.') === false) {
  2589. $field = $this->alias . '.' . $field;
  2590. }
  2591. } else {
  2592. $field = $this->alias . '.' . $this->primaryKey;
  2593. $value = $this->id;
  2594. }
  2595. $query['conditions'] = array_merge($conditions, array($field . ' <' => $value));
  2596. $query['order'] = $field . ' DESC';
  2597. $query['limit'] = 1;
  2598. $query['field'] = $field;
  2599. $query['value'] = $value;
  2600. return $query;
  2601. } elseif ($state === 'after') {
  2602. extract($query);
  2603. unset($query['conditions'][$field . ' <']);
  2604. $return = array();
  2605. if (isset($results[0])) {
  2606. $prevVal = Hash::get($results[0], $field);
  2607. $query['conditions'][$field . ' >='] = $prevVal;
  2608. $query['conditions'][$field . ' !='] = $value;
  2609. $query['limit'] = 2;
  2610. } else {
  2611. $return['prev'] = null;
  2612. $query['conditions'][$field . ' >'] = $value;
  2613. $query['limit'] = 1;
  2614. }
  2615. $query['order'] = $field . ' ASC';
  2616. $neighbors = $this->find('all', $query);
  2617. if (!array_key_exists('prev', $return)) {
  2618. $return['prev'] = $neighbors[0];
  2619. }
  2620. if (count($neighbors) === 2) {
  2621. $return['next'] = $neighbors[1];
  2622. } elseif (count($neighbors) === 1 && !$return['prev']) {
  2623. $return['next'] = $neighbors[0];
  2624. } else {
  2625. $return['next'] = null;
  2626. }
  2627. return $return;
  2628. }
  2629. }
  2630. /**
  2631. * In the event of ambiguous results returned (multiple top level results, with different parent_ids)
  2632. * top level results with different parent_ids to the first result will be dropped
  2633. *
  2634. * @param mixed $state
  2635. * @param mixed $query
  2636. * @param array $results
  2637. * @return array Threaded results
  2638. */
  2639. protected function _findThreaded($state, $query, $results = array()) {
  2640. if ($state === 'before') {
  2641. return $query;
  2642. } elseif ($state === 'after') {
  2643. $parent = 'parent_id';
  2644. if (isset($query['parent'])) {
  2645. $parent = $query['parent'];
  2646. }
  2647. return Hash::nest($results, array(
  2648. 'idPath' => '{n}.' . $this->alias . '.' . $this->primaryKey,
  2649. 'parentPath' => '{n}.' . $this->alias . '.' . $parent
  2650. ));
  2651. }
  2652. }
  2653. /**
  2654. * Passes query results through model and behavior afterFilter() methods.
  2655. *
  2656. * @param array $results Results to filter
  2657. * @param boolean $primary If this is the primary model results (results from model where the find operation was performed)
  2658. * @return array Set of filtered results
  2659. */
  2660. protected function _filterResults($results, $primary = true) {
  2661. $event = new CakeEvent('Model.afterFind', $this, array($results, $primary));
  2662. $event->modParams = 0;
  2663. $this->getEventManager()->dispatch($event);
  2664. return $event->result;
  2665. }
  2666. /**
  2667. * This resets the association arrays for the model back
  2668. * to those originally defined in the model. Normally called at the end
  2669. * of each call to Model::find()
  2670. *
  2671. * @return boolean Success
  2672. */
  2673. public function resetAssociations() {
  2674. if (!empty($this->__backAssociation)) {
  2675. foreach ($this->_associations as $type) {
  2676. if (isset($this->__backAssociation[$type])) {
  2677. $this->{$type} = $this->__backAssociation[$type];
  2678. }
  2679. }
  2680. $this->__backAssociation = array();
  2681. }
  2682. foreach ($this->_associations as $type) {
  2683. foreach ($this->{$type} as $key => $name) {
  2684. if (property_exists($this, $key) && !empty($this->{$key}->__backAssociation)) {
  2685. $this->{$key}->resetAssociations();
  2686. }
  2687. }
  2688. }
  2689. $this->__backAssociation = array();
  2690. return true;
  2691. }
  2692. /**
  2693. * Returns false if any fields passed match any (by default, all if $or = false) of their matching values.
  2694. *
  2695. * @param array $fields Field/value pairs to search (if no values specified, they are pulled from $this->data)
  2696. * @param boolean $or If false, all fields specified must match in order for a false return value
  2697. * @return boolean False if any records matching any fields are found
  2698. */
  2699. public function isUnique($fields, $or = true) {
  2700. if (!is_array($fields)) {
  2701. $fields = func_get_args();
  2702. if (is_bool($fields[count($fields) - 1])) {
  2703. $or = $fields[count($fields) - 1];
  2704. unset($fields[count($fields) - 1]);
  2705. }
  2706. }
  2707. foreach ($fields as $field => $value) {
  2708. if (is_numeric($field)) {
  2709. unset($fields[$field]);
  2710. $field = $value;
  2711. if (isset($this->data[$this->alias][$field])) {
  2712. $value = $this->data[$this->alias][$field];
  2713. } else {
  2714. $value = null;
  2715. }
  2716. }
  2717. if (strpos($field, '.') === false) {
  2718. unset($fields[$field]);
  2719. $fields[$this->alias . '.' . $field] = $value;
  2720. }
  2721. }
  2722. if ($or) {
  2723. $fields = array('or' => $fields);
  2724. }
  2725. if (!empty($this->id)) {
  2726. $fields[$this->alias . '.' . $this->primaryKey . ' !='] = $this->id;
  2727. }
  2728. return ($this->find('count', array('conditions' => $fields, 'recursive' => -1)) == 0);
  2729. }
  2730. /**
  2731. * Returns a resultset for a given SQL statement. Custom SQL queries should be performed with this method.
  2732. *
  2733. * @param string $sql,... SQL statement
  2734. * @return mixed Resultset array or boolean indicating success / failure depending on the query executed
  2735. * @link http://book.cakephp.org/2.0/en/models/retrieving-your-data.html#model-query
  2736. */
  2737. public function query($sql) {
  2738. $params = func_get_args();
  2739. $db = $this->getDataSource();
  2740. return call_user_func_array(array(&$db, 'query'), $params);
  2741. }
  2742. /**
  2743. * Returns true if all fields pass validation. Will validate hasAndBelongsToMany associations
  2744. * that use the 'with' key as well. Since _saveMulti is incapable of exiting a save operation.
  2745. *
  2746. * Will validate the currently set data. Use Model::set() or Model::create() to set the active data.
  2747. *
  2748. * @param array $options An optional array of custom options to be made available in the beforeValidate callback
  2749. * @return boolean True if there are no errors
  2750. */
  2751. public function validates($options = array()) {
  2752. return $this->validator()->validates($options);
  2753. }
  2754. /**
  2755. * Returns an array of fields that have failed validation. On the current model.
  2756. *
  2757. * @param string $options An optional array of custom options to be made available in the beforeValidate callback
  2758. * @return array Array of invalid fields
  2759. * @see Model::validates()
  2760. */
  2761. public function invalidFields($options = array()) {
  2762. return $this->validator()->errors($options);
  2763. }
  2764. /**
  2765. * Marks a field as invalid, optionally setting the name of validation
  2766. * rule (in case of multiple validation for field) that was broken.
  2767. *
  2768. * @param string $field The name of the field to invalidate
  2769. * @param mixed $value Name of validation rule that was not failed, or validation message to
  2770. * be returned. If no validation key is provided, defaults to true.
  2771. * @return void
  2772. */
  2773. public function invalidate($field, $value = true) {
  2774. $this->validator()->invalidate($field, $value);
  2775. }
  2776. /**
  2777. * Returns true if given field name is a foreign key in this model.
  2778. *
  2779. * @param string $field Returns true if the input string ends in "_id"
  2780. * @return boolean True if the field is a foreign key listed in the belongsTo array.
  2781. */
  2782. public function isForeignKey($field) {
  2783. $foreignKeys = array();
  2784. if (!empty($this->belongsTo)) {
  2785. foreach ($this->belongsTo as $assoc => $data) {
  2786. $foreignKeys[] = $data['foreignKey'];
  2787. }
  2788. }
  2789. return in_array($field, $foreignKeys);
  2790. }
  2791. /**
  2792. * Escapes the field name and prepends the model name. Escaping is done according to the
  2793. * current database driver's rules.
  2794. *
  2795. * @param string $field Field to escape (e.g: id)
  2796. * @param string $alias Alias for the model (e.g: Post)
  2797. * @return string The name of the escaped field for this Model (i.e. id becomes `Post`.`id`).
  2798. */
  2799. public function escapeField($field = null, $alias = null) {
  2800. if (empty($alias)) {
  2801. $alias = $this->alias;
  2802. }
  2803. if (empty($field)) {
  2804. $field = $this->primaryKey;
  2805. }
  2806. $db = $this->getDataSource();
  2807. if (strpos($field, $db->name($alias) . '.') === 0) {
  2808. return $field;
  2809. }
  2810. return $db->name($alias . '.' . $field);
  2811. }
  2812. /**
  2813. * Returns the current record's ID
  2814. *
  2815. * @param integer $list Index on which the composed ID is located
  2816. * @return mixed The ID of the current record, false if no ID
  2817. */
  2818. public function getID($list = 0) {
  2819. if (empty($this->id) || (is_array($this->id) && isset($this->id[0]) && empty($this->id[0]))) {
  2820. return false;
  2821. }
  2822. if (!is_array($this->id)) {
  2823. return $this->id;
  2824. }
  2825. if (isset($this->id[$list]) && !empty($this->id[$list])) {
  2826. return $this->id[$list];
  2827. } elseif (isset($this->id[$list])) {
  2828. return false;
  2829. }
  2830. return current($this->id);
  2831. }
  2832. /**
  2833. * Returns the ID of the last record this model inserted.
  2834. *
  2835. * @return mixed Last inserted ID
  2836. */
  2837. public function getLastInsertID() {
  2838. return $this->getInsertID();
  2839. }
  2840. /**
  2841. * Returns the ID of the last record this model inserted.
  2842. *
  2843. * @return mixed Last inserted ID
  2844. */
  2845. public function getInsertID() {
  2846. return $this->_insertID;
  2847. }
  2848. /**
  2849. * Sets the ID of the last record this model inserted
  2850. *
  2851. * @param mixed $id Last inserted ID
  2852. * @return void
  2853. */
  2854. public function setInsertID($id) {
  2855. $this->_insertID = $id;
  2856. }
  2857. /**
  2858. * Returns the number of rows returned from the last query.
  2859. *
  2860. * @return integer Number of rows
  2861. */
  2862. public function getNumRows() {
  2863. return $this->getDataSource()->lastNumRows();
  2864. }
  2865. /**
  2866. * Returns the number of rows affected by the last query.
  2867. *
  2868. * @return integer Number of rows
  2869. */
  2870. public function getAffectedRows() {
  2871. return $this->getDataSource()->lastAffected();
  2872. }
  2873. /**
  2874. * Sets the DataSource to which this model is bound.
  2875. *
  2876. * @param string $dataSource The name of the DataSource, as defined in app/Config/database.php
  2877. * @return void
  2878. * @throws MissingConnectionException
  2879. */
  2880. public function setDataSource($dataSource = null) {
  2881. $oldConfig = $this->useDbConfig;
  2882. if ($dataSource != null) {
  2883. $this->useDbConfig = $dataSource;
  2884. }
  2885. $db = ConnectionManager::getDataSource($this->useDbConfig);
  2886. if (!empty($oldConfig) && isset($db->config['prefix'])) {
  2887. $oldDb = ConnectionManager::getDataSource($oldConfig);
  2888. if (!isset($this->tablePrefix) || (!isset($oldDb->config['prefix']) || $this->tablePrefix == $oldDb->config['prefix'])) {
  2889. $this->tablePrefix = $db->config['prefix'];
  2890. }
  2891. } elseif (isset($db->config['prefix'])) {
  2892. $this->tablePrefix = $db->config['prefix'];
  2893. }
  2894. $this->schemaName = $db->getSchemaName();
  2895. if (empty($db) || !is_object($db)) {
  2896. throw new MissingConnectionException(array('class' => $this->name));
  2897. }
  2898. }
  2899. /**
  2900. * Gets the DataSource to which this model is bound.
  2901. *
  2902. * @return DataSource A DataSource object
  2903. */
  2904. public function getDataSource() {
  2905. if (!$this->_sourceConfigured && $this->useTable !== false) {
  2906. $this->_sourceConfigured = true;
  2907. $this->setSource($this->useTable);
  2908. }
  2909. return ConnectionManager::getDataSource($this->useDbConfig);
  2910. }
  2911. /**
  2912. * Get associations
  2913. *
  2914. * @return array
  2915. */
  2916. public function associations() {
  2917. return $this->_associations;
  2918. }
  2919. /**
  2920. * Gets all the models with which this model is associated.
  2921. *
  2922. * @param string $type Only result associations of this type
  2923. * @return array Associations
  2924. */
  2925. public function getAssociated($type = null) {
  2926. if ($type == null) {
  2927. $associated = array();
  2928. foreach ($this->_associations as $assoc) {
  2929. if (!empty($this->{$assoc})) {
  2930. $models = array_keys($this->{$assoc});
  2931. foreach ($models as $m) {
  2932. $associated[$m] = $assoc;
  2933. }
  2934. }
  2935. }
  2936. return $associated;
  2937. } elseif (in_array($type, $this->_associations)) {
  2938. if (empty($this->{$type})) {
  2939. return array();
  2940. }
  2941. return array_keys($this->{$type});
  2942. } else {
  2943. $assoc = array_merge(
  2944. $this->hasOne,
  2945. $this->hasMany,
  2946. $this->belongsTo,
  2947. $this->hasAndBelongsToMany
  2948. );
  2949. if (array_key_exists($type, $assoc)) {
  2950. foreach ($this->_associations as $a) {
  2951. if (isset($this->{$a}[$type])) {
  2952. $assoc[$type]['association'] = $a;
  2953. break;
  2954. }
  2955. }
  2956. return $assoc[$type];
  2957. }
  2958. return null;
  2959. }
  2960. }
  2961. /**
  2962. * Gets the name and fields to be used by a join model. This allows specifying join fields
  2963. * in the association definition.
  2964. *
  2965. * @param string|array $assoc The model to be joined
  2966. * @param array $keys Any join keys which must be merged with the keys queried
  2967. * @return array
  2968. */
  2969. public function joinModel($assoc, $keys = array()) {
  2970. if (is_string($assoc)) {
  2971. list(, $assoc) = pluginSplit($assoc);
  2972. return array($assoc, array_keys($this->{$assoc}->schema()));
  2973. } elseif (is_array($assoc)) {
  2974. $with = key($assoc);
  2975. return array($with, array_unique(array_merge($assoc[$with], $keys)));
  2976. }
  2977. trigger_error(
  2978. __d('cake_dev', 'Invalid join model settings in %s', $model->alias),
  2979. E_USER_WARNING
  2980. );
  2981. }
  2982. /**
  2983. * Called before each find operation. Return false if you want to halt the find
  2984. * call, otherwise return the (modified) query data.
  2985. *
  2986. * @param array $queryData Data used to execute this query, i.e. conditions, order, etc.
  2987. * @return mixed true if the operation should continue, false if it should abort; or, modified
  2988. * $queryData to continue with new $queryData
  2989. * @link http://book.cakephp.org/2.0/en/models/callback-methods.html#beforefind
  2990. */
  2991. public function beforeFind($queryData) {
  2992. return true;
  2993. }
  2994. /**
  2995. * Called after each find operation. Can be used to modify any results returned by find().
  2996. * Return value should be the (modified) results.
  2997. *
  2998. * @param mixed $results The results of the find operation
  2999. * @param boolean $primary Whether this model is being queried directly (vs. being queried as an association)
  3000. * @return mixed Result of the find operation
  3001. * @link http://book.cakephp.org/2.0/en/models/callback-methods.html#afterfind
  3002. */
  3003. public function afterFind($results, $primary = false) {
  3004. return $results;
  3005. }
  3006. /**
  3007. * Called before each save operation, after validation. Return a non-true result
  3008. * to halt the save.
  3009. *
  3010. * @param array $options
  3011. * @return boolean True if the operation should continue, false if it should abort
  3012. * @link http://book.cakephp.org/2.0/en/models/callback-methods.html#beforesave
  3013. */
  3014. public function beforeSave($options = array()) {
  3015. return true;
  3016. }
  3017. /**
  3018. * Called after each successful save operation.
  3019. *
  3020. * @param boolean $created True if this save created a new record
  3021. * @return void
  3022. * @link http://book.cakephp.org/2.0/en/models/callback-methods.html#aftersave
  3023. */
  3024. public function afterSave($created) {
  3025. }
  3026. /**
  3027. * Called before every deletion operation.
  3028. *
  3029. * @param boolean $cascade If true records that depend on this record will also be deleted
  3030. * @return boolean True if the operation should continue, false if it should abort
  3031. * @link http://book.cakephp.org/2.0/en/models/callback-methods.html#beforedelete
  3032. */
  3033. public function beforeDelete($cascade = true) {
  3034. return true;
  3035. }
  3036. /**
  3037. * Called after every deletion operation.
  3038. *
  3039. * @return void
  3040. * @link http://book.cakephp.org/2.0/en/models/callback-methods.html#afterdelete
  3041. */
  3042. public function afterDelete() {
  3043. }
  3044. /**
  3045. * Called during validation operations, before validation. Please note that custom
  3046. * validation rules can be defined in $validate.
  3047. *
  3048. * @param array $options Options passed from model::save(), see $options of model::save().
  3049. * @return boolean True if validate operation should continue, false to abort
  3050. * @link http://book.cakephp.org/2.0/en/models/callback-methods.html#beforevalidate
  3051. */
  3052. public function beforeValidate($options = array()) {
  3053. return true;
  3054. }
  3055. /**
  3056. * Called after data has been checked for errors
  3057. *
  3058. * @return void
  3059. */
  3060. public function afterValidate() {
  3061. }
  3062. /**
  3063. * Called when a DataSource-level error occurs.
  3064. *
  3065. * @return void
  3066. * @link http://book.cakephp.org/2.0/en/models/callback-methods.html#onerror
  3067. */
  3068. public function onError() {
  3069. }
  3070. /**
  3071. * Clears cache for this model.
  3072. *
  3073. * @param string $type If null this deletes cached views if Cache.check is true
  3074. * Will be used to allow deleting query cache also
  3075. * @return boolean true on delete
  3076. */
  3077. protected function _clearCache($type = null) {
  3078. if ($type === null) {
  3079. if (Configure::read('Cache.check') === true) {
  3080. $assoc[] = strtolower(Inflector::pluralize($this->alias));
  3081. $assoc[] = strtolower(Inflector::underscore(Inflector::pluralize($this->alias)));
  3082. foreach ($this->_associations as $key => $association) {
  3083. foreach ($this->$association as $key => $className) {
  3084. $check = strtolower(Inflector::pluralize($className['className']));
  3085. if (!in_array($check, $assoc)) {
  3086. $assoc[] = strtolower(Inflector::pluralize($className['className']));
  3087. $assoc[] = strtolower(Inflector::underscore(Inflector::pluralize($className['className'])));
  3088. }
  3089. }
  3090. }
  3091. clearCache($assoc);
  3092. return true;
  3093. }
  3094. } else {
  3095. //Will use for query cache deleting
  3096. }
  3097. }
  3098. /**
  3099. * Retunrs an instance of a model validator for this class
  3100. *
  3101. * @return ModelValidator
  3102. */
  3103. public function validator($instance = null) {
  3104. if ($instance instanceof ModelValidator) {
  3105. return $this->_validator = $instance;
  3106. }
  3107. if (is_null($instance)) {
  3108. $this->_validator = new ModelValidator($this);
  3109. }
  3110. return $this->_validator;
  3111. }
  3112. }