balamarket.orm

Модуль bitrix для работы с инфоблоками через ORM

Модель

В своем модуле создаете entity для конкретного инфоблока. К примеру:

/local/
    modules/
    <ваш модуль>/
        content/
            news.php - Класс инфоблока
            newspropsimple.php - Класс свойств инфоблока
            newspropmultiple.php - Класс множественных свойств инфоблока
            newssection.php - Класс разделов инфоблока

В файле include.php вашего модуля подключим модуль balamarket.orm

use Bitrix\Main\Loader;

Loader::includeModule("balamarket.orm");

Для того, чтоб классы могли знать друг о друге используется правило наименования:

<Сущность>Table
<Сущность>PropSimpleTable
<Сущность>PropMultipleTable
<Сущность>SectionTable

Все 4 класса обязательно должны лежать в одном namespace. Еще одно обязательное условие, свойства инфоблока должны находиться в отдельной таблице. http://dev.1c-bitrix.ru/learning/course/?COURSE_ID=43&LESSON_ID=2723

Класс NewsTable инфоблока наследуем от Balamarket\Orm\Entity\IblockElement

<?php
namespace <ваш модуль>\Content;

class NewsTable extends \Balamarket\Orm\Entity\IblockElement
{
    public static function getIblockCode()
    {
        return "news";
    }
}

Класс NewsPropSimpleTable свойств инфоблока наследуем от Balamarket\Orm\Entity\IblockPropSimple

<?php
namespace <ваш модуль>\Content;

class NewsPropSimpleTable extends \Balamarket\Orm\Entity\IblockPropSimple
{
    public static function getIblockId()
    {
        return NewsTable::getIblockId();
    }
}

Класс NewsPropMultipleTable множественных свойств инфоблока наследуем от Balamarket\Orm\Entity\IblockPropMultiple

<?php
namespace <ваш модуль>\Content;

class NewsPropMultipleTable extends \Balamarket\Orm\Entity\IblockPropSimple
{
    public static function getIblockId()
    {
        return NewsTable::getIblockId();
    }
}

Класс NewsSectionTable разделов инфоблока наследуем от Balamarket\Orm\Entity\IblockSection

<?php
namespace <ваш модуль>\Content;

class NewsSectionTable extends \Balamarket\Orm\Entity\IblockSection
{
    public static function getIblockId()
    {
        return NewsTable::getIblockId();
    }
}

Выборка

Во время выборки можно использовать все поля указанные в методе getMap()

Доступны специальные поля в getMap():

\Balamarket\Orm\Entity\IblockElement

DETAIL_PAGE_URL - формируется из настроек инфоблока

// Если есть класс с разделами то доступны ссылки на него
SECTION - \Balamarket\Orm\Entity\IblockSection
SECTIONS - Множественная привязка к разделам \Balamarket\Orm\Entity\IblockSection

\Balamarket\Orm\Entity\IblockPropSimple

IBLOCK_ELEMENT - Доступ к \Balamarket\Orm\Entity\IblockElement

\Balamarket\Orm\Entity\IblockSection

DETAIL_PAGE_URL - формируется из настроек инфоблока
PARENT_SECTION - Родительскй раздел \Balamarket\Orm\Entity\IblockSection

Для доступа к свойствам используются резервированные названия полей:

PROPERTY_SIMPLE.<символьный код свойства>
PROPERTY_MULTIPLE_<символьный код свойства>.VALUE

Примеры:

use <ваш модуль>\Content\NewsTable;
$obNews = NewsTable::getList(
    array(
        "select" => array(
            "ID",
            "NAME",
            "SOURCE_LINK" => "PROPERTY_SIMPLE.SOURCE_LINK"
        ),
        "filter" => array(
            "=ACTIVE" => "Y",
            "!PROPERTY_SIMPLE.SOURCE_LINK" => false
        ),
    )
);

while($arNew = $obNews->fetch()) {
    // code
}

Примеры работы с множественными свойствами:

use <ваш модуль>\Content\NewsTable;
$obNews = NewsTable::getList(
    array(
        "select" => array(
            "ID",
            "NAME",
            "PHONES"
        ),
        "runtime" => array(
            "PHONES" => array(
                "data_type" => "string",
                "expression" => array(
                    "GROUP_CONCAT(%s)",
                    "PROPERTY_MULTIPLE_PHONE.VALUE"
                )
            )
        ),
        "filter" => array(
            "=ACTIVE" => "Y",
            "!PROPERTY_MULTIPLE_PHONE.VALUE" => false
        ),
    )
);

while($arNew = $obNews->fetch()) {
    // code
}