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

Класс: DataManager

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

Утилиты работы с файлами, конфигурацией JSON и санитизацией ввода DLE.

Свойства

Нет публичных свойств.

Методы

Подробности

  • Путь: devcraft/src/classes/Support/DataManager.php

Детали

Методы

abbr()

Формирует аббревиатуру из слов строки с суффиксом длины.

С версии: 173.3.0

Параметры: - $string — Исходная строка. - $sep — Разделитель слов.

Возвращает: string — Аббревиатура вида «Abbr_0008».

dirToArray()

Рекурсивно преобразует каталог в массив файлов и подкаталогов.

С версии: 173.3.0

Параметры: - $dir — Путь к каталогу.

Возвращает: array<mixed> — Дерево каталога.

createDir()

Создаёт каталоги с правами 0755, если они ещё не существуют.

С версии: 173.3.0

Возвращает: bool — true при успехе для всех путей.

setPermission()

Создаёт каталоги с указанными правами доступа.

С версии: 200.4.0

Параметры: - $permission — Права в восьмеричном виде.

Возвращает: bool — true при успехе для всех путей.

joinPaths()

Объединяет несколько сегментов пути в один нормализованный путь.

С версии: 173.3.0

Возвращает: string — Объединённый путь.

deleteDir()

Рекурсивно удаляет каталог, кроме защищённых vendor и var/cache.

С версии: 173.3.0

Параметры: - $path — Абсолютный путь к каталогу.

nameArgs()

Преобразует вложенный массив аргументов в плоский ассоциативный массив.

С версии: 173.3.0

Параметры: - $args — Исходные аргументы или null.

Возвращает: array<mixed> — Именованные аргументы без пустых значений.

defType()

Приводит значение к типу через filter_var по имени SQL/PHP-типа.

С версии: 173.3.0

Параметры: - $value — Исходное значение. - $type — Имя типа (int, string, bool и т.д.).

Возвращает: float|bool|int|string — Приведённое значение.

getComparer()

Формирует SQL-фрагмент сравнения с оператором из префикса значения.

С версии: 173.3.0

Параметры: - $value — Значение с опциональным префиксом оператора (!, <, >, %).

Возвращает: string — Фрагмент « OP value» для SQL.

saveConfig()

Сохраняет конфигурацию модуля в JSON-файл.

С версии: 180.3.5

Параметры: - $codename — Имя конфигурации (имя файла без .json). - $configPath — Каталог конфигурации или null для Paths::config().

getConfig()

Загружает конфигурацию из JSON или мигрирует legacy PHP-конфиг DLE.

С версии: 173.3.0

Параметры: - $codename — Имя конфигурации. - $path — Каталог JSON или null. - $confName — Имя legacy PHP-конфига для миграции.

Возвращает: array<string, — mixed> Ассоциативный массив настроек.

normalizePath()

Нормализует путь относительно ROOT_DIR и realpath.

С версии: 173.3.0

Параметры: - $path — Исходный путь.

Возвращает: string — Абсолютный нормализованный путь или пустая строка при ошибке.

getPrefix()

Возвращает префикс таблиц DLE (константа PREFIX).

С версии: 173.3.0

Возвращает: string — Значение PREFIX или пустая строка.

getUserPrefix()

Возвращает префикс пользовательских таблиц DLE (USERPREFIX).

С версии: 173.3.0

Возвращает: string — Значение USERPREFIX или пустая строка.

toTranslit()

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

С версии: 173.3.0

Параметры: - $input — Исходная строка. - $lowercase — Приводить результат к нижнему регистру.

Возвращает: string — Транслитерированная строка.

sanitizeArrayInput()

Рекурсивно санитизирует массив ввода через filter_var.

С версии: 173.3.0

Параметры: - $input — Входные данные. - $flags — Флаги filter_var или null.

Возвращает: mixed — Санитизированный массив или скаляр, null при пустом вводе.

sanitizeInput()

Санитизирует скалярное значение через один или несколько filter_var.

С версии: 173.3.0

Параметры: - $value — Сырое значение. - $flags — Цепочка флагов filter_var.

Возвращает: string|null — Строка или null при неудачной фильтрации.

createLockFile()

Создаёт lock-файл обновлений с меткой времени.

С версии: 173.3.0

Параметры: - $path — Путь к lock-файлу.

normalizeUrl()

Нормализует относительный URL админки DLE с дополнительными query-параметрами.

С версии: 173.3.0

Параметры: - $url — Исходный URL или query.

Возвращает: string — Полный URL админки с query.

loadJsonConfig()

Загружает и санитизирует JSON-конфигурацию из файла.

С версии: 173.3.0

Параметры: - $filePath — Путь к .json файлу.

Возвращает: array<string, — mixed> Декодированный массив.

migrateOldConfig()

Мигрирует legacy PHP-конфиг DLE в JSON и удаляет старый файл.

С версии: 173.3.0

Параметры: - $codename — Имя конфигурации DevCraft. - $confName — Имя переменной legacy-конфига. - $configPath — Каталог для JSON.

Возвращает: array<string, — mixed> Загруженные настройки.

scanDirectory()

Рекурсивно сканирует каталог в массив (внутренний метод dirToArray).

С версии: 173.3.0

Параметры: - $dir — Путь к каталогу. - $ignoredExtensions — Игнорируемые имена и расширения.

Возвращает: array<mixed> — Дерево каталога.