Spec-Zone.ru › CakePHP 3.2

Класс XcacheEngine

Двигатель кэширования Xcache для кэша

Cake\Cache\CacheEngine использует Cake\Core\InstanceConfigTrait
Extended by Cake\Cache\Engine\XcacheEngine
Пространство имён: Cake\Cache\Engine
Ссылка: Xcache
Расположение: Cache/Engine/XcacheEngine.php

Краткое описание свойств

  • $_defaultConfig protected
    array
    По умолчанию используемая конфигурация, если не переопределена конфигурацией во время выполнения

Унаследованные свойства

  • _groupPrefix _config, _configInitialized

Краткое описание методов

  • _auth() protected

    Заполняет и изменяет порядок $_SERVER значения аутентификации. Вносит необходимые изменения (и откат) в $_SERVER

  • clear() public
    Удалить все ключи из кэша
  • clearGroup() public

    Увеличивает значение группы, чтобы симулировать удаление всех ключей в группе. Старые значения останутся в хранилище до истечения срока их действия.

  • decrement() public

    Уменьшает значение целого числа кэшированного ключа. Если ключ кэша не является целым числом, он обрабатывается как 0

  • delete() public
    Удалить ключ из кэша
  • groups() public

    Возвращает group value для каждой из настроенных групп. Если начальное значение группы не найдено, то оно инициализируется соответствующим образом.

  • increment() public

    Увеличивает значение целого числа кэшированного ключа. Если ключ кэша не является целым числом, он обрабатывается как 0

  • init() public
    Инициализировать кэш-движок
  • read() public
    Прочитать ключ из кэша
  • write() public
    Записать данные для ключа в кэш

Подробное описание методов

_auth()source protected

_auth( boolean $reverse false )

Заполняет и изменяет порядок $_SERVER значения аутентификации. Вносит необходимые изменения (и откат) в $_SERVER

Это необходимо сделать, так как xcache_clear_cache() нужно передать аутентификацию Basic Http Auth (см. конфигурацию xcache.admin)

Параметры

boolean $reverse необязательно false
Отменить изменения

clear()source public

clear( boolean $check )

Удалить все ключи из кэша

Параметры

boolean $check

Если true, удаления не происходят, и CakePHP будет полагаться на значения TTL ключей. Не используется для движка Xcache.

Возвращает

boolean
True, если кэш был успешно очищен, в противном случае false

clearGroup()source public

clearGroup( string $group )

Увеличивает значение группы, чтобы симулировать удаление всех ключей в группе. Старые значения останутся в хранилище до истечения срока их действия.

Параметры

string $group
Группа для очистки.

Возвращает

boolean
успех

Переопределяет

Cake\Cache\CacheEngine::clearGroup()

decrement()source public

decrement( string $key , integer $offset 1 )

Уменьшает значение целого числа кэшированного ключа. Если ключ кэша не является целым числом, он обрабатывается как 0

Параметры

string $key
Идентификатор данных
integer $offset необязательно 1
На сколько уменьшить

Возвращает

boolean|integer
Новое уменьшенное значение, в противном случае false

delete()source public

delete( string $key )

Удалить ключ из кэша

Параметры

string $key
Идентификатор данных

Возвращает

boolean
True, если значение было успешно удалено, false, если его не существовало или не удалось удалить

groups()source public

groups( )

Возвращает group value для каждой из настроенных групп. Если начальное значение группы не найдено, то оно инициализируется соответствующим образом.

Возвращает

array

Переопределяет

Cake\Cache\CacheEngine::groups()

increment()source public

increment( string $key , integer $offset 1 )

Увеличивает значение целого числа кэшированного ключа. Если ключ кэша не является целым числом, он обрабатывается как 0

Параметры

string $key
Идентификатор данных
integer $offset необязательно 1
На сколько увеличить

Возвращает

boolean|integer
Новое увеличенное значение, в противном случае false

init()source public

init( array $config [] )

Инициализировать кэш-движок

Вызывается автоматически фронтендом кэша

Параметры

array $config необязательно []
массив настроек для движка

Возвращает

boolean
True, если движок был успешно инициализирован, в противном случае false

Переопределяет

Cake\Cache\CacheEngine::init()

read()source public

read( string $key )

Прочитать ключ из кэша

Параметры

string $key
Идентификатор данных

Возвращает

mixed

Кэшированные данные или false, если данные не существуют, истекли или произошла ошибка при их получении


write()source public

write( string $key , mixed $value )

Записать данные для ключа в кэш

Параметры

string $key
Идентификатор данных
mixed $value
Данные для кэширования

Возвращает

boolean
True, если данные были успешно кэшированы, в противном случае false

Методы, унаследованные от Cake\Cache\CacheEngine

_key()source protected

_key( string $key )

Генерирует безопасный ключ, учитывая префикс ключа, настроенный в системе

Параметры

string $key
передаваемый ключ

Возвращает

mixed
строка $key или false

Использует

InvalidArgumentException
Если значение ключа пустое

add()source public

add( string $key , mixed $value )

Добавить ключ в кэш, если он ещё не существует.

По умолчанию используется неатомарная реализация. Подклассы должны предпочитать атомарные реализации.

Параметры

string $key
Идентификатор данных.
mixed $value
Данные для кэширования.

