W3cubDocs

/CakePHP 3.8

Class Association

An Association is a relationship established between two tables and is used to configure and customize the way interconnected records are retrieved.

Cake\ORM\Association uses Cake\Core\ConventionsTrait , Cake\ORM\Locator\LocatorAwareTrait

Direct Subclasses

Abstract
Namespace: Cake\ORM
Mixin: \Cake\ORM\Table
Location: ORM/Association.php

Constants summary

  • string

    MANY_TO_MANY
    'manyToMany'
  • string

    MANY_TO_ONE
    'manyToOne'
  • string

    ONE_TO_MANY
    'oneToMany'
  • string

    ONE_TO_ONE
    'oneToOne'
  • string

    STRATEGY_JOIN
    'join'
  • string

    STRATEGY_SELECT
    'select'
  • string

    STRATEGY_SUBQUERY
    'subquery'

Properties summary

  • $_bindingKey protected
    string|array
    The field name in the owning side table that is used to match with the foreignKey
  • $_cascadeCallbacks protected
    boolean
    Whether or not cascaded deletes should also fire callbacks.
  • $_className protected
    string
    The class name of the target table object
  • $_conditions protected
    array|callable

    A list of conditions to be always included when fetching records from the target association

  • $_dependent protected
    boolean

    Whether the records on the target table are dependent on the source table, often used to indicate that records should be removed if the owning record in the source table is deleted.

  • $_finder protected
    string|array

    The default finder name to use for fetching rows from the target table With array value, finder name and default options are allowed.

  • $_foreignKey protected
    string|array
    The name of the field representing the foreign key to the table to load
  • $_joinType protected
    string
    The type of join to be used when adding the association to a query
  • $_name protected
    string

    Name given to the association, it usually represents the alias assigned to the target associated table

  • $_propertyName protected
    string

    The property name that should be filled with data from the target table in the source table record.

  • $_sourceTable protected
    Source table instance
  • $_strategy protected
    string

    The strategy name to be used to fetch associated records. Some association types might not implement but one strategy to fetch records.

  • $_targetTable protected
    Target table instance
  • $_validStrategies protected
    array
    Valid strategies for this association. Subclasses can narrow this down.

Inherited Properties

