Class Aro
Access Request Object
Copyright: Copyright 2005-2011, Cake Software Foundation, Inc. (http://cakefoundation.org)
License: License (http://www.opensource.org/licenses/mit-license.php)
Location: Cake/Model/Aro.php
Properties summary
-
$hasAndBelongsToManypublicarrayAROs are linked to ACOs by means of Permission -
$namepublicstringModel name
Inherited Properties
-
actsAs,cacheQueriesBehaviors,__backAssociation,__backContainableAssociation,__backInnerAssociation,__backOriginalAssociation,_associationKeys,_associations,_insertID,_schema,_sourceConfigured,alias,belongsTo,cacheSources,data,displayField,findMethods,findQueryType,hasMany,hasOne,id,order,primaryKey,recursive,table,tablePrefix,tableToModel,useDbConfig,useTable,validate,validationDomain,validationErrors,virtualFields,whitelist
Methods inherited from AclNode
Methods inherited from Model
__call() public ¶
__call( string $method , array $params )
Handles custom method calls, like findBy
Parameters
- string $method
- Name of method to call.
- array $params
- Parameters for the method.
Returns
Whatever is returned by called method
__get() public ¶
__get( string $name )
Returns the value of the requested variable if it can be set by __isset()
Parameters
- string $name
- variable requested for it's value or reference
Returns
value of requested variable if it is set
__isset() public ¶
__isset( string $name )
Handles the lazy loading of model associations by looking in the association arrays for the requested variable
Parameters
- string $name
- variable tested for existence in class
Returns
true if the variable exists (if is a not loaded model association it will be created), false otherwise
_clearCache() protected ¶
_clearCache( string $type = null )
Clears cache for this model.
Parameters
- string $type optional null
If null this deletes cached views if Cache.check is true Will be used to allow deleting query cache also
Returns
true on delete
_collectForeignKeys() protected ¶
_collectForeignKeys( string $type = 'belongsTo' )
Collects foreign keys from associations.
Parameters
- string $type optional 'belongsTo'
Returns
_constructLinkedModel() protected ¶
_constructLinkedModel( string $assoc , string $className = null , string $plugin = null )
Protected helper method to create associated models of a given class.
Parameters
- string $assoc
- Association name
- string $className optional null
- Class name
- string $plugin optional null
name of the plugin where $className is located examples: public $hasMany = array('Assoc' => array('className' => 'ModelName')); usage: $this->Assoc->modelMethods();
public $hasMany = array('ModelName'); usage: $this->ModelName->modelMethods();
_deleteDependent() protected ¶
_deleteDependent( string $id , boolean $cascade )
Cascades model deletes through associated hasMany and hasOne child records.
Parameters
- string $id
- ID of record that was deleted
- boolean $cascade
- Set to true to delete records that depend on this record
_deleteLinks() protected ¶
_deleteLinks( string $id )
Cascades model deletes through HABTM join keys.
Parameters
- string $id
- ID of record that was deleted
_filterResults() protected ¶
_filterResults( array $results , boolean $primary = true )
Passes query results through model and behavior afterFilter() methods.
Parameters
- array $results
- Results to filter
- boolean $primary optional true
- If this is the primary model results (results from model where the find operation was performed)
Returns
Set of filtered results
_findCount() protected ¶
_findCount( string $state , array $query , array $results = array() )
Handles the before/after filter logic for find('count') operations. Only called by Model::find().
Parameters
- string $state
- Either "before" or "after"
- array $query
- array $results optional array()
Returns
The number of records found, or false
See
_findFirst() protected ¶
_findFirst( string $state , array $query , array $results = array() )
Handles the before/after filter logic for find('first') operations. Only called by Model::find().
Parameters
- string $state
- Either "before" or "after"
- array $query
- array $results optional array()
Returns
See
_findList() protected ¶
_findList( string $state , array $query , array $results = array() )
Handles the before/after filter logic for find('list') operations. Only called by Model::find().
Parameters
- string $state
- Either "before" or "after"
- array $query
- array $results optional array()
Returns
Key/value pairs of primary keys/display field values of all records found
See
_findNeighbors() protected ¶
_findNeighbors( string $state , mixed $query , array $results = array() )
Detects the previous field's value, then uses logic to find the 'wrapping' rows and return them.
Parameters
- string $state
- Either "before" or "after"
- mixed $query
- array $results optional array()
Returns
_findThreaded() protected ¶
_findThreaded( mixed $state , mixed $query , array $results = array() )
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
Parameters
- mixed $state
- mixed $query
- array $results optional array()
Returns
Threaded results
_generateAssociation() protected ¶
_generateAssociation( string $type , string $assocKey )
Build an array-based association from string.
Parameters
- string $type
- 'belongsTo', 'hasOne', 'hasMany', 'hasAndBelongsToMany'
- string $assocKey
_normalizeXmlData() protected ¶
_normalizeXmlData( array $xml )
Normalize Xml::toArray() to use in Model::save()
Parameters
- array $xml
- XML as array
Returns
_prepareUpdateFields() protected ¶
_prepareUpdateFields( array $data )
Helper method for Model::updateCounterCache(). Checks the fields to be updated for
Parameters
- array $data
- The fields of the record that will be updated
Returns
Returns updated foreign key values, along with an 'old' key containing the old values, or empty if no foreign keys are updated.
_saveMulti() protected ¶
_saveMulti( array $joined , mixed $id , DataSource $db )
Saves model hasAndBelongsToMany data to the database.
Parameters
- array $joined
- Data to save
- mixed $id
- ID of record in this model
-
DataSource$db
_validateWithModels() protected ¶
_validateWithModels( array $options )
Runs validation for hasAndBelongsToMany associations that have 'with' keys set. And data in the set() data set.
Parameters
- array $options
- Array of options to use on Validation of with models
Returns
Failure of validation on with models.
See
afterFind() public ¶
afterFind( mixed $results , boolean $primary = false )
Called after each find operation. Can be used to modify any results returned by find(). Return value should be the (modified) results.
Parameters
- mixed $results
- The results of the find operation
- boolean $primary optional false
- Whether this model is being queried directly (vs. being queried as an association)
Returns
Result of the find operation
Link
afterSave() public ¶
afterSave( boolean $created )
Called after each successful save operation.
Parameters
- boolean $created
- True if this save created a new record
Link
beforeDelete() public ¶
beforeDelete( boolean $cascade = true )
Called before every deletion operation.
Parameters
- boolean $cascade optional true
- If true records that depend on this record will also be deleted
Returns
True if the operation should continue, false if it should abort
Link
beforeFind() public ¶
beforeFind( array $queryData )
Called before each find operation. Return false if you want to halt the find call, otherwise return the (modified) query data.
Parameters
- array $queryData
- Data used to execute this query, i.e. conditions, order, etc.
Returns
true if the operation should continue, false if it should abort; or, modified $queryData to continue with new $queryData
Link
beforeSave() public ¶
beforeSave( array $options = array() )
Called before each save operation, after validation. Return a non-true result to halt the save.
Parameters
- array $options optional array()
Returns
True if the operation should continue, false if it should abort
Link
beforeValidate() public ¶
beforeValidate( array $options = array() )
Called during validation operations, before validation. Please note that custom validation rules can be defined in $validate.
Parameters
- array $options optional array()
- Options passed from model::save(), see $options of model::save().
Returns
True if validate operation should continue, false to abort
Link
bindModel() public ¶
bindModel( array $params , boolean $reset = true )
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:
$this->User->bindModel( array('hasOne' => array('Profile')) );
Bindings that are not made permanent will be reset by the next Model::find() call on this model.
Parameters
- array $params
- Set of bindings (indexed by binding type)
- boolean $reset optional true
- Set to false to make the binding permanent
Returns
Success
Link
buildQuery() public ¶
buildQuery( string $type = 'first' , array $query = array() )
Builds the query array that is used by the data source to generate the query to fetch the data.
Parameters
- string $type optional 'first'
- Type of find operation (all / first / count / neighbors / list / threaded)
- array $query optional array()
- Option fields (conditions / fields / joins / limit / offset / order / page / group / callbacks)
Returns
Query array or null if it could not be build for some reasons
See
create() public ¶
create( mixed $data = array() , boolean $filterKey = false )
Initializes the model for writing a new record, loading the default values for those fields that are not defined in $data, and clearing previous validation errors. Especially helpful for saving data in loops.
Parameters
- mixed $data optional array()
Optional data array to assign to the model after it is created. If null or false, schema data defaults are not merged.
- boolean $filterKey optional false
- If true, overwrites any primary key input with an empty value
Returns
The current Model::data; after merging $data and/or defaults from database
Link
deconstruct() public ¶
deconstruct( string $field , mixed $data )
Deconstructs a complex data type (array or object) into a single field value.
Parameters
- string $field
- The name of the field to be deconstructed
- mixed $data
- An array or object to be deconstructed into a field
Returns
The resulting data that should be assigned to a field
delete() public ¶
delete( mixed $id = null , boolean $cascade = true )
Removes record for given ID. If no ID is given, the current ID is used. Returns true on success.
Parameters
- mixed $id optional null
- ID of record to delete
- boolean $cascade optional true
- Set to true to delete records that depend on this record
Returns
True on success
Link
deleteAll() public ¶
deleteAll( mixed $conditions , boolean $cascade = true , boolean $callbacks = false )
Deletes multiple model records based on a set of conditions.
Parameters
- mixed $conditions
- Conditions to match
- boolean $cascade optional true
- Set to true to delete records that depend on this record
- boolean $callbacks optional false
- Run callbacks
Returns
True on success, false on failure
Link
escapeField() public ¶
escapeField( string $field = null , string $alias = null )
Escapes the field name and prepends the model name. Escaping is done according to the current database driver's rules.
Parameters
- string $field optional null
- Field to escape (e.g: id)
- string $alias optional null
- Alias for the model (e.g: Post)
Returns
The name of the escaped field for this Model (i.e. id becomes
Post.id).exists() public ¶
exists( )
Returns true if a record with the currently set ID exists.
Internally calls Model::getID() to obtain the current record ID to verify, and then performs a Model::find('count') on the currently configured datasource to ascertain the existence of the record in persistent storage.
Returns
True if such a record exists
field() public ¶
field( string $name , array $conditions = null , string $order = null )
Returns the contents of a single field given the supplied conditions, in the supplied order.
Parameters
- string $name
- Name of field to get
- array $conditions optional null
- SQL conditions (defaults to NULL)
- string $order optional null
- SQL ORDER BY fragment
Returns
field contents, or false if not found
Link
find() public ¶
find( string $type = 'first' , array $query = array() )
Queries the datasource and returns a result set array.
Also used to perform 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' )); }}}
In addition to the standard query keys above, you can provide Datasource, and behavior specific keys. For example, when using a SQL based datasource you can use the joins key to specify additional joins that should be part of the query.
{{{
find('all', array(
'conditions' => array('name' => 'Thomas Anderson'),
'joins' => array(
array(
'alias' => 'Thought',
'table' => 'thoughts',
'type' => 'LEFT',
'conditions' => 'Thought.person_id = Person.id'
)
)
));
}}}
Behaviors and find types can also define custom finder keys which are passed into find().
Specifying 'fields' for 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.
Note: find(list) + database views have issues with MySQL 5.0. Try upgrading to MySQL 5.1 if you have issues with database views.
Parameters
- string $type optional 'first'
- Type of find operation (all / first / count / neighbors / list / threaded)
- array $query optional array()
- Option fields (conditions / fields / joins / limit / offset / order / page / group / callbacks)
Returns
Array of records
Link
getAffectedRows() public ¶
getAffectedRows( )
Returns the number of rows affected by the last query.
Returns
Number of rows
getAssociated() public ¶
getAssociated( string $type = null )
Gets all the models with which this model is associated.
Parameters
- string $type optional null
- Only result associations of this type
Returns
Associations
getColumnType() public ¶
getColumnType( string $column )
Returns the column type of a column in the model.
Parameters
- string $column
- The name of the model column
Returns
Column type
getColumnTypes() public ¶
getColumnTypes( )
Returns an associative array of field names and column types.
Returns
Field types indexed by field name
getID() public ¶
getID( integer $list = 0 )
Returns the current record's ID
Parameters
- integer $list optional 0
- Index on which the composed ID is located
Returns
The ID of the current record, false if no ID
getInsertID() public ¶
getInsertID( )
Returns the ID of the last record this model inserted.
Returns
Last inserted ID
getLastInsertID() public ¶
getLastInsertID( )
Returns the ID of the last record this model inserted.
Returns
Last inserted ID
getNumRows() public ¶
getNumRows( )
Returns the number of rows returned from the last query.
Returns
Number of rows
getVirtualField() public ¶
getVirtualField( string $field = null )
Returns the expression for a model virtual field
Parameters
- string $field optional null
- Name of field to look for
Returns
If $field is string expression bound to virtual field $field If $field is null, returns an array of all model virtual fields or false if none $field exist.
hasAny() public ¶
hasAny( array $conditions = null )
Returns true if a record that meets given conditions exists.
Parameters
- array $conditions optional null
- SQL conditions array
Returns
True if such a record exists
hasField() public ¶
hasField( mixed $name , boolean $checkVirtual = false )
Returns true if the supplied field exists in the model's database table.
Parameters
- mixed $name
- Name of field to look for, or an array of names
- boolean $checkVirtual optional false
- checks if the field is declared as virtual
Returns
If $name is a string, returns a boolean indicating whether the field exists. If $name is an array of field names, returns the first field that exists, or false if none exist.
hasMethod() public ¶
hasMethod( string $method )
Check that a method is callable on a model. This will check both the model's own methods, its inherited methods and methods that could be callable through behaviors.
Parameters
- string $method
- The method to be called.
Returns
True on method being callable.
invalidFields() public ¶
invalidFields( string $options = array() )
Returns an array of fields that have failed validation. On the current model.
Parameters
- string $options optional array()
- An optional array of custom options to be made available in the beforeValidate callback
Returns
Array of invalid fields
See
invalidate() public ¶
invalidate( string $field , mixed $value = true )
Marks a field as invalid, optionally setting the name of validation rule (in case of multiple validation for field) that was broken.
Parameters
- string $field
- The name of the field to invalidate
- mixed $value optional true
Name of validation rule that was not failed, or validation message to be returned. If no validation key is provided, defaults to true.
isForeignKey() public ¶
isForeignKey( string $field )
Returns true if given field name is a foreign key in this model.
Parameters
- string $field
- Returns true if the input string ends in "_id"
Returns
True if the field is a foreign key listed in the belongsTo array.
isUnique() public ¶
isUnique( array $fields , boolean $or = true )
Returns false if any fields passed match any (by default, all if $or = false) of their matching values.
Parameters
- array $fields
- Field/value pairs to search (if no values specified, they are pulled from $this->data)
- boolean $or optional true
- If false, all fields specified must match in order for a false return value
Returns
False if any records matching any fields are found
isVirtualField() public ¶
isVirtualField( string $field )
Returns true if the supplied field is a model Virtual Field
Parameters
- string $field
- Name of field to look for
Returns
indicating whether the field exists as a model virtual field.
joinModel() public ¶
joinModel( string|array $assoc , array $keys = array() )
Gets the name and fields to be used by a join model. This allows specifying join fields in the association definition.
Parameters
- string|array $assoc
- The model to be joined
- array $keys optional array()
- Any join keys which must be merged with the keys queried
Returns
query() public ¶
query( string $sql )
Returns a resultset for a given SQL statement. Custom SQL queries should be performed with this method.
Parameters
- string $sql
- SQL statement
Returns
Resultset
Link
read() public ¶
read( mixed $fields = null , mixed $id = null )
Returns a list of fields from the database, and sets the current model data (Model::$data) with the record found.
Parameters
- mixed $fields optional null
- String of single field name, or an array of field names.
- mixed $id optional null
- The ID of the record to read
Returns
Array of database fields, or false if not found
Link
resetAssociations() public ¶
resetAssociations( )
This resets the association arrays for the model back to those originally defined in the model. Normally called at the end of each call to Model::find()
Returns
Success
save() public ¶
save( array $data = null , mixed $validate = true , array $fieldList = array() )
Saves model data (based on white-list, if supplied) to the database. By default, validation occurs before save.
Parameters
- array $data optional null
- Data to save.
- mixed $validate optional true
Either a boolean, or an array. If a boolean, indicates whether or not to validate before saving. If an array, allows control of validate, callbacks, and fieldList
- array $fieldList optional array()
- List of fields to allow to be written
Returns
On success Model::$data if its not empty or true, false on failure
Link
saveAll() public ¶
saveAll( array $data = null , array $options = array() )
Backwards compatible passthrough method for: saveMany(), validateMany(), saveAssociated() and validateAssociated()
Saves multiple individual records for a single model; Also works with a single record, as well as all its associated records.
Options
- validate: Set to false to disable validation, true to validate each record before saving, 'first' to validate all records before any are saved (default), 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.
- fieldList: Equivalent to the $fieldList parameter in Model::save()
Parameters
- array $data optional null
Record data to save. This can be either a numerically-indexed array (for saving multiple records of the same type), or an array indexed by association name.
- array $options optional array()
- Options to use when saving record data, See $options above.
Returns
If atomic: True on success, or false on failure. Otherwise: array similar to the $data array passed, but values are set to true/false depending on whether each record saved successfully.
Link
saveAssociated() public ¶
saveAssociated( array $data = null , array $options = array() )
Saves a single record, as well as all its directly associated records.
Options
validateSet tofalseto disable validation,trueto validate each record before saving, 'first' to validate all records before any are saved(default),atomicIf true (default), will attempt to save all records in a single transaction. Should be set to false if database/table does not support transactions.fieldListEquivalent to the $fieldList parameter in Model::save()
Parameters
- array $data optional null
- Record data to save. This should be an array indexed by association name.
- array $options optional array()
- Options to use when saving record data, See $options above.
Returns
If atomic: True on success, or false on failure. Otherwise: array similar to the $data array passed, but values are set to true/false depending on whether each record saved successfully.
Link
saveField() public ¶
saveField( string $name , mixed $value , array $validate = false )
Saves the value of a single field to the database, based on the current model ID.
Parameters
- string $name
- Name of the table field
- mixed $value
- Value of the field
- array $validate optional false
- See $options param in Model::save(). Does not respect 'fieldList' key if passed
Returns
See Model::save()
See
Link
saveMany() public ¶
saveMany( array $data = null , array $options = array() )
Saves multiple individual records for a single model
Options
- validate: Set to false to disable validation, true to validate each record before saving, 'first' to validate all records before any are saved (default),
- 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.
- fieldList: Equivalent to the $fieldList parameter in Model::save()
Parameters
- array $data optional null
- Record data to save. This should be a numerically-indexed array
- array $options optional array()
- Options to use when saving record data, See $options above.
Returns
If atomic: True on success, or false on failure. Otherwise: array similar to the $data array passed, but values are set to true/false depending on whether each record saved successfully.
Link
schema() public ¶
schema( mixed $field = false )
Returns an array of table metadata (column names and types) from the database. $field => keys(type, null, default, key, length, extra)
Parameters
- mixed $field optional false
- Set to true to reload schema, or a string to return a specific field
Returns
Array of table metadata
set() public ¶
set( mixed $one , string $two = null )
This function does two things:
- 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.
- 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.)
Parameters
- mixed $one
- Array or string of data
- string $two optional null
- Value string for the alternative indata method
Returns
Data with all of $one's keys and values
Link
setDataSource() public ¶
setDataSource( string $dataSource = null )
Sets the DataSource to which this model is bound.
Parameters
- string $dataSource optional null
- The name of the DataSource, as defined in app/Config/database.php
Returns
True on success
Throws
setInsertID() public ¶
setInsertID( mixed $id )
Sets the ID of the last record this model inserted
Parameters
- mixed $id
- Last inserted ID
setSource() public ¶
setSource( string $tableName )
Sets a custom table for your controller class. Used by your controller to select a database table.
Parameters
- string $tableName
- Name of the custom table
Throws
unbindModel() public ¶
unbindModel( array $params , boolean $reset = true )
Turn off associations on the fly.
If $reset is false, association will not be reset to the originals defined in the model
Example: Turn off the associated Model Support request, to temporarily lighten the User model:
$this->User->unbindModel( array('hasMany' => array('Supportrequest')) );
unbound models that are not made permanent will reset with the next call to Model::find()
Parameters
- array $params
- Set of bindings to unbind (indexed by binding type)
- boolean $reset optional true
- Set to false to make the unbinding permanent
Returns
Success
Link
updateAll() public ¶
updateAll( array $fields , mixed $conditions = true )
Updates multiple model records based on a set of conditions.
Parameters
- array $fields
Set of fields and values, indexed by fields. Fields are treated as SQL snippets, to insert literal values manually escape your data.
- mixed $conditions optional true
- Conditions to match, true for all records
Returns
True on success, false on failure
Link
updateCounterCache() public ¶
updateCounterCache( array $keys = array() , boolean $created = false )
Updates the counter cache of belongsTo associations after a save or delete operation
Parameters
- array $keys optional array()
- Optional foreign key data, defaults to the information $this->data
- boolean $created optional false
True if a new record was created, otherwise only associations with 'counterScope' defined get updated
validateAssociated() public ¶
validateAssociated( array $data , array $options = array() )
Validates a single record, as well as all its directly associated records.
Options
- atomic: If true (default), returns boolean. If false returns array.
- fieldList: Equivalent to the $fieldList parameter in Model::save()
Parameters
- array $data
- Record data to validate. This should be an array indexed by association name.
- array $options optional array()
- Options to use when validating record data (see above), See also $options of validates().
Returns
If atomic: True on success, or false on failure. Otherwise: array similar to the $data array passed, but values are set to true/false depending on whether each record validated successfully.
validateMany() public ¶
validateMany( array $data , array $options = array() )
Validates multiple individual records for a single model
Options
- atomic: If true (default), returns boolean. If false returns array.
- fieldList: Equivalent to the $fieldList parameter in Model::save()
Parameters
- array $data
- Record data to validate. This should be a numerically-indexed array
- array $options optional array()
- Options to use when validating record data (see above), See also $options of validates().
Returns
True on success, or false on failure.
mixed
If atomic: True on success, or false on failure. Otherwise: array similar to the $data array passed, but values are set to true/false depending on whether each record validated successfully.
validates() public ¶
validates( string $options = array() )
Returns true if all fields pass validation. Will validate hasAndBelongsToMany associations that use the 'with' key as well. Since _saveMulti is incapable of exiting a save operation.
Will validate the currently set data. Use Model::set() or Model::create() to set the active data.
Parameters
- string $options optional array()
- An optional array of custom options to be made available in the beforeValidate callback
Returns
True if there are no errors
Methods inherited from Object
_mergeVars() protected ¶
_mergeVars( array $properties , string $class , boolean $normalize = true )
Merges this objects $property with the property in $class' definition. This classes value for the property will be merged on top of $class'
This provides some of the DRY magic CakePHP provides. If you want to shut it off, redefine this method as an empty function.
Parameters
- array $properties
- The name of the properties to merge.
- string $class
- The class to merge the property with.
- boolean $normalize optional true
- Set to true to run the properties through Set::normalize() before merging.
_set() protected ¶
_set( array $properties = array() )
Allows setting of multiple properties of the object in a single line of code. Will only set properties that are part of a class declaration.
Parameters
- array $properties optional array()
- An associative array containing properties and corresponding values.
_stop() protected ¶
_stop( integer|string $status = 0 )
Stop execution of the current script. Wraps exit() making testing easier.
Parameters
- integer|string $status optional 0
- see http://php.net/exit for values
dispatchMethod() public ¶
dispatchMethod( string $method , array $params = array() )
Calls a method on this object with the given parameters. Provides an OO wrapper
for call_user_func_array
Parameters
- string $method
- Name of the method to call
- array $params optional array()
- Parameter list to use when calling $method
Returns
Returns the result of the method call
log() public ¶
log( string $msg , integer $type = LOG_ERROR )
Convenience method to write a message to CakeLog. See CakeLog::write() for more information on writing to logs.
Parameters
- string $msg
- Log message
- integer $type optional LOG_ERROR
- Error type constant. Defined in app/Config/core.php.
Returns
Success of log write
requestAction() public ¶
requestAction( mixed $url , array $extra = array() )
Calls a controller's method from any location. Can be used to connect controllers together or tie plugins into a main application. requestAction can be used to return rendered views or fetch the return value from controller actions.
Under the hood this method uses Router::reverse() to convert the $url parameter into a string URL. You should use URL formats that are compatible with Router::reverse()
Passing POST and GET data
POST and GET data can be simulated in requestAction. Use $extra['url'] for
GET data. The $extra['data'] parameter allows POST data simulation.
Parameters
- mixed $url
String or array-based url. Unlike other url arrays in CakePHP, this url will not automatically handle passed and named arguments in the $url parameter.
- array $extra optional array()
if array includes the key "return" it sets the AutoRender to true. Can also be used to submit GET/POST data, and named/passed arguments.
Returns
Boolean true or false on success/failure, or contents of rendered action if 'return' is set in $extra.
toString() public ¶
toString( )
Object-to-string conversion. Each class can override this method as necessary.
Returns
The name of this class
Properties detail
$hasAndBelongsToMany ¶
AROs are linked to ACOs by means of Permission
array('Aco' => array('with' => 'Permission'))