Возвращает

boolean
True, если данные были успешно кэшированы, в противном случае false.
END_OF_DOCUMENT_MARKER

deleteMany()source public

deleteMany( array $keys )

Удаляет ключи из кэша

Параметры

массив $keys
Массив идентификаторов данных

Возвращает

массив

Для каждого предоставленного ключа кэша (указанного в качестве ключа массива) true, если значение было успешно удалено, false, если оно не существовало или не могло быть удалено


gc()source public

gc( integer|null $expires null )

Сбор мусора

Постоянно удаляет все истекшие и удаленные данные

Параметры

целое число|null $expires необязательно null
[необязательно] Отметка времени истечения, делающая все данные до нее недействительными.

key()source public

key( string $key )

Генерирует безопасный ключ для использования с движками хранения кэша.

Параметры

строка $key
переданный ключ

Возвращает

булево значение|строка
строковый ключ или false

readMany()source public

readMany( array $keys )

Чтение нескольких ключей из кэша

Параметры

массив $keys
Массив идентификаторов данных

Возвращает

массив

Для каждого ключа кэша (указанного в качестве ключа массива) связанные данные кэша или false, если данных нет, они истекли или произошла ошибка при их получении


writeMany()source public

writeMany( array $data )

Запись данных для многих ключей в кэш

Параметры

массив $data
Массив данных, которые необходимо сохранить в кэше

Возвращает

массив
логическое значение для каждого предоставленного ключа, true, если данные были успешно сохранены в кэше, false при ошибке

Методы, используемые из Cake\Core\InstanceConfigTrait

_configDelete()source protected

_configDelete( string $key )

Удаление одного ключа конфигурации

Параметры

строка $key
Ключ для удаления.

Выбрасывает

Cake\Core\Exception\Exception
если пытаетесь перезаписать существующую конфигурацию

_configRead()source protected

_configRead( string|null $key )

Чтение переменной конфигурации

Параметры

строка|null $key
Ключ для чтения.

Возвращает

смешанный тип

_configWrite()source protected

_configWrite( string|array $key , mixed $value , boolean|string $merge false )

Запись переменной конфигурации

Параметры

строка|массив $key
Ключ для записи.
смешанный тип $value
Значение для записи.
булево значение|строка $merge необязательно false

True для рекурсивного слияния, 'shallow' для простого слияния, false для перезаписи, по умолчанию false.

Выбрасывает

Cake\Core\Exception\Exception
если пытаетесь перезаписать существующую конфигурацию

config()source public

config( string|array|null $key null , mixed|null $value null , boolean $merge true )

Использование

Чтение всей конфигурации:

$this->config();

Чтение определенного значения:

$this->config('key');

Чтение вложенного значения:

$this->config('some.nested.key');

Установка определенного значения:

$this->config('key', $value);

Установка вложенного значения:

$this->config('some.nested.key', $value);

Обновление нескольких параметров конфигурации одновременно:

$this->config(['one' => 'value', 'another' => 'value']);

Параметры

строка|массив|null $key необязательно null
Ключ для получения/установки или полный массив конфигураций.
смешанный тип|null $value необязательно null
Значение для установки.
булево значение $merge необязательно true
Выполнять ли рекурсивное слияние или перезапись существующей конфигурации, по умолчанию true.

Возвращает

смешанный тип
Значение конфигурации, которое считывается, или сам объект при операциях записи.

Выбрасывает

Cake\Core\Exception\Exception
При попытке установить недопустимый ключ.

configShallow()source public

configShallow( string|array $key , mixed|null $value null )

Объединение предоставленной конфигурации с существующей конфигурацией. В отличие от config(), которая выполняет рекурсивное слияние для вложенных ключей, этот метод выполняет простое слияние.

Установка определенного значения:

$this->config('key', $value);

Установка вложенного значения:

$this->config('some.nested.key', $value);

Обновление нескольких параметров конфигурации одновременно:

$this->config(['one' => 'value', 'another' => 'value']);

Параметры

строка|массив $key
Ключ для установки или полный массив конфигураций.
смешанный тип|null $value необязательно null
Значение для установки.

Возвращает


$this Объект.

Подробное описание свойств

$_defaultConfigsource

protected массив

Конфигурация по умолчанию, используемая, если не переопределена в конфигурации во время выполнения

  • duration Указывает, как долго элементы в этой конфигурации кэша остаются актуальными.
  • groups Список групп или «тегов», связанных с каждым сохраненным ключом в этой конфигурации. Полезно для удаления всей группы из кэша.
  • prefix Префикс, добавляемый ко всем записям. Хорошо подходит для совместного использования пространства ключей с другой конфигурацией кэша или другим приложением.
  • probability Вероятность запуска очистки кэша сборки мусора. Установка в 0 отключит автоматический вызов cache::gc.
  • PHP_AUTH_USER xcache.admin.user
  • PHP_AUTH_PW xcache.admin.password
[
    'duration' => 3600,
    'groups' => [],
    'prefix' => null,
    'probability' => 100,
    'PHP_AUTH_USER' => 'user',
    'PHP_AUTH_PW' => 'password'
]

© 2005–2016 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.
http://api.cakephp.org/3.2/class-Cake.Cache.Engine.XcacheEngine.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API