Method Summary

  • __call() public
    Proxies method calls to the target table.
  • __construct() public

    Constructor. Subclasses can override _options function to get the original list of passed options if expecting any other special key

  • __get() public

    Proxies property retrieval to the target table. This is handy for getting this association's associations

  • __isset() public

    Proxies the isset call to the target table. This is handy to check if the target table has another association with the passed name

  • _appendFields() protected

    Helper function used to conditionally append fields to the select clause of a query from the fields found in another query object.

  • Conditionally adds a condition to the passed Query that will make it find records where there is no match with this association.

  • Applies all attachable associations to $query out of the containments found in the $surrogate query.

  • Triggers beforeFind on the target table for the query this association is attaching to

  • _extractFinder() protected
    Helper method to infer the requested finder and its options.
  • 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.

  • _getClassName() protected
    Gets the table class name.
  • _joinCondition() protected

    Returns a single or multiple conditions to be appended to the generated join clause for getting the results on the target table.

  • _options() protected

    Override this function to initialize any concrete association class, it will get passed the original list of options used in the constructor

  • _propertyName() protected
    Returns default property name based on association name.
  • attachTo() public

    Alters a Query object to include the associated target table data in the final result

  • bindingKey() public deprecated

    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.

  • canBeJoined() public
    Whether this association can be expressed directly in a query join
  • cascadeCallbacks() public deprecated

    Sets whether or not cascaded deletes should also fire callbacks. If no arguments are passed, the current configured value is returned

  • cascadeDelete() abstract public
    Handles cascading a delete from an associated model.
  • className() public deprecated
    The class name of the target table object
  • conditions() public deprecated

    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

  • 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.

  • deleteAll() public
    Proxies the delete operation to the target table's deleteAll method
  • dependent() public deprecated
    Sets whether the records on the target table are dependent on the source table.
  • eagerLoader() abstract public

    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.

  • exists() public

    Proxies the operation to the target table's exists method after appending the default conditions for this association

  • find() public

    Proxies the finding operation to the target table's find method and modifies the query accordingly based of this association configuration

  • finder() public deprecated

    Sets the default finder to use for fetching rows from the target table. If no parameters are passed, it will return the currently configured finder name.

  • foreignKey() public deprecated

    Sets the name of the field representing the foreign key to the target table. If no parameters are passed the current field is returned

  • Gets 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.

  • Gets whether or not cascaded deletes should also fire callbacks.
  • Gets the class name of the target table object.
  • Gets a list of conditions to be always included when fetching records from the target association.

  • Sets whether the records on the target table are dependent on the source table.
  • getFinder() public
    Gets the default finder to use for fetching rows from the target table.
  • Gets the name of the field representing the foreign key to the target table.
  • getJoinType() public
    Gets the type of join to be used when adding the association to a query.
  • getName() public

    Gets the name for this association, usually the alias assigned to the target associated table

  • getProperty() public

    Gets the property name that should be filled with data from the target table in the source table record.

  • getSource() public
    Gets the table instance for the source side of the association.
  • getStrategy() public

    Gets 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.

  • getTarget() public
    Gets the table instance for the target side of the association.
  • isOwningSide() abstract public

    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.

  • joinType() public deprecated

    Sets the type of join to be used when adding the association to a query. If no arguments are passed, the currently configured type is returned.

  • name() public deprecated
    Sets the name for this association.
  • property() public deprecated

    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.

  • 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.

  • saveAssociated() abstract public

    Extract the target's association data our from the passed entity and proxies the saving operation to the target table.

  • 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.

  • Sets whether or not cascaded deletes should also fire callbacks.
  • Sets the class name of the target table object.
  • Sets a list of conditions to be always included when fetching records from the target association.

  • Sets whether the records on the target table are dependent on the source table.
  • setFinder() public
    Sets the default finder to use for fetching rows from the target table.
  • Sets the name of the field representing the foreign key to the target table.
  • setJoinType() public
    Sets the type of join to be used when adding the association to a query.
  • setName() public

    Sets the name for this association, usually the alias assigned to the target associated table

  • setProperty() public

    Sets the property name that should be filled with data from the target table in the source table record.

  • setSource() public
    Sets the table instance for the source side of the association.
  • setStrategy() public

    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.

  • setTarget() public
    Sets the table instance for the target side of the association.
  • source() public deprecated

    Sets the table instance for the source side of the association. If no arguments are passed, the current configured table instance is returned

  • strategy() public deprecated

    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.

  • target() public deprecated

    Sets the table instance for the target side of the association. If no arguments are passed, the current configured table instance is returned

  • Correctly nests a result row associated values into the correct array keys inside the source results.

  • type() abstract public
    Get the relationship type.
  • updateAll() public
    Proxies the update operation to the target table's updateAll method

Method Detail

__call()source public

__call( string $method , array $argument )

Proxies method calls to the target table.

Parameters

string $method
name of the method to be invoked
array $argument
List of arguments passed to the function

Returns

mixed

Throws

BadMethodCallException

__construct()source public

__construct( string $alias , array $options = [] )

Constructor. Subclasses can override _options function to get the original list of passed options if expecting any other special key

Parameters

string $alias
The name given to the association
array $options optional []
A list of properties to be set on this object

__get()source public

__get( string $property )

Proxies property retrieval to the target table. This is handy for getting this association's associations

Parameters

string $property
the property name

Returns

Cake\ORM\Association

Throws

RuntimeException
if no association with such name exists

__isset()source public

__isset( string $property )

Proxies the isset call to the target table. This is handy to check if the target table has another association with the passed name

