Перейти к содержанию

Абстрактный класс: CacheControl

Краткое содержание:

Абстрактный класс для реализации управления кэшированием.

Описание:

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

Может быть дополнен реализацией в наследниках для поддержки специфичных стратегий кэширования.


Свойства


Методы


Подробности

  • Путь: engine/inc/maharder/_includes/classes/CacheControl.php

Свойства

private $path : ?string


Краткое содержание

Определяет путь до кеша.

Описание

Используется для хранения или извлечения пути, где будут сохраняться данные кеша. Значение может быть null, если путь не был задан.

Тип: Текст или null

Подробности: * Смотри так-же: * Для получения текущего пути. * Для задания пути.

Tags
Тэг Версия Описание
version 170.2.10

Методы

clearCache

Text Only
static public clearCache(string|array  type = "all") : void
Краткое содержание

Очищает кеш для указанного типа или списка типов.

Описание

Работает по следующему алгоритму: - Если передан строковый тип и значение "all", очищается вся директория кеша. - Если передан массив типов, очистка выполняется рекурсивно для каждого типа. - В случае конкретного типа, очищается соответствующий подкаталог.

Смотри так-же:
Свойства:
Название Тип По умолчанию
$type string|array 'all'
Ошибки:
Тип Описание
\JsonException Исключение может быть выброшено, если возникают ошибки при работе с JSON-библиотекой (например, при вызовах методов, зависящих от внутренних реализаций).
Возвращает:

Text Only
void
Функция ничего не возвращает.


getCache

Text Only
static public getCache(string  type, string  name) : false|array|int
Краткое содержание

Получает данные из кеша, преобразуя имена и типы в транслит и извлекая содержимое файла с последующим декодированием данных из JSON.

Описание

Инициализирует путь к кешу, если он не был установлен ранее. Данные извлекаются из файла с учетом типа и имени, которые преобразуются в транслит. Если файл отсутствует или недоступен, функция возвращает false. Если данные присутствуют, они декодируются из формата JSON и в случае ошибки выбрасывается исключение JsonException.

Смотри так-же:
Свойства:
Название Тип По умолчанию
$type string
$name string
Ошибки:
Тип Описание
\JsonException|\Throwable Если произошла ошибка при декодировании JSON.
Возвращает:

Text Only
false|array|int
Возвращает массив данных, число или false в случае ошибки.


getPath

Text Only
static public getPath() : string|null
Краткое содержание

Возвращает текущий путь, если он установлен.

Возвращает:

Text Only
string|null
Возвращает путь как строку, либо null, если путь не установлен.


init

Text Only
static public init(string|null  path = null) : void
Краткое содержание

Инициализирует систему, устанавливая путь для кэша.

Описание

Функция получает конфигурацию с помощью DataManager::getConfig(), определяет путь для хранения кэша (приоритет отдается переданному аргументу $path, затем значению из конфигурации, в последнюю очередь используется стандартный путь), нормализует его и устанавливает через self::setPath().

Смотри так-же:
Свойства:
Название Тип По умолчанию
$path string|null null
Ошибки:
Тип Описание
\JsonException Если данные конфигурации, получаемые из JSON, не могут быть прочитаны или обработаны.
Возвращает:
Text Only
void

setCache

Text Only
static public setCache(string  type, string  name, mixed  data) : void
Краткое содержание

Сохраняет данные в кэше путем создания файла с содержимым в JSON-формате.

Описание

Функция выполняет следующие действия: - Преобразует имя и тип кэша в транслитерацию для формирования имени файла и пути директории. - Проверяет и создает директорию, если она отсутствует. - Сериализует переданные данные в JSON и записывает их в файл. - Логирует возможные ошибки сериализации и записи данных.

Смотри так-же:
Свойства:
Название Тип По умолчанию
$type string
$name string
$data mixed
Ошибки:
Тип Описание
\JsonException Если возникает ошибка при сериализации данных в JSON.
\Throwable Если возникает ошибка при записи данных в файл.
Возвращает:
Text Only
void

setPath

Text Only
static public setPath(string  path) : void
Краткое содержание

Устанавливает значение переменной пути.

Описание

Метод задаёт значение для статической переменной $path, которая может быть использована для хранения пути.

Смотри так-же:
Свойства:
Название Тип По умолчанию
$path string
Возвращает:
Text Only
void