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

Класс: \AssetsChecker

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

Трейт для проверки и управления ассетами (файлы скриптов и стилей).


Свойства


Методы


Подробности

  • Путь: engine/inc/maharder/_includes/traits/AssetsChecker.php

Свойства

private $asset_file : string


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

Файл с информацией и хешами вспомогательных файлов

Тип: Текст

private $assets_arr : array


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

Массив со всеми данными для обновления стилей и скриптов

Тип: Массив

private $assets_dir : string


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

Путь до всех вспомогательных файлов

Тип: Текст


Методы

checkAssets

Text Only
public checkAssets(bool  rewrite = false) : array
Краткое содержание

Проверяет целостность файлов между локальным хранилищем и сервером разработчика.

Описание

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

Смотри так-же:
Свойства:
Название Тип По умолчанию
$rewrite bool false
Ошибки:
Тип Описание
\JsonException
Возвращает:

Text Only
array
Ассоциативный массив с информацией о проверке файлов: - on_server (int): Количество файлов, находящихся на сервере разработчика. - local (int): Количество локальных файлов. - missing_count (int): Количество недостающих файлов. - update_count (int): Количество файлов, требующих обновления. - missing (array): Массив с данными о недостающих файлах. - update (array): Массив с данными о файлах, требующих обновления.


parseAssets

Text Only
public parseAssets(bool  parse = false) : void
Краткое содержание

Выполняет парсинг вспомогательных файлов для управления ассетами.

Описание

Если файл с хешами ассетов существует, то парсинг выполняется только при принудительном запуске. В случае отсутствия указанного файла производится полное сканирование ассетов.

Смотри так-же:
Свойства:
Название Тип По умолчанию
$parse bool false
Ошибки:
Тип Описание
\JsonException|\Throwable В случае ошибок в процессах обработки JSON-файлов.
Возвращает:
Text Only
void

save_asset

Text Only
public save_asset(array  data, string  file) : array|false
Краткое содержание

Сохраняет файл на сервер и возвращает информацию о нём или false в случае неуспеха.

Смотри так-же:
Свойства:
Название Тип По умолчанию
$data array
$file string
Ошибки:
Тип Описание
\JsonException \Throwable
Возвращает:

Text Only
array|false
Возвращает массив с информацией о сохранённом файле или false, если файл не удалось сохранить. Массив содержит следующие ключи: - 'realpath' (string): Полный реальный путь до файла. - 'dirname' (string): Директория файла. - 'basename' (string): Имя файла с расширением. - 'filename' (string): Имя файла без расширения. - 'extension' (string): Расширение файла. - 'mime' (string): MIME-тип файла. - 'encoding' (string): Тип кодирования файла. - 'size' (int): Размер файла в байтах. - 'size_string' (string): Размер файла в человекочитаемом формате (например, "1.5MB"). - 'atime' (int): Время последнего доступа к файлу (в метках времени Unix). - 'mtime' (int): Время последней модификации файла (в метках времени Unix). - 'permission' (string): Права доступа на файл (в формате UNIX-подобной строки, например, "0755").


fetchFileContent

Text Only
private fetchFileContent(array  data) : string|null
Краткое содержание

Получает содержимое файла по указанным ссылкам.

Описание

Метод пытается загрузить содержимое файла с основной (link) и, при необходимости, с альтернативной (alt) ссылки, если содержимое по основной ссылке пустое.

Свойства:
Название Тип По умолчанию
$data array
Возвращает:

Text Only
string|null
Возвращает содержимое файла, либо null, если не удалось загрузить файл.


generateFileMetadata

Text Only
private generateFileMetadata(string  file_path) : array
Краткое содержание

Генерирует метаданные для указанного файла.

Свойства:
Название Тип По умолчанию
$file_path string
Ошибки:
Тип Описание
\RuntimeException Если файл не существует или недоступен.
Возвращает:

Text Only
array
Ассоциативный массив, содержащий следующую информацию о файле: - 'realpath' (string|null): Абсолютный путь до файла. - 'dirname' (string): Путь к директории, содержащей файл. - 'basename' (string): Имя файла с расширением. - 'filename' (string): Имя файла без расширения. - 'extension' (string|null): Расширение файла. - 'mime' (string): MIME-тип файла. - 'encoding' (string): Кодировка файла. - 'size' (int): Размер файла в байтах. - 'size_string' (string): Читаемое представление размера файла (например, "10.5 KB"). - 'atime' (int): Временная метка последнего доступа к файлу. - 'mtime' (int): Временная метка последней модификации файла. - 'permission' (string): Права доступа к файлу (например, "0755").


parse_assets

Text Only
private parse_assets() : void
Краткое содержание

Парсит данные о ресурсах (assets), проверяет наличие отсутствующих или обновленных, и обновляет информацию. Также сохраняет актуальные данные в локальный файл ресурсов.

Описание

Процесс включает следующие этапы: 1. Получение списка локальных файлов и их данных через метод prepare_assets. 2. Получение данных об удаленных ресурсах через URL. 3. Сравнение данных о хэшах локальных и удаленных ресурсов. 4. Сохранение недостающих или обновленных ресурсов в локальное хранилище. 5. Запись актуализированных данных в локальный JSON-файл.

Смотри так-же:
Ошибки:
Тип Описание
\JsonException|\Throwable Исключение выбрасывается в случае ошибки при работе с JSON.
Возвращает:
Text Only
void

prepare_assets

Text Only
private prepare_assets(array  arr, string  dir = __DIR__) : void
Краткое содержание

Подготавливает данные о файлах, расположенных на локальном сервере, и сохраняет их в массив assets_arr.

Описание

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

Свойства:
Название Тип По умолчанию
$arr array
$dir string __DIR__
Возвращает:
Text Only
void

saveFile

Text Only
private saveFile(string  file_path, string  content, string  file) : bool
Краткое содержание

Сохраняет содержимое в файл и логирует сообщение при возникновении ошибки.

Описание

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

Смотри так-же:
Свойства:
Название Тип По умолчанию
$file_path string
$content string
$file string
Ошибки:
Тип Описание
\Throwable
Возвращает:

Text Only
bool
Возвращает true, если файл успешно сохранён, или false — в случае ошибки.