Parameters

string $property
the property name

Returns

boolean
true if the property exists

_appendFields()source protected

_appendFields( Cake\ORM\Query $query , Cake\ORM\Query $surrogate , array $options )

Helper function used to conditionally append fields to the select clause of a query from the fields found in another query object.

Parameters

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 attachTo

_appendNotMatching()source protected

_appendNotMatching( Cake\Datasource\QueryInterface $query , array $options )

Conditionally adds a condition to the passed Query that will make it find records where there is no match with this association.

Parameters

Cake\Datasource\QueryInterface $query
The query to modify
array $options
Options array containing the negateMatch key.

_bindNewAssociations()source protected

_bindNewAssociations( Cake\ORM\Query $query , Cake\ORM\Query $surrogate , array $options )

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.

Parameters

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 attachTo

_dispatchBeforeFind()source protected

_dispatchBeforeFind( Cake\ORM\Query $query )

Triggers beforeFind on the target table for the query this association is attaching to

Parameters

Cake\ORM\Query $query
the query this association is attaching itself to

_extractFinder()source protected

_extractFinder( string|array $finderData )

Helper method to infer the requested finder and its options.

Returns the inferred options from the finder $type.

Examples:

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']]]]]);

Parameters

string|array $finderData

The finder name or an array having the name as key and options as value.

Returns

array

_formatAssociationResults()source protected

_formatAssociationResults( Cake\ORM\Query $query , Cake\ORM\Query $surrogate , array $options )

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.

Parameters

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 attachTo

_getClassName()source protected

_getClassName( string $alias , array $options = [] )

Gets the table class name.

Parameters

string $alias
The alias name you want to get.
array $options optional []
Table options array.

Returns

string

_joinCondition()source protected

_joinCondition( array $options )

Returns a single or multiple conditions to be appended to the generated join clause for getting the results on the target table.

Parameters

array $options
list of options passed to attachTo method

Returns

array

Throws

RuntimeException

if the number of columns in the foreignKey do not match the number of columns in the source table primaryKey


_options()source protected

_options( array $options )

Override this function to initialize any concrete association class, it will get passed the original list of options used in the constructor

Parameters

array $options
List of options used for initialization

_propertyName()source protected

_propertyName( )

Returns default property name based on association name.

Returns

string

attachTo()source public

attachTo( Cake\ORM\Query $query , array $options = [] )

Alters a Query object to include the associated target table data in the final result

The options array accept the following keys:

  • includeFields: Whether to include target model fields in the result or not
  • foreignKey: The name of the field to use as foreign key, if false none will be used
  • conditions: array with a list of conditions to filter the join with, this will be merged with any conditions originally configured for this association
  • fields: a list of fields in the target table to include in the result
  • type: The type of join to be used (e.g. INNER) the records found on this association
  • aliasPath: A dot separated string representing the path of association names followed from the passed query main table to this association.
  • propertyPath: A dot separated string representing the path of association properties to be followed from the passed query main entity to this association
  • joinType: The SQL join type to use in the query.
  • negateMatch: Will append a condition to the passed query for excluding matches. with this association.

Parameters

Cake\ORM\Query $query
the query to be altered to include the target table data
array $options optional []
Any extra options or overrides to be taken in account

Throws

RuntimeException

if the query builder passed does not return a query object


bindingKey()source public deprecated

bindingKey( string|null $key = null )

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

Deprecated

3.4.0 Use setBindingKey()/getBindingKey() instead.

Parameters

string|null $key optional null
the table field to be used to link both tables together

Returns

string|array

canBeJoined()source public

canBeJoined( array $options = [] )

Whether this association can be expressed directly in a query join

Parameters

array $options optional []
custom options key that could alter the return value

Returns

boolean

cascadeCallbacks()source public deprecated

cascadeCallbacks( boolean|null $cascadeCallbacks = null )

