Класс NullEngine
Кеш-движок Null, все операции возвращают false.
Используется внутри, когда вызвана 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Записать значение для ключа в кэш
- writeMany() 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 в случае ошибки
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Если значение ключа пустое
add()source public
add( string $key , mixed $value )
Добавить ключ в кэш, если он еще не существует.
По умолчанию используется неатомная реализация. Подклассы должны предпочитать атомные реализации.
Параметры
- строка
$key - Идентификатор данных.
- смешанное значение
$value - Данные, которые нужно кэшировать.
Возвращает
booleanTrue, если данные были успешно кэшированы, false в случае ошибки.
groups()source public
groups( )
Выполняет необходимую инициализацию для каждой группы и возвращает group value для каждой из них, это маркер, представляющий каждую группу в ключе кэша.
Возвращает
массивkey()source public
key( string $key )
Генерирует безопасный ключ для использования с хранилищами кэша.
Параметры
- строка
$key - переданный ключ
Возвращает
boolean|строкаключ-строка или false
warning()source protected
warning( string $message )
Модули кэша могут генерировать предупреждения, если они сталкиваются с ошибками во время работы, если параметр warnOnWriteFailures установлен в значение true.
Параметры
- строка
$message - Сообщение об ошибке.
Методы, используемые из 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 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() вместо этого.Параметры
- строка|массив|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–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.6/class-Cake.Cache.Engine.NullEngine.html