STRATEGY_JOIN
STRATEGY_JOIN = 'join' : string
Strategy name to use joins for fetching associated records
An Association is a relationship established between two tables and is used to configure and customize the way interconnected records are retrieved.
$_tableLocator : \Cake\ORM\Locator\LocatorInterface
Table locator instance
$_sourceTable : \Cake\ORM\Table
Source table instance
$_targetTable : \Cake\ORM\Table
Target table instance
tableLocator(\Cake\ORM\Locator\LocatorInterface|null $tableLocator = null) : \Cake\ORM\Locator\LocatorInterface
Sets the table locator.
If no parameters are passed, it will return the currently used locator.
| \Cake\ORM\Locator\LocatorInterface|null | $tableLocator | LocatorInterface instance. |
setTableLocator(\Cake\ORM\Locator\LocatorInterface $tableLocator) : $this
Sets the table locator.
| \Cake\ORM\Locator\LocatorInterface | $tableLocator | LocatorInterface instance. |
getTableLocator() : \Cake\ORM\Locator\LocatorInterface
Gets the table locator.
__construct(string $alias, array $options = array())
Constructor. Subclasses can override _options function to get the original list of passed options if expecting any other special key
| string | $alias | The name given to the association |
| array | $options | A list of properties to be set on this object |
cascadeCallbacks(boolean|null $cascadeCallbacks = null) : boolean
Sets whether or not cascaded deletes should also fire callbacks. If no arguments are passed, the current configured value is returned
| boolean|null | $cascadeCallbacks | cascade callbacks switch value |
setClassName(string $className) : $this
Sets the class name of the target table object.
| string | $className | Class name to set. |
In case the class name is set after the target table has been resolved, and it doesn't match the target table's class name.
setSource(\Cake\ORM\Table $table) : $this
Sets the table instance for the source side of the association.
| \Cake\ORM\Table | $table | the instance to be assigned as source side |
getSource() : \Cake\ORM\Table
Gets the table instance for the source side of the association.
source(\Cake\ORM\Table|null $table = null) : \Cake\ORM\Table
Sets the table instance for the source side of the association. If no arguments are passed, the current configured table instance is returned
| \Cake\ORM\Table|null | $table | the instance to be assigned as source side |
setTarget(\Cake\ORM\Table $table) : $this
Sets the table instance for the target side of the association.
| \Cake\ORM\Table | $table | the instance to be assigned as target side |
getTarget() : \Cake\ORM\Table
Gets the table instance for the target side of the association.
target(\Cake\ORM\Table|null $table = null) : \Cake\ORM\Table
Sets the table instance for the target side of the association. If no arguments are passed, the current configured table instance is returned
| \Cake\ORM\Table|null | $table | the instance to be assigned as target side |
conditions(array|null $conditions = null) : array|callable
Sets a list of conditions to be always included when fetching records from the target association. If no parameters are passed the current list is returned
| array|null | $conditions | list of conditions to be used |
setBindingKey(string|array $key) : $this
Sets the name of the field representing the binding field with the target table.
When not manually specified the primary key of the owning side table is used.
| string|array | $key | the table field or fields to be used to link both tables together |
bindingKey(string|null $key = null) : string|array
Sets the name of the field representing the binding field with the target table.
When not manually specified the primary key of the owning side table is used.
If no parameters are passed the current field is returned
| string|null | $key | the table field to be used to link both tables together |
setDependent(boolean $dependent) : $this
Sets whether the records on the target table are dependent on the source table.
This is primarily used to indicate that records should be removed if the owning record in the source table is deleted.
If no parameters are passed the current setting is returned.
| boolean | $dependent | Set the dependent mode. Use null to read the current state. |
dependent(boolean|null $dependent = null) : boolean
Sets whether the records on the target table are dependent on the source table.
This is primarily used to indicate that records should be removed if the owning record in the source table is deleted.
If no parameters are passed the current setting is returned.
| boolean|null | $dependent | Set the dependent mode. Use null to read the current state. |
property(string|null $name = null) : string
Sets the property name that should be filled with data from the target table in the source table record.
If no arguments are passed, the currently configured type is returned.
| string|null | $name | The name of the association property. Use null to read the current value. |
setStrategy(string $name) : $this
Sets the strategy name to be used to fetch associated records. Keep in mind that some association types might not implement but a default strategy, rendering any changes to this setting void.
| string | $name | The strategy type. Use null to read the current value. |
When an invalid strategy is provided.
strategy(string|null $name = null) : string
Sets the strategy name to be used to fetch associated records. Keep in mind that some association types might not implement but a default strategy, rendering any changes to this setting void.
If no arguments are passed, the currently configured strategy is returned.
| string|null | $name | The strategy type. Use null to read the current value. |
When an invalid strategy is provided.
attachTo(\Cake\ORM\Query $query, array $options = array()) : void
Alters a Query object to include the associated target table data in the final result
The options array accept the following keys:
| \Cake\ORM\Query | $query | the query to be altered to include the target table data |
| array | $options | Any extra options or overrides to be taken in account |
if the query builder passed does not return a query object
transformRow(array $row, string $nestKey, boolean $joined, string|null $targetProperty = null) : array
Correctly nests a result row associated values into the correct array keys inside the source results.
| array | $row | The row to transform |
| string | $nestKey | The array key under which the results for this association should be found |
| boolean | $joined | Whether or not the row is a result of a direct join with this association |
| string|null | $targetProperty | The property name in the source results where the association data shuld be nested in. Will use the default one if not provided. |
defaultRowValue(array $row, boolean $joined) : array
Returns a modified row after appending a property for this association with the default empty value according to whether the association was joined or fetched externally.
| array | $row | The row to set a default on. |
| boolean | $joined | Whether or not the row is a result of a direct join with this association |
find(string|array|null $type = null, array $options = array()) : \Cake\ORM\Query
Proxies the finding operation to the target table's find method and modifies the query accordingly based of this association configuration
| string|array|null | $type | the type of query to perform, if an array is passed,
it will be interpreted as the |
| array | $options | The options to for the find |
exists(array|callable|\Cake\Database\ExpressionInterface $conditions) : boolean
Proxies the operation to the target table's exists method after appending the default conditions for this association
| array|callable|\Cake\Database\ExpressionInterface | $conditions | The conditions to use for checking if any record matches. |
updateAll(array $fields, mixed $conditions) : integer
Proxies the update operation to the target table's updateAll method
| array | $fields | A hash of field => new value. |
| mixed | $conditions | Conditions to be used, accepts anything Query::where() can take. |
Count Returns the affected rows.
requiresKeys(array $options = array()) : boolean
Returns true if the eager loading process will require a set of the owning table's binding keys in order to use them as a filter in the finder query.
| array | $options | The options containing the strategy to be used. |
true if a list of keys will be required
__get(string $property) : \Cake\ORM\Association
Proxies property retrieval to the target table. This is handy for getting this association's associations
| string | $property | the property name |
if no association with such name exists
eagerLoader(array $options) : \Closure
Eager loads a list of records in the target table that are related to another set of records in the source table. Source records can specified in two ways: first one is by passing a Query object setup to find on the source table and the other way is by explicitly passing an array of primary key values from the source table.
The required way of passing related source records is controlled by "strategy" When the subquery strategy is used it will require a query on the source table. When using the select strategy, the list of primary keys will be used.
Returns a closure that should be run for each record returned in a specific Query. This callable will be responsible for injecting the fields that are related to each specific passed row.
Options array accepts the following keys:
| array | $options | The options for eager loading. |
cascadeDelete(\Cake\Datasource\EntityInterface $entity, array $options = array()) : boolean
Handles cascading a delete from an associated model.
Each implementing class should handle the cascaded delete as required.
| \Cake\Datasource\EntityInterface | $entity | The entity that started the cascaded delete. |
| array | $options | The options for the original delete. |
Success
isOwningSide(\Cake\ORM\Table $side) : boolean
Returns whether or not the passed table is the owning side for this association. This means that rows in the 'target' table would miss important or required information if the row in 'source' did not exist.
| \Cake\ORM\Table | $side | The potential Table with ownership |
saveAssociated(\Cake\Datasource\EntityInterface $entity, array $options = array()) : boolean|\Cake\Datasource\EntityInterface
Extract the target's association data our from the passed entity and proxies the saving operation to the target table.
| \Cake\Datasource\EntityInterface | $entity | the data to be saved |
| array | $options | The options for saving associated data. |
false if $entity could not be saved, otherwise it returns the saved entity
_appendNotMatching(\Cake\Datasource\QueryInterface $query, array $options) : void
Conditionally adds a condition to the passed Query that will make it find records where there is no match with this association.
| \Cake\Datasource\QueryInterface | $query | The query to modify |
| array | $options | Options array containing the |
_dispatchBeforeFind(\Cake\ORM\Query $query) : void
Triggers beforeFind on the target table for the query this association is attaching to
| \Cake\ORM\Query | $query | the query this association is attaching itself to |
_appendFields(\Cake\ORM\Query $query, \Cake\ORM\Query $surrogate, array $options) : void
Helper function used to conditionally append fields to the select clause of a query from the fields found in another query object.
| \Cake\ORM\Query | $query | the query that will get the fields appended to |
| \Cake\ORM\Query | $surrogate | the query having the fields to be copied from |
| array | $options | options passed to the method |
_formatAssociationResults(\Cake\ORM\Query $query, \Cake\ORM\Query $surrogate, array $options) : void
Adds a formatter function to the passed `$query` if the `$surrogate` query declares any other formatter. Since the `$surrogate` query correspond to the associated target table, the resulting formatter will be the result of applying the surrogate formatters to only the property corresponding to such table.
| \Cake\ORM\Query | $query | the query that will get the formatter applied to |
| \Cake\ORM\Query | $surrogate | the query having formatters for the associated target table. |
| array | $options | options passed to the method |
_bindNewAssociations(\Cake\ORM\Query $query, \Cake\ORM\Query $surrogate, array $options) : void
Applies all attachable associations to `$query` out of the containments found in the `$surrogate` query.
Copies all contained associations from the $surrogate query into the
passed $query. Containments are altered so that they respect the associations
chain from which they originated.
| \Cake\ORM\Query | $query | the query that will get the associations attached to |
| \Cake\ORM\Query | $surrogate | the query having the containments to be attached |
| array | $options | options passed to the method |
_joinCondition(array $options) : array
Returns a single or multiple conditions to be appended to the generated join clause for getting the results on the target table.
| array | $options | list of options passed to attachTo method |
if the number of columns in the foreignKey do not match the number of columns in the source table primaryKey
_extractFinder(string|array $finderData) : array
Helper method to infer the requested finder and its options.
Returns the inferred options from the finder $type.
The following will call the finder 'translations' with the value of the finder as its options: $query->contain(['Comments' => ['finder' => ['translations']]]); $query->contain(['Comments' => ['finder' => ['translations' => []]]]); $query->contain(['Comments' => ['finder' => ['translations' => ['locales' => ['en_US']]]]]);
| string|array | $finderData | The finder name or an array having the name as key and options as value. |