Sets whether or not cascaded deletes should also fire callbacks. If no arguments are passed, the current configured value is returned

Deprecated

3.4.0 Use setCascadeCallbacks()/getCascadeCallbacks() instead.

Parameters

boolean|null $cascadeCallbacks optional null
cascade callbacks switch value

Returns

boolean

cascadeDelete()source abstract public

cascadeDelete( Cake\Datasource\EntityInterface $entity , array $options = [] )

Handles cascading a delete from an associated model.

Each implementing class should handle the cascaded delete as required.

Parameters

Cake\Datasource\EntityInterface $entity
The entity that started the cascaded delete.
array $options optional []
The options for the original delete.

Returns

boolean
Success

className()source public deprecated

className( )

The class name of the target table object

Deprecated

3.7.0 Use getClassName() instead.

Returns

string

conditions()source public deprecated

conditions( array|null $conditions = null )

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

Deprecated

3.4.0 Use setConditions()/getConditions() instead.

Parameters

array|null $conditions optional null
list of conditions to be used

Returns

array|callable

See

\Cake\Database\Query::where() for examples on the format of the array

defaultRowValue()source public

defaultRowValue( array $row , boolean $joined )

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.

Parameters

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

Returns

array

deleteAll()source public

deleteAll( mixed $conditions )

Proxies the delete operation to the target table's deleteAll method

Parameters

mixed $conditions

Conditions to be used, accepts anything Query::where() can take.

Returns

integer
Returns the number of affected rows.

See

\Cake\ORM\Table::deleteAll()

dependent()source public deprecated

dependent( boolean|null $dependent = null )

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.

Deprecated

3.4.0 Use setDependent()/getDependent() instead.

Parameters

boolean|null $dependent optional null
Set the dependent mode. Use null to read the current state.

Returns

boolean

eagerLoader()source abstract public

eagerLoader( array $options )

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:

  • query: Query object setup to find the source table records
  • keys: List of primary key values from the source table
  • foreignKey: The name of the field used to relate both tables
  • conditions: List of conditions to be passed to the query where() method
  • sort: The direction in which the records should be returned
  • fields: List of fields to select from the target table
  • contain: List of related tables to eager load associated to the target table
  • strategy: The name of strategy to use for finding target table records
  • nestKey: The array key under which results will be found when transforming the row

Parameters

array $options
The options for eager loading.

Returns

Closure

exists()source public

exists( array|callable|Cake\Database\ExpressionInterface $conditions )

Proxies the operation to the target table's exists method after appending the default conditions for this association

Parameters

array|callable|Cake\Database\ExpressionInterface $conditions

The conditions to use for checking if any record matches.

Returns

boolean

See

\Cake\ORM\Table::exists()

find()source public

find( string|array|null $type = null , array $options = [] )

Proxies the finding operation to the target table's find method and modifies the query accordingly based of this association configuration

Parameters

string|array|null $type optional null

the type of query to perform, if an array is passed, it will be interpreted as the $options parameter

array $options optional []
The options to for the find

Returns

Cake\ORM\Query

See

\Cake\ORM\Table::find()

finder()source public deprecated

finder( string|null $finder = null )

Sets the default finder to use for fetching rows from the target table. If no parameters are passed, it will return the currently configured finder name.

Deprecated

3.4.0 Use setFinder()/getFinder() instead.

Parameters

string|null $finder optional null
the finder name to use

Returns

string|array

foreignKey()source public deprecated

foreignKey( string|null $key = null )

Sets the name of the field representing the foreign key to the target table. If no parameters are passed the current field is returned

Deprecated

3.4.0 Use setForeignKey()/getForeignKey() instead.

Parameters

string|null $key optional null
the key to be used to link both tables together

Returns

string|array

getBindingKey()source public

getBindingKey( )

Gets 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.

Returns

string|array

getCascadeCallbacks()source public

getCascadeCallbacks( )

Gets whether or not cascaded deletes should also fire callbacks.

