PHP Класс yii\widgets\FragmentCache

С версии: 2.0
Автор: Qiang Xue ([email protected])
Наследование: extends yii\base\Widget
Показать файл Открыть проект Примеры использования класса

Открытые свойства

Свойство Тип Описание
$cache the cache object or the application component ID of the cache object. After the FragmentCache object is created, if you want to change this property, you should only assign it with a cache object. Starting from version 2.0.2, this can also be a configuration array for creating the object.
$dependency the dependency that the cached content depends on. This can be either a [[Dependency]] object or a configuration array for creating the dependency object. For example, php [ 'class' => 'yii\caching\DbDependency', 'sql' => 'SELECT MAX(updated_at) FROM post', ] would make the output cache depends on the last modified time of all posts. If any post has its modification time changed, the cached content would be invalidated.
$duration number of seconds that the data can remain valid in cache. Use 0 to indicate that the cached data will never expire.
$dynamicPlaceholders a list of placeholders for embedding dynamic contents. This property is used internally to implement the content caching feature. Do not modify it.
$enabled whether to enable the fragment cache. You may use this property to turn on and off the fragment cache according to specific setting (e.g. enable fragment cache only for GET requests).
$variations list of factors that would cause the variation of the content being cached. Each factor is a string representing a variation (e.g. the language, a GET parameter). The following variation setting will cause the content to be cached in different versions according to the current application language: php [ Yii::$app->language, ]

Открытые методы

Метод Описание
getCachedContent ( ) : string | false Returns the cached content if available.
init ( ) Initializes the FragmentCache object.
run ( ) Marks the end of content to be cached.

Защищенные методы

Метод Описание
calculateKey ( ) : mixed Generates a unique key used for storing the content in cache.
updateDynamicContent ( string $content, array $placeholders ) : string Replaces placeholders in content by results of evaluated dynamic statements.

Описание методов

calculateKey() защищенный Метод

The key generated depends on both [[id]] and [[variations]].
protected calculateKey ( ) : mixed
Результат mixed a valid cache key

getCachedContent() публичный Метод

Returns the cached content if available.
public getCachedContent ( ) : string | false
Результат string | false the cached content. False is returned if valid content is not found in the cache.

init() публичный Метод

Initializes the FragmentCache object.
public init ( )

run() публичный Метод

Content displayed before this method call and after FragmentCache::init will be captured and saved in cache. This method does nothing if valid content is already found in cache.
public run ( )

updateDynamicContent() защищенный Метод

Replaces placeholders in content by results of evaluated dynamic statements.
protected updateDynamicContent ( string $content, array $placeholders ) : string
$content string
$placeholders array
Результат string final content

Описание свойств

$cache публичное свойство

the cache object or the application component ID of the cache object. After the FragmentCache object is created, if you want to change this property, you should only assign it with a cache object. Starting from version 2.0.2, this can also be a configuration array for creating the object.
public $cache

$dependency публичное свойство

the dependency that the cached content depends on. This can be either a [[Dependency]] object or a configuration array for creating the dependency object. For example, php [ 'class' => 'yii\caching\DbDependency', 'sql' => 'SELECT MAX(updated_at) FROM post', ] would make the output cache depends on the last modified time of all posts. If any post has its modification time changed, the cached content would be invalidated.
public $dependency

$duration публичное свойство

number of seconds that the data can remain valid in cache. Use 0 to indicate that the cached data will never expire.
public $duration

$dynamicPlaceholders публичное свойство

a list of placeholders for embedding dynamic contents. This property is used internally to implement the content caching feature. Do not modify it.
public $dynamicPlaceholders

$enabled публичное свойство

whether to enable the fragment cache. You may use this property to turn on and off the fragment cache according to specific setting (e.g. enable fragment cache only for GET requests).
public $enabled

$variations публичное свойство

list of factors that would cause the variation of the content being cached. Each factor is a string representing a variation (e.g. the language, a GET parameter). The following variation setting will cause the content to be cached in different versions according to the current application language: php [ Yii::$app->language, ]
public $variations