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

Класс: AbstractRepository

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

Базовый Cycle ORM-репозиторий с фильтрацией, пагинацией и метаданными колонок.

Свойства

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

Методы

Подробности

  • Путь: devcraft/src/classes/Abstracts/AbstractRepository.php

Детали

Методы

getFirst()

Возвращает самую раннюю запись по дате создания.

С версии: 200.4.0

Возвращает: object|null — Первая сущность или null, если таблица пуста.

getLast()

Возвращает самую позднюю запись по дате создания.

С версии: 200.4.0

Возвращает: object|null — Последняя сущность или null, если таблица пуста.

limit()

Возвращает ограниченный набор записей с заданным смещением.

С версии: 200.4.0

Параметры: - $total — Количество записей. - $start — Смещение от начала выборки.

Возвращает: array<int, — object> Список сущностей.

total()

Возвращает общее количество записей в таблице сущности.

С версии: 200.4.0

Возвращает: int — Число строк.

findFiltered()

Выполняет фильтрованную выборку с пагинацией и сортировкой.

С версии: 200.4.0

Параметры: - $page — Номер страницы (начиная с 1). - $perPage — Записей на странице. - $order — Колонка сортировки. - $sort — Направление (asc или desc). - $allowedOrderColumns — Допустимые колонки сортировки. - $defaultOrder — Колонка сортировки по умолчанию.

Возвращает: array{items: object[], total: int} — Элементы текущей страницы и общее количество.

distinctColumnValues()

Возвращает уникальные значения указанной колонки для выпадающих фильтров.

С версии: 200.4.0

Параметры: - $column — Имя колонки в таблице сущности.

Возвращает: list<string> — Отсортированный список уникальных строковых значений.

columnBounds()

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

С версии: 200.4.0

Параметры: - $column — Имя колонки в таблице сущности.

Возвращает: array{min: mixed, max: mixed} — Границы диапазона или null при отсутствии данных.

deleteEntity()

Удаляет сущность из базы данных.

С версии: 200.4.0

Параметры: - $entity — Экземпляр сущности для удаления.

Возвращает: bool — Всегда true при успешном вызове менеджера ORM.

deleteByColumn()

Удаляет первую запись, соответствующую значению колонки.

С версии: 200.4.0

Параметры: - $column — Имя колонки для поиска. - $value — Значение для сравнения.

Возвращает: bool — true, если запись найдена и удалена; иначе false.

applyCriteria()

Применяет список критериев фильтрации к объекту выборки Cycle ORM.

С версии: 200.4.0

Параметры: - $select — Объект выборки Cycle ORM.

applyBetween()

Добавляет условие диапазона between к выборке.

С версии: 200.4.0

Параметры: - $select — Объект выборки Cycle ORM. - $column — Имя колонки.

extractColumnValue()

Извлекает строковое значение колонки из строки результата выборки.

С версии: 200.4.0

Параметры: - $row — Строка результата (сущность, массив или объект). - $column — Имя колонки.

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

stringifyColumnValue()

Преобразует значение колонки в строку для фильтров и отображения.

С версии: 200.4.0

Параметры: - $value — Исходное значение.

Возвращает: string — Строковое представление.