Returns

boolean

getClassName()source public

getClassName( )

Gets the class name of the target table object.

Returns

string

getConditions()source public

getConditions( )

Gets a list of conditions to be always included when fetching records from the target association.

Returns

array|callable

See

\Cake\Database\Query::where() for examples on the format of the array

getDependent()source public

getDependent( )

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.

Returns

boolean

getFinder()source public

getFinder( )

Gets the default finder to use for fetching rows from the target table.

Returns

string|array

getForeignKey()source public

getForeignKey( )

Gets the name of the field representing the foreign key to the target table.

Returns

string|array

getJoinType()source public

getJoinType( )

Gets the type of join to be used when adding the association to a query.

Returns

string

getName()source public

getName( )

Gets the name for this association, usually the alias assigned to the target associated table

Returns

string

getProperty()source public

getProperty( )

Gets the property name that should be filled with data from the target table in the source table record.

Returns

string

getSource()source public

getSource( )

Gets the table instance for the source side of the association.

Returns

Cake\ORM\Table

getStrategy()source public

getStrategy( )

Gets 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.

Returns

string

getTarget()source public

getTarget( )

Gets the table instance for the target side of the association.

Returns

Cake\ORM\Table

isOwningSide()source abstract public

isOwningSide( Cake\ORM\Table $side )

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.

Parameters

Cake\ORM\Table $side
The potential Table with ownership

Returns

boolean

joinType()source public deprecated

joinType( string|null $type = null )

Sets the type of join to be used when adding the association to a query. If no arguments are passed, the currently configured type is returned.

Deprecated

3.4.0 Use setJoinType()/getJoinType() instead.

Parameters

string|null $type optional null
the join type to be used (e.g. INNER)

Returns

string

name()source public deprecated

name( string|null $name = null )

Sets the name for this association.

Deprecated

3.4.0 Use setName()/getName() instead.

Parameters

string|null $name optional null
Name to be assigned

Returns

string

property()source public deprecated

property( string|null $name = null )

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.

Deprecated

3.4.0 Use setProperty()/getProperty() instead.

Parameters

string|null $name optional null
The name of the association property. Use null to read the current value.

Returns

string

requiresKeys()source public

requiresKeys( array $options = [] )

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.

Parameters

array $options optional []
The options containing the strategy to be used.

Returns

boolean
true if a list of keys will be required

saveAssociated()source abstract public

saveAssociated( Cake\Datasource\EntityInterface $entity , array $options = [] )

Extract the target's association data our from the passed entity and proxies the saving operation to the target table.

Parameters

Cake\Datasource\EntityInterface $entity
the data to be saved
array $options optional []
The options for saving associated data.

Returns

boolean|Cake\Datasource\EntityInterface

false if $entity could not be saved, otherwise it returns the saved entity


See

\Cake\ORM\Table::save()

setBindingKey()source public

setBindingKey( string|array $key )

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.

Parameters

string|array $key
the table field or fields to be used to link both tables together

Returns


$this

setCascadeCallbacks()source public

setCascadeCallbacks( boolean $cascadeCallbacks )

Sets whether or not cascaded deletes should also fire callbacks.

Parameters

boolean $cascadeCallbacks
cascade callbacks switch value

Returns


$this

setClassName()source public

setClassName( string $className )

Sets the class name of the target table object.

Parameters

string $className
Class name to set.

Returns


$this

Throws

InvalidArgumentException

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.


setConditions()source public

setConditions( array|callable $conditions )

Sets a list of conditions to be always included when fetching records from the target association.

Parameters

array|callable $conditions
list of conditions to be used

Returns


$this

See

\Cake\Database\Query::where() for examples on the format of the array

setDependent()source public

setDependent( boolean $dependent )

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.

Parameters

boolean $dependent
Set the dependent mode. Use null to read the current state.

Returns


$this

setFinder()source public

setFinder( string|array $finder )

