Класс 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
$offsetoptional 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
$expiresoptional null - [необязательно] Маркер истечения срока действия, делающий все данные недействительными до этого момента.
Переопределяет
Cake\Cache\CacheEngine::gc() increment()source public
increment( string $key , integer $offset 1 )
Увеличить число по ключу и вернуть увеличенное значение
Параметры
- string
$key - Идентификатор данных
- integer
$offsetoptional 1 - На сколько увеличить
Возвращаемые значения
boolean|integerНовое увеличенное значение, false в противном случае
init()source public
init( array $config [] )
Инициализировать кэш-движок
Параметры
- array
$configoptional [] - Ассоциативный массив параметров для движка
Возвращаемые значения
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
Методы, используемые из 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