The API

Called after every deletion operation.

Called after each find operation. Can be used to modify any results returned by find(). Return value should be the (modified) results.

Called after each successful save operation.

Called before every deletion operation.

Called before each find operation. Return false if you want to halt the find call, otherwise return the (modified) query data.

Called before each save operation, after validation. Return a non-true result to halt the save.

Called during save operations, before validation. Please note that custom validation rules can be defined in $validate.

Bind model associations on the fly. If $permanent is true, association will not be reset to the originals defined in the model. be bound

Bind model associations on the fly. If $reset is false, association will not be reset to the originals defined in the model Example: Add a new hasOne binding to the Profile model not defined in the model source code: <code> $this->User->bindModel( array('hasOne' => array('Profile')) ); </code>

Used to report user friendly errors. If there is a file app/error.php or app/app_error.php this file will be loaded error.php is the AppError class it should extend ErrorHandler class.

Handles custom method calls, like findBy<field> for DB models, and custom RPC calls for remote data sources.

Private method. Clears cache for this model.

Constructor. Binds the model's database table to the object.

Initializes the model for writing a new record, loading the default values for those fields that are not defined in $data. Especially helpful for saving data in loops.

Deconstructs a complex data type (array or object) into a single field value.

Removes record for given ID. If no ID is given, the current ID is used. Returns true on success.

Alias for del().

Deletes multiple model records based on a set of conditions.

Cascades model deletes through associated hasMany and hasOne child records.

Cascades model deletes through HABTM join keys.

Calls a method on this object with the given parameters. Provides an OO wrapper for call_user_func_array, and improves performance by using straight method calls in most cases.

Escapes the field name and prepends the model name. Escaping is done according to the current database driver's rules.

Returns true if a record with the currently set ID exists.

Returns the contents of a single field given the supplied conditions, in the supplied order.

Returns a result set array. Also used to perform new-notation finds, where the first argument is type of find operation to perform (all / first / count / neighbors / list / threaded ), second parameter options for finding ( indexed array, including: 'conditions', 'limit', 'recursive', 'page', 'fields', 'offset', 'order') Eg: find('all', array( 'conditions' => array('name' => 'Thomas Anderson'), 'fields' => array('name', 'email'), 'order' => 'field3 DESC', 'recursive' => 2, 'group' => 'type')); Specifying 'fields' for new-notation 'list': - If no fields are specified, then 'id' is used for key and 'model->displayField' is used for value. - If a single field is specified, 'id' is used for key and specified field is used for value. - If three fields are specified, they are used (in order) for key, value and group. - Otherwise, first and second fields are used for key and value.

Handles the before/after filter logic for find('count') operations. Only called by Model::find().

Handles the before/after filter logic for find('first') operations. Only called by Model::find().

Handles the before/after filter logic for find('list') operations. Only called by Model::find().

Detects the previous field's value, then uses logic to find the 'wrapping' rows and return them.

In the event of ambiguous results returned (multiple top level results, with different parent_ids) top level results with different parent_ids to the first result will be dropped

Returns the number of rows affected by the last query.

Gets all the models with which this model is associated.

Returns the column type of a column in the model.

Returns an associative array of field names and column types.

Gets the DataSource to which this model is bound. Not safe for use with some versions of PHP4, because this class is overloaded.

Returns the display field for this model.

Returns the current record's ID

Returns the ID of the last record this model inserted.

Returns the ID of the last record this model inserted.

Returns the number of rows returned from the last query.

Returns true if a record that meets given conditions exists.

Returns true if the supplied field exists in the model's database table.

Marks a field as invalid, optionally setting the name of validation rule (in case of multiple validation for field) that was broken.

Returns an array of fields that have failed validation.

Returns true if given field name is a foreign key in this model.

Returns false if any fields passed match any (by default, all if $or = false) of their matching values.

Gets the name and fields to be used by a join model. This allows specifying join fields in the association definition.

API for logging events.

A hack to support __construct() on PHP 4 Hint: descendant classes have no PHP4 class_name() constructors, so this constructor gets called first and calls the top-layer __construct() which (if present) should call parent::__construct()

Called when a DataSource-level error occurs.

Overload implementation. No need for implementation in PHP5.

Checks for a persistent class file, if found file is opened and true returned If file is not found a file is created and false returned If used in other locations of the model you should choose a unique name for the persistent file There are many uses for this method, see manual for examples

Helper method for Model::updateCounterCache(). Checks the fields to be updated for

Returns a resultset for a given SQL statement. Custom SQL queries should be performed with this method.

Returns a list of fields from the database, and sets the current model data (Model::$data) with the record found.

Alias for del().

Calls a controller's method from any location.

Called only when bindTo<ModelName>() is used. This resets the association arrays for the model back to those originally defined in the model.

Saves model data (based on white-list, if supplied) to the database. By default, validation occurs before save. If a boolean, indicates whether or not to validate before saving. If an array, allows control of validate, callbacks, and fieldList

Saves multiple individual records for a single model; Also works with a single record, as well as all its associated records. records of the same type), or an array indexed by association name. - validate: Set to false to disable validation, true to validate each record before saving, 'first' to validate *all* records before any are saved, or 'only' to only validate the records, but not save them. - atomic: If true (default), will attempt to save all records in a single transaction. Should be set to false if database/table does not support transactions. If false, we return an array similar to the $data array passed, but values are set to true/false depending on whether each record saved successfully. - fieldList: Equivalent to the $fieldList parameter in Model::save()

Saves the value of a single field to the database, based on the current model ID.

You should choose a unique name for the persistent file There are many uses for this method, see manual for examples

Returns an array of table metadata (column names and types) from the database. $field => keys(type, null, default, key, length, extra)

This function does two things: 1) it scans the array $one for the primary key, and if that's found, it sets the current id to the value of $one[id]. For all other keys than 'id' the keys and values of $one are copied to the 'data' property of this object. 2) Returns an array with all of $one's keys and values. (Alternative indata: two strings, which are mangled to a one-item, two-dimensional array using $one for a key and $two as its value.)

Allows setting of multiple properties of the object in a single line of code.

Sets the DataSource to which this model is bound.

Sets the ID of the last record this model inserted

Sets a custom table for your controller class. Used by your controller to select a database table.

Stop execution of the current script

Object-to-string conversion. Each class can override this method as necessary.

Turn off associations on the fly. If $reset is false, association will not be reset to the originals defined in the model Example: Turn off the associated Model Support request, to temporarily lighten the User model: <code> $this->User->unbindModel( array('hasMany' => array('Supportrequest')) ); </code>

Updates multiple model records based on a set of conditions. Fields are treated as SQL snippets, to insert literal values manually escape your data.

Updates the counter cache of belongsTo associations after a save or delete operation 'counterScope' defined get updated

Returns true if all fields pass validation.