Spec-Zone.ru › CakePHP 3.3

Класс XcacheEngine

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

Cake\Cache\CacheEngine использует Cake\Core\InstanceConfigTrait
Расширенный 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() должен передавать базовую аутентификацию HTTP (см. конфигурацию 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
string $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
переданный ключ

Возвращает

boolean|строка
ключ или false

readMany()source public

readMany( array $keys )

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

Параметры

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

Возвращает

массив

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


writeMany()source public

writeMany( array $data )

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

Параметры

массив $data
Массив данных для хранения в кэше

Возвращает

массив
значений boolean для каждого предоставленного ключа, 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
Значение для записи.
boolean|строка $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
Значение для установки.
boolean $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 Вероятность запуска очистки кэша gc. Установка в 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–2017 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.3/class-Cake.Cache.Engine.XcacheEngine.html

Spec-Zone.ru

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