Spec-Zone.ru › CakePHP 3.5

Класс NullEngine

Null кэш-движок, все операции возвращают false.

Используется внутри, когда вызвана Cache::disable().

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

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

  • _defaultConfig, _groupPrefix _config, _configInitialized

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

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

    Очищает все значения, принадлежащие группе. Реализующий движок может решить, действительно ли удалить ключи или просто смоделировать это, чтобы добиться того же результата.

  • decrement() public
    Уменьшить число по ключу и вернуть уменьшенное значение
  • delete() public
    Удалить ключ из кэша
  • deleteMany() public
    Удаляет ключи из кэша
  • gc() public
    Сбор мусора
  • increment() public
    Увеличить число по ключу и вернуть увеличенное значение
  • init() public
    Инициализировать кэш-движок
  • read() public
    Прочитать ключ из кэша
  • readMany() public
    Прочитать несколько ключей из кэша
  • write() public
    Записать значение для ключа в кэш
  • writeMany() public
    Записать данные для многих ключей в кэш

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

clear()source public

clear( boolean $check )

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

Параметры

boolean $check
если true, проверит истечение срока действия, иначе удалит все

Возвращаемые значения

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 )

Уменьшить число по ключу и вернуть уменьшенное значение

Параметры

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

Возвращаемые значения

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

delete()source public

delete( string $key )

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

Параметры

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

Возвращаемые значения

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

deleteMany()source public

deleteMany( array $keys )

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

Параметры

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

Возвращаемые значения

array

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


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

Cake\Cache\CacheEngine::deleteMany()

gc()source public

gc( integer|null $expires null )

Сбор мусора

Параметры

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

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

Cake\Cache\CacheEngine::gc()

increment()source public

increment( string $key , integer $offset 1 )

Увеличить число по ключу и вернуть увеличенное значение

Параметры

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

Возвращаемые значения

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

init()source public

init( array $config [] )

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

Параметры

array $config optional []
Ассоциативный массив параметров для движка

Возвращаемые значения

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

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

Cake\Cache\CacheEngine::init()

read()source public

read( string $key )

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

Параметры

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

Возвращаемые значения

mixed
Данные кэша или false, если данных нет, срок действия истек или произошла ошибка при извлечении

readMany()source public

readMany( array $keys )

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

Параметры

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

Возвращаемые значения

array

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


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

Cake\Cache\CacheEngine::readMany()

write()source public

write( string $key , mixed $value )

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

Параметры

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

Возвращаемые значения

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

writeMany()source public

writeMany( array $data )

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

Параметры

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

Возвращаемые значения

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

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

Cake\Cache\CacheEngine::writeMany()

Наследуемые методы от Cake\Cache\CacheEngine

_key()source protected

_key( string $key )

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

Параметры

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

Возвращаемые значения

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

Исключение

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

add()source public

add( string $key , mixed $value )

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

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

Параметры

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

Возвращает

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

groups()source public

groups( )

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

Возвращает

массив

key()source public

key( string $key )

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

Параметры

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

Возвращает

boolean|строка
строковый ключ или 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']);

Устарело

3.4.0 используйте setConfig()/getConfig() вместо этого.

Параметры

строка|массив|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->configShallow('key', $value);

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

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

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

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

Параметры

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

Возвращает


$this

getConfig()source public

getConfig( string|null $key null , mixed $default null )

Возвращает конфигурацию.

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

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

$this->getConfig();

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

$this->getConfig('key');

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

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

Чтение со значением по умолчанию:

$this->getConfig('some-key', 'default-value');

Параметры

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

Возвращает

смешанный
Значение конфигурации, которое читается.

setConfig()source public

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

Устанавливает конфигурацию.

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

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

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

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

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

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

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

Параметры

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

Возвращает


$this

Выбрасывает

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

© 2005–2018 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.5/class-Cake.Cache.Engine.NullEngine.html

Spec-Zone.ru

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