Sets the default finder to use for fetching rows from the target table.

Parameters

string|array $finder
the finder name to use or array of finder name and option.

Returns


$this

setForeignKey()source public

setForeignKey( string|array $key )

Sets the name of the field representing the foreign key to the target table.

Parameters

string|array $key
the key or keys to be used to link both tables together

Returns


$this

setJoinType()source public

setJoinType( string $type )

Sets the type of join to be used when adding the association to a query.

Parameters

string $type
the join type to be used (e.g. INNER)

Returns


$this

setName()source public

setName( string $name )

Sets the name for this association, usually the alias assigned to the target associated table

Parameters

string $name
Name to be assigned

Returns


$this

setProperty()source public

setProperty( string $name )

Sets the property name that should be filled with data from the target table in the source table record.

Parameters

string $name
The name of the association property. Use null to read the current value.

Returns


$this

setSource()source public

setSource( Cake\ORM\Table $table )

Sets the table instance for the source side of the association.

Parameters

Cake\ORM\Table $table
the instance to be assigned as source side

Returns


$this

setStrategy()source public

setStrategy( string $name )

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.

Parameters

string $name
The strategy type. Use null to read the current value.

Returns


$this

Throws

InvalidArgumentException
When an invalid strategy is provided.

setTarget()source public

setTarget( Cake\ORM\Table $table )

Sets the table instance for the target side of the association.

Parameters

Cake\ORM\Table $table
the instance to be assigned as target side

Returns


$this

source()source public deprecated

source( Cake\ORM\Table $table = null )

Sets the table instance for the source side of the association. If no arguments are passed, the current configured table instance is returned

Deprecated

3.4.0 Use setSource()/getSource() instead.

Parameters

Cake\ORM\Table $table optional null
the instance to be assigned as source side

Returns

Cake\ORM\Table

strategy()source public deprecated

strategy( string|null $name = null )

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.

Deprecated

3.4.0 Use setStrategy()/getStrategy() instead.

Parameters

string|null $name optional null
The strategy type. Use null to read the current value.

Returns

string

Throws

InvalidArgumentException
When an invalid strategy is provided.

target()source public deprecated

target( Cake\ORM\Table $table = null )

Sets the table instance for the target side of the association. If no arguments are passed, the current configured table instance is returned

Deprecated

3.4.0 Use setTarget()/getTarget() instead.

Parameters

Cake\ORM\Table $table optional null
the instance to be assigned as target side

Returns

Cake\ORM\Table

transformRow()source public

transformRow( array $row , string $nestKey , boolean $joined , string|null $targetProperty = null )

Correctly nests a result row associated values into the correct array keys inside the source results.

Parameters

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 optional null

The property name in the source results where the association data shuld be nested in. Will use the default one if not provided.

Returns

array

type()source abstract public

type( )

Get the relationship type.

Returns

string
Constant of either ONE_TO_ONE, MANY_TO_ONE, ONE_TO_MANY or MANY_TO_MANY.

updateAll()source public

updateAll( array $fields , mixed $conditions )

Proxies the update operation to the target table's updateAll method

Parameters

array $fields
A hash of field => new value.
mixed $conditions

Conditions to be used, accepts anything Query::where() can take.

Returns

integer
Count Returns the affected rows.

See

\Cake\ORM\Table::updateAll()

Methods used from Cake\Core\ConventionsTrait

_camelize()source protected

_camelize( string $name )

Creates a camelized version of $name

Parameters

string $name
name

Returns

string
Camelized name

_entityName()source protected

_entityName( string $name )

Creates the proper entity name (singular) for the specified name

Parameters

string $name
Name

Returns

string
Camelized and plural model name

_fixtureName()source protected

_fixtureName( string $name )

Creates a fixture name

Parameters

string $name
Model class name

Returns

string
Singular model key

_modelKey()source protected

_modelKey( string $name )

Creates the proper underscored model key for associations

