Download the PHP package fibit/bitrix-entity-helper without Composer
On this page you can find all versions of the php package fibit/bitrix-entity-helper. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download fibit/bitrix-entity-helper
More information about fibit/bitrix-entity-helper
Files in fibit/bitrix-entity-helper
Package bitrix-entity-helper
Short Description Entity Helper Class for the Bitrix Framework
License MIT
Homepage https://github.com/fibit/bitrix-entity-helper
Informations about the package bitrix-entity-helper
Bitrix-Entity-Helper
Удобный хелпер для работы с сущностями Битрикса.
Хелпер умеет работать с данными в Инфоблоках, Highload-блоках и системных таблицах.
Установка
-
Установить через composer:
- Добавить подключение автозагрузчика:
Методы
тип | метод | параметры | назначение |
---|---|---|---|
static | getClass | entity |
инициализация класса указанной сущности |
static | getQuery | entity params alias |
формирование sql-запроса без исполнения в БД |
static | getRows | entity params |
получение списка элементов fetchAll |
static | getRow | entity params |
получение одного элемента fetch |
static | addRow | entity fields |
добавление элемента |
static | updRow | entity id fields |
обновление элемента |
static | delRow | entity id |
удаление элемента |
[!IMPORTANT]
entity
может иметь один из трех типов значений:
- int - для обычных инфоблоков
- string - для highload-блоков
- object - для системных сущностей
Примеры
1. Метод getClass
2. Метод getQuery
Метод поддерживает вызовы ExpressionField и ReferenceField.
Результат:
3. Метод getRows
Метод поддерживает вызовы ExpressionField и ReferenceField.
Результат:
3.1. Постраничная навигация
Если вы установите параметр count_total => true
в методе, то результат выполнения запроса вернет объект nav
. Этот объект можно будет использовать в компоненте bitrix:main.pagenavigation
для отображения постраничной навигации. По умолчанию будет загружаться 20 записей, но вы можете изменить это, указав другое значение для limit
при вызове метода.
[!IMPORTANT] Определение текущей страницы в навигационной цепочке происходит на основании данных из URL, поэтому в случае использования формы, например для фильтрации, следует отправлять её методом GET.
3.2. Пример работы с ExpressionField
Например, у нас есть highload-инфоблок "Operations" со структурой: | ID | UF_DATETIME | UF_MEMBER | UF_SUM |
---|---|---|---|---|
1 | 01.01.2024 10:00:00 | Иванов И. | 100 | |
2 | 01.01.2024 10:20:00 | Иванов И. | 100 | |
3 | 01.01.2024 12:50:00 | Петров П. | 100 |
И нам нужно получить сумму UF_SUM
по каждому UF_MEMBER
за период с 01.01.24 00:00 по 01.01.24 23:59
:
Результат:
4. Метод getRow
Метод поддерживает вызовы ExpressionField и ReferenceField.
Результат:
5. Метод addRow
Результат:
6. Метод updRow
Результат:
7. Метод delRow
Результат: