Класс NullEngine
Движок кэша Null, все операции кажутся работающими, но ничего не делают.
Используется внутри, когда был вызван Cache::disable().
- Cake\Cache\CacheEngine использует Cake\Core\InstanceConfigTrait
-
Cake\Cache\Engine\NullEngine
Наследованные свойства
Краткое описание методов
- clear() publicУдалить все ключи из кэша
- clearGroup() public
Очищает все значения, принадлежащие группе. Реализующий движок сам решает, действительно ли удалять ключи или просто имитировать это, чтобы достичь того же результата.
- decrement() publicУменьшить число по ключу и вернуть уменьшенное значение
- delete() publicУдалить ключ из кэша
- deleteMany() publicУдаляет ключи из кэша
- gc() publicСбор мусора
- increment() publicУвеличить число по ключу и вернуть увеличенное значение
- init() publicИнициализировать движок кэша
- read() publicПрочитать ключ из кэша
- readMany() publicПрочитать несколько ключей из кэша
- write() publicЗаписать значение для ключа в кэш
Подробное описание методов
clear()source public
clear( boolean $check )
Удалить все ключи из кэша
Параметры
- boolean
$check - если true, будет проверять срок действия, иначе удалит все
Возвращает
booleanTrue, если кэш был успешно очищен, иначе 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необязательно 1 - На сколько уменьшить
Возвращает
boolean|integerНовое значение, иначе false
delete()source public
delete( string $key )
Удалить ключ из кэша
Параметры
- string
$key - Идентификатор данных
Возвращает
booleanTrue, если значение было успешно удалено, иначе 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необязательно null - [необязательно] Отметка времени истечения срока действия, делающая все данные недействительными до.
Переопределяет
Cake\Cache\CacheEngine::gc() increment()source public
increment( string $key , integer $offset = 1 )
Увеличить число по ключу и вернуть увеличенное значение
Параметры
- string
$key - Идентификатор данных
- integer
$offsetнеобязательно 1 - На сколько увеличить
Возвращает
boolean|integerНовое значение, иначе false
init()source public
init( array $config = [] )
Инициализировать движок кэша
Параметры
- array
$configнеобязательно [] - Ассоциативный массив параметров для движка
Возвращает
booleanTrue, если движок был успешно инициализирован, иначе 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 - Данные для кэширования
Возвращает
booleanTrue, если данные были успешно кэшированы, иначе 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 - Данные для кэширования.
Возвращает
booleanTrue, если данные были успешно кэшированы, иначе false.
groups()source public
groups( )
Выполняет необходимые инициализации для каждой группы и возвращает group value для каждой из них. Это маркер, представляющий каждую группу в ключе кэша.
Возвращает
arraykey()source public
key( string $key )
Генерирует безопасный ключ для использования с движками хранения кэша.
Параметры
- string
$key - переданный ключ
Возвращает
boolean|stringключ или false
warning()source protected
warning( string $message )
Движки кэша могут генерировать предупреждения, если они сталкиваются с ошибками во время работы, если опция warnOnWriteFailures установлена в true.
Параметры
- string
$message - Сообщение об ошибке.
writeMany()source public
writeMany( array $data )
Запись данных для множества ключей в кэш
Параметры
- array
$data - Массив данных, которые нужно сохранить в кэше
Возвращает
arrayзначения булевых значений для каждого ключа, true, если данные были успешно кэшированы, false в случае неудачи
Методы, используемые из Cake\Core\InstanceConfigTrait
_configDelete()source protected
_configDelete( string $key )
Удаляет один ключ конфигурации.
Параметры
- string
$key - Ключ для удаления.
Исключения
Cake\Core\Exception\Exceptionесли происходит попытка перезаписи существующей конфигурации
_configRead()source protected
_configRead( string|null $key )
Считывает ключ конфигурации.
Параметры
- string|null
$key - Ключ для чтения.
Возвращает
mixed_configWrite()source protected
_configWrite( string|array $key , mixed $value , boolean|string $merge = false )
Записывает ключ конфигурации.
Параметры
- string|array
$key - Ключ для записи.
- mixed
$value - Значение для записи.
- boolean|string
$mergeoptional false True для рекурсивного объединения, 'shallow' для простого объединения, false для перезаписи, по умолчанию false.
Исключения
Cake\Core\Exception\Exceptionесли происходит попытка перезаписи существующей конфигурации
config()source public deprecated
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() вместо этого.Параметры
- string|array|null
$keyoptional null - Ключ для получения/установки или массив всей конфигурации.
- mixed|null
$valueoptional null - Значение для установки.
- boolean
$mergeoptional true - Выполнять ли рекурсивное объединение или перезапись существующей конфигурации, по умолчанию true.
Возвращает
mixedЗначение конфигурации для чтения, или сам объект при операциях записи.
Исключения
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']);
Параметры
- string|array
$key - Ключ для установки или массив всей конфигурации.
- mixed|null
$valueoptional 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'); Параметры
- string|null
$keyoptional null - Ключ для получения или null для всей конфигурации.
- mixed
$defaultoptional null - Возвращаемое значение, если ключ не существует.
Возвращает
mixedЗначение конфигурации для чтения.
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']);
Параметры
- string|array
$key - Ключ для установки или массив всей конфигурации.
- mixed|null
$valueoptional null - Значение для установки.
- boolean
$mergeoptional true - Выполнять ли рекурсивное объединение или перезапись существующей конфигурации, по умолчанию true.
Возвращает
$this
Исключения
Cake\Core\Exception\Exceptionпри попытке установить недопустимый ключ.
© 2005–present 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.7/class-Cake.Cache.Engine.NullEngine.html