If the input contains a dot, assume that the right side is the real table name.

Parameters

string $name
Model class name

Returns

string
Singular model key

_modelNameFromKey()source protected

_modelNameFromKey( string $key )

Creates the proper model name from a foreign key

Parameters

string $key
Foreign key

Returns

string
Model name

_pluginNamespace()source protected

_pluginNamespace( string $pluginName )

Return plugin's namespace

Parameters

string $pluginName
Plugin name

Returns

string
Plugin's namespace

_pluginPath()source protected

_pluginPath( string $pluginName )

Find the correct path for a plugin. Scans $pluginPaths for the plugin you want.

Parameters

string $pluginName
Name of the plugin you want ie. DebugKit

Returns

string
path path to the correct plugin.

_pluralHumanName()source protected

_pluralHumanName( string $name )

Creates the plural human name used in views

Parameters

string $name
Controller name

Returns

string
Plural human name

_singularHumanName()source protected

_singularHumanName( string $name )

Creates the singular human name used in views

Parameters

string $name
Controller name

Returns

string
Singular human name

_singularName()source protected

_singularName( string $name )

Creates the singular name for use in views.

Parameters

string $name
Name to use

Returns

string
Variable name

_variableName()source protected

_variableName( string $name )

Creates the plural variable name for views

Parameters

string $name
Name to use

Returns

string
Plural name for views

Methods used from Cake\ORM\Locator\LocatorAwareTrait

getTableLocator()source public

getTableLocator( )

Gets the table locator.

Returns

Cake\ORM\Locator\LocatorInterface

setTableLocator()source public

setTableLocator( Cake\ORM\Locator\LocatorInterface $tableLocator )

Sets the table locator.

Parameters

Cake\ORM\Locator\LocatorInterface $tableLocator
LocatorInterface instance.

Returns


$this

tableLocator()source public deprecated

tableLocator( Cake\ORM\Locator\LocatorInterface $tableLocator = null )

Sets the table locator. If no parameters are passed, it will return the currently used locator.

Deprecated

3.5.0 Use getTableLocator()/setTableLocator() instead.

Parameters

Cake\ORM\Locator\LocatorInterface $tableLocator optional null
LocatorInterface instance.

Returns

Cake\ORM\Locator\LocatorInterface

Properties detail

$_bindingKeysource

protected string|array

The field name in the owning side table that is used to match with the foreignKey

$_cascadeCallbackssource

protected boolean

Whether or not cascaded deletes should also fire callbacks.

false

$_classNamesource

protected string

The class name of the target table object

$_conditionssource

protected array|callable

A list of conditions to be always included when fetching records from the target association

[]

$_dependentsource

protected boolean

Whether the records on the target table are dependent on the source table, often used to indicate that records should be removed if the owning record in the source table is deleted.

false

$_findersource

protected string|array

The default finder name to use for fetching rows from the target table With array value, finder name and default options are allowed.

'all'

$_foreignKeysource

protected string|array

The name of the field representing the foreign key to the table to load

$_joinTypesource

protected string

The type of join to be used when adding the association to a query

Cake\ORM\QueryInterface::JOIN_TYPE_LEFT

$_namesource

protected string

Name given to the association, it usually represents the alias assigned to the target associated table

$_propertyNamesource

protected string

The property name that should be filled with data from the target table in the source table record.

$_sourceTablesource

protected Cake\ORM\Table

Source table instance

$_strategysource

protected string

The strategy name to be used to fetch associated records. Some association types might not implement but one strategy to fetch records.

self::STRATEGY_JOIN

$_targetTablesource

protected Cake\ORM\Table

Target table instance

$_validStrategiessource

protected array

Valid strategies for this association. Subclasses can narrow this down.

[
    self::STRATEGY_JOIN,
    self::STRATEGY_SELECT,
    self::STRATEGY_SUBQUERY
]

© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/3.8/class-Cake.ORM.Association.html