Класс: DataManager

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

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

---

Свойства

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

---

Методы

• public abbr()
• public dirToArray()
• public createDir()
• public setPermission()
• public joinPaths()
• public deleteDir()
• public nameArgs()
• public defType()
• public getComparer()
• public saveConfig()
• public getConfig()
• public normalizePath()
• public getPrefix()
• public getUserPrefix()
• public toTranslit()
• public sanitizeArrayInput()
• public sanitizeInput()
• public createLockFile()
• public normalizeUrl()
• private loadJsonConfig()
• private migrateOldConfig()
• private scanDirectory()

---

Подробности

• Путь: 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> — Дерево каталога.