Download the PHP package factorenergia/yii2-tag-dependency-helper without Composer

yii2-tag-dependency-helper

Helper for unifying cache tag names with invalidation support for Yii2 ActiveRecord models.

Installation

The preferred way to install this extension is through composer.

Either run

or add

to the require section of your composer.json file.

Core concept

This extension introduces 2 standard cache tags types for ActiveRecord:

• common tag - Tag is invalidated if any model of this type is updated/inserted
• object tag - Tag is invalidated if exact model record is updated(ie. Product with id=2)
• composite tag - Tag is invalidated if model with specified fields record is updated

Usage

In your active record model add behavior and trait:

This behavior automatically invalidates tags by model name and pair model-id.

Finding model

There's a special method in TagDependencyTrait for finding models by ID with using tag cache:

Example call: $post = Post::loadModel('', false, false, 0, new \Exception("test2"));

For Post model instance($post) cache will be automatically invalidated by object and common tags on update,insert,delete.

Direct invalidation can be done by calling $post->invalidateTags().

Adding cache tags in other scenarios

If your cache entry should be flushed every time any row of model is edited - use getCommonTag helper function:

If your cache entry should be flushed only when exact row of model is edited - use getObjectTag helper function:

If your cache entry should be flushed only when row of model with specified fields is edited - use getCompositeTag helper function and override function cacheCompositeTagFields in model:

Lazy cache

Lazy cache is a technique inspired by iiifx-production/yii2-lazy-cache composer package.

After configuring(see below) you can use it like this:

In this example Pages find query will be performed only if cache entry with key AllActivePages will not be found. After successful retrieving of models array the result will be automatically stored in cache with AllActivePages as cache key for 3600 seconds and with $dependency as Cache dependency.

Configuring - Performance-way

For performance reasons(yii2 behaviors are slower then traits) - create your own \yii\caching\Cache class and add LazyCacheTrait to it, for example:

And modify your application configuration to use your cache component:

Now you can use lazy cache:

Configuring - Behavior-way

Just modify your configuration like this:

Migrating from 0.0.x to 1.x

1. We have changed namespace from devgroup to DevGroup
2. We've splitted behavior into 3 components:

• CacheableActiveRecord - behavior that adds invalidation on update/insert/delete of ActiveRecord model
• TagDependencyTrait - trait that must be also added to ActiveRecord class, handles invalidation and adds new static method loadModel
• NamingHelper - the only one class that handles naming policy for cache tags

Brought to you by DevGroup.ru. Check out our another open-source projects!