Spec-Zone.ru › CakePHP 2.8

Класс FileEngine

Движок хранения файлов для кеша. Filestorage — это самое медленное хранилище кеша для чтения и записи. Однако он подходит для серверов, у которых нет других доступных хранилищ, или для контента, чувствительность которого к производительности невысока.

Вы можете настроить кеш FileEngine, используя Cache::config()

CacheEngine
Extended by FileEngine
Пакет: Cake\Cache\Engine
Авторские права: Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/Cache/Engine/FileEngine.php

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

  • $_File protected
    File
    Экземпляр класса SplFileObject
  • $_init protected
    boolean
    Истина, если FileEngine::__active(); выполняется успешно
  • $settings public
    array
    Настройки

Наследуемые свойства

  • _groupPrefix

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

  • _active() protected
    Определяет, является ли каталог кеша доступным для записи
  • _clearDirectory() protected
    Используется для очистки каталога от соответствующих файлов.
  • _setKey() protected

    Устанавливает текущий ключ кеша, управляемый этим классом, и создаёт доступный для записи SplFileObject для файла кеша, на который ссылается ключ.

  • add() public

    Записывает данные для ключа в кеш, если они ещё не существуют. Если они уже существуют, операция завершается неудачно и возвращает false.

  • clear() public
    Удаляет все значения из кеша
  • clearGroup() public
    Рекурсивно удаляет все файлы в каталоге, имя которого соответствует $group
  • decrement() public
    Не реализовано
  • delete() public
    Удаляет ключ из кеша
  • gc() public
    Сбор мусора. Постоянно удаляет все просроченные и удалённые данные
  • increment() public
    Не реализовано
  • init() public
    Инициализирует движок кеша
  • key() public
    Генерирует безопасный ключ для использования с движками хранения кеша.
  • read() public
    Считывает ключ из кеша
  • write() public
    Записывает данные для ключа в кеш

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

_active()source protected

_active( )

Определяет, является ли каталог кеша доступным для записи

Возвращает

boolean

_clearDirectory()source protected

_clearDirectory( string $path , integer $now , integer $threshold )

Используется для очистки каталога от соответствующих файлов.

Параметры

строка $path
Путь для поиска.
целое число $now
Текущая отметка времени
целое число $threshold
Любой файл, не изменённый после этого значения, будет удалён.

_setKey()source protected

_setKey( string $key , boolean $createKey false )

Устанавливает текущий ключ кеша, управляемый этим классом, и создаёт доступный для записи SplFileObject для файла кеша, на который ссылается ключ.

Параметры

строка $key
Ключ
логическое значение $createKey дополнительно false
Указывает, нужно ли создавать ключ, если он не существует

Возвращает

boolean
Истина, если ключ кеша был установлен, ложь в противном случае

add()source public

add( string $key , mixed $value , integer $duration )

Записывает данные для ключа в кеш, если они ещё не существуют. Если они уже существуют, операция завершается неудачно и возвращает false.

Параметры

строка $key
Идентификатор данных.
смешанный тип $value
Данные для кеширования.
целое число $duration
Время кеширования данных в секундах.

Возвращает

boolean
Истина, если данные были успешно помещены в кеш, ложь в случае неудачи.

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

CacheEngine::add()

clear()source public

clear( boolean $check )

Удаляет все значения из кеша

Параметры

логическое значение $check
Дополнительно — удалять только просроченные элементы кеша

Возвращает

boolean
Истина, если кеш был успешно очищен, ложь в противном случае

clearGroup()source public

clearGroup( string $group )

Рекурсивно удаляет все файлы в каталоге, имя которого соответствует $group

Параметры

строка $group
Группа для очистки.

Возвращает

boolean
успех

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

CacheEngine::clearGroup()

decrement()source public

decrement( string $key , integer $offset 1 )

Не реализовано

Параметры

строка $key
Ключ для декремента
целое число $offset дополнительно 1
Значение смещения

Выбрасывает

CacheException

delete()source public

delete( string $key )

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

Параметры

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

Возвращает

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

gc()source public

gc( integer $expires null )

Сбор мусора. Постоянно удаляет все просроченные и удалённые данные

Параметры

целое число $expires дополнительно null
[дополнительно] Отметка времени истечения срока действия, делая все данные старше её недействительными.

Возвращает

boolean
Истина, если сбор мусора прошёл успешно, ложь в противном случае

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

CacheEngine::gc()

increment()source public

increment( string $key , integer $offset 1 )

Не реализовано

Параметры

строка $key
Ключ для декремента
целое число $offset дополнительно 1
Значение смещения

Выбрасывает

CacheException

init()source public

init( array $settings array() )

Инициализирует движок кеша

Вызывается автоматически передней частью кеша. Для повторной инициализации настроек вызовите Cache::engine('EngineName', [дополнительные] settings = array());

Параметры

массив $settings дополнительно array()
массив настроек для движка

Возвращает

boolean
Истина, если движок был успешно инициализирован, ложь в противном случае

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

CacheEngine::init()

key()source public

key( string $key )

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

Параметры

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

Возвращает

смешанный
строка $key или false

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

CacheEngine::key()

read()source public

read( string $key )

Чтение ключа из кэша

Параметры

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

Возвращает

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

write()source public

write( string $key , mixed $data , integer $duration )

Запись данных для ключа в кэш

Параметры

строка $key
Идентификатор данных
смешанный $data
Данные для кэширования
целое число $duration
Срок кэширования данных в секундах

Возвращает

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

Методы, унаследованные от CacheEngine

groups()source public

groups( )

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

Возвращает

массив

settings()source public

settings( )

Настройки кэша

Возвращает

массив
настройки

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

$_Filesource

protected File

Экземпляр класса SplFileObject

null

$_initsource

protected boolean

True, если FileEngine::__active(); выполняется успешно

true

$settingssource

public массив

Настройки

  • path = абсолютный путь к каталогу кэша, по умолчанию => CACHE
  • prefix = префикс для имени файла, по умолчанию => cake_
  • lock = включить блокировку файла при записи, по умолчанию => true
  • serialize = сериализовать данные, по умолчанию => true

См.

CacheEngine::__defaults
array()

© 2005–2016 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.
http://api.cakephp.org/2.8/class-FileEngine.html

Spec-Zone.ru

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