Class CounterCacheBehavior
CounterCache behavior
Enables models to cache the amount of connections in a given relation.
Examples with Post model belonging to User model
Regular counter cache
[
'Users' => [
'post_count'
]
]Counter cache with scope
[
'Users' => [
'posts_published' => [
'conditions' => [
'published' => true
]
]
]
]Counter cache using custom find
[
'Users' => [
'posts_published' => [
'finder' => 'published' // Will be using findPublished()
]
]
]Counter cache using lambda function returning the count This is equivalent to example #2
[
'Users' => [
'posts_published' => function (Event $event, EntityInterface $entity, Table $table) {
$query = $table->find('all')->where([
'published' => true,
'user_id' => $entity->get('user_id')
]);
return $query->count();
}
]
]Ignore updating the field if it is dirty
[
'Users' => [
'posts_published' => [
'ignoreDirty' => true
]
]
]Property Summary
-
$_config protected
arrayRuntime config
-
$_configInitialized protected
boolWhether the config property has already been configured with defaults
-
$_defaultConfig protected
arrayDefault configuration
-
$_ignoreDirty protected
arrayStore the fields which should be ignored
-
$_reflectionCache protected static
arrayReflection method cache for behaviors.
-
$_table protected
Cake\ORM\TableTable instance.
Method Summary
-
__construct() public
Constructor
-
_configDelete() protected
Delete a single config key
-
_configRead() protected
Read a config variable
-
_configWrite() protected
Write a config variable
-
_getCount() protected
Fetches and returns the count for a single field in an association
-
_processAssociation() protected
Updates counter cache for a single association
-
_processAssociations() protected
Iterate all associations and update counter caches.
-
_reflectionCache() protected
Gets the methods implemented by this behavior
-
_resolveMethodAliases() protected
Removes aliased methods that would otherwise be duplicated by userland configuration.
-
afterDelete() public
afterDelete callback.
-
afterSave() public
afterSave callback.
-
beforeSave() public
beforeSave callback.
-
config() public
Usage
-
configShallow() public
Merge provided config with existing config. Unlike
config()which does a recursive merge for nested keys, this method does a simple merge. -
implementedEvents() public
Gets the Model callbacks this behavior is interested in.
-
implementedFinders() public
implementedFinders
-
implementedMethods() public
implementedMethods
-
initialize() public
Constructor hook method.
-
verifyConfig() public
verifyConfig
Method Detail
__construct() ¶ public
__construct(Cake\ORM\Table $table, array $config = [])Constructor
Merges config with the default and store in the config property
Parameters
-
Cake\ORM\Table$table The table this behavior is attached to.
-
array$config optional The config for this behavior.
_configDelete() ¶ protected
_configDelete(string $key): voidDelete a single config key
Parameters
-
string$key Key to delete.
Returns
voidThrows
Cake\Core\Exception\Exceptionif attempting to clobber existing config
_configRead() ¶ protected
_configRead(string|null $key): mixedRead a config variable
Parameters
-
string|null$key Key to read.
Returns
mixed_configWrite() ¶ protected
_configWrite(string|array $key, mixed $value, bool|string $merge = false): voidWrite a config variable
Parameters
-
string|array$key Key to write to.
-
mixed$value Value to write.
-
bool|string$merge optional True to merge recursively, 'shallow' for simple merge, false to overwrite, defaults to false.
Returns
voidThrows
Cake\Core\Exception\Exceptionif attempting to clobber existing config
_getCount() ¶ protected
_getCount(array $config, array $conditions): intFetches and returns the count for a single field in an association
Parameters
-
array$config The counter cache configuration for a single field
-
array$conditions Additional conditions given to the query
Returns
intThe number of relations matching the given config and conditions
_processAssociation() ¶ protected
_processAssociation(Cake\Event\Event $event, Cake\Datasource\EntityInterface $entity, Cake\ORM\Association $assoc, array $settings): voidUpdates counter cache for a single association
Parameters
-
Cake\Event\Event$event Event instance.
-
Cake\Datasource\EntityInterface$entity Entity
-
Cake\ORM\Association$assoc The association object
-
array$settings The settings for for counter cache for this association
Returns
void_processAssociations() ¶ protected
_processAssociations(Cake\Event\Event $event, Cake\Datasource\EntityInterface $entity): voidIterate all associations and update counter caches.
Parameters
-
Cake\Event\Event$event Event instance.
-
Cake\Datasource\EntityInterface$entity Entity.
Returns
void_reflectionCache() ¶ protected
_reflectionCache(): arrayGets the methods implemented by this behavior
Uses the implementedEvents() method to exclude callback methods.
Methods starting with _ will be ignored, as will methods
declared on Cake\ORM\Behavior
Returns
array_resolveMethodAliases() ¶ protected
_resolveMethodAliases(string $key, array $defaults, array $config): arrayRemoves aliased methods that would otherwise be duplicated by userland configuration.
Parameters
-
string$key The key to filter.
-
array$defaults The default method mappings.
-
array$config The customized method mappings.
Returns
arrayA de-duped list of config data.
afterDelete() ¶ public
afterDelete(Cake\Event\Event $event, Cake\Datasource\EntityInterface $entity): voidafterDelete callback.
Makes sure to update counter cache when a record is deleted.
Parameters
-
Cake\Event\Event$event The afterDelete event that was fired.
-
Cake\Datasource\EntityInterface$entity The entity that was deleted.
Returns
voidafterSave() ¶ public
afterSave(Cake\Event\Event $event, Cake\Datasource\EntityInterface $entity): voidafterSave callback.
Makes sure to update counter cache when a new record is created or updated.
Parameters
-
Cake\Event\Event$event The afterSave event that was fired.
-
Cake\Datasource\EntityInterface$entity The entity that was saved.
Returns
voidbeforeSave() ¶ public
beforeSave(Cake\Event\Event $event, Cake\Datasource\EntityInterface $entity): voidbeforeSave callback.
Check if a field, which should be ignored, is dirty
Parameters
-
Cake\Event\Event$event The beforeSave event that was fired
-
Cake\Datasource\EntityInterface$entity The entity that is going to be saved
Returns
voidconfig() ¶ public
config(string|array|null $key = null, mixed|null $value = null, bool $merge = true): mixedUsage
Reading the whole config:
$this->config();Reading a specific value:
$this->config('key');Reading a nested value:
$this->config('some.nested.key');Setting a specific value:
$this->config('key', $value);Setting a nested value:
$this->config('some.nested.key', $value);Updating multiple config settings at the same time:
$this->config(['one' => 'value', 'another' => 'value']);Parameters
-
string|array|null$key optional The key to get/set, or a complete array of configs.
-
mixed|null$value optional The value to set.
-
bool$merge optional Whether to recursively merge or overwrite existing config, defaults to true.
Returns
mixedConfig value being read, or the object itself on write operations.
Throws
Cake\Core\Exception\ExceptionWhen trying to set a key that is invalid.
configShallow() ¶ public
configShallow(string|array $key, mixed|null $value = null): $thisMerge provided config with existing config. Unlike config() which does
a recursive merge for nested keys, this method does a simple merge.
Setting a specific value:
$this->config('key', $value);Setting a nested value:
$this->config('some.nested.key', $value);Updating multiple config settings at the same time:
$this->config(['one' => 'value', 'another' => 'value']);Parameters
-
string|array$key The key to set, or a complete array of configs.
-
mixed|null$value optional The value to set.
Returns
$thisThe object itself.
implementedEvents() ¶ public
implementedEvents(): arrayGets the Model callbacks this behavior is interested in.
By defining one of the callback methods a behavior is assumed to be interested in the related event.
Override this method if you need to add non-conventional event listeners. Or if you want your behavior to listen to non-standard events.
Returns
arrayimplementedFinders() ¶ public
implementedFinders(): arrayimplementedFinders
Provides an alias->methodname map of which finders a behavior implements. Example:
[
'this' => 'findThis',
'alias' => 'findMethodName'
]With the above example, a call to $Table->find('this') will call $Behavior->findThis()
and a call to $Table->find('alias') will call $Behavior->findMethodName()
It is recommended, though not required, to define implementedFinders in the config property of child classes such that it is not necessary to use reflections to derive the available method list. See core behaviors for examples
Returns
arrayimplementedMethods() ¶ public
implementedMethods(): arrayimplementedMethods
Provides an alias->methodname map of which methods a behavior implements. Example:
[
'method' => 'method',
'aliasedmethod' => 'somethingElse'
]With the above example, a call to $Table->method() will call $Behavior->method()
and a call to $Table->aliasedmethod() will call $Behavior->somethingElse()
It is recommended, though not required, to define implementedFinders in the config property of child classes such that it is not necessary to use reflections to derive the available method list. See core behaviors for examples
Returns
arrayinitialize() ¶ public
initialize(array $config): voidConstructor hook method.
Implement this method to avoid having to overwrite the constructor and call parent.
Parameters
-
array$config The configuration settings provided to this behavior.
Returns
voidverifyConfig() ¶ public
verifyConfig(): voidverifyConfig
Checks that implemented keys contain values pointing at callable.
Returns
voidThrows
Cake\Core\Exception\Exceptionif config are invalid
Property Detail
$_configInitialized ¶ protected
Whether the config property has already been configured with defaults
Type
bool$_defaultConfig ¶ protected
Default configuration
These are merged with user-provided configuration when the behavior is used.
Type
array$_reflectionCache ¶ protected static
Reflection method cache for behaviors.
Stores the reflected method + finder methods per class. This prevents reflecting the same class multiple times in a single process.
Type
array