---

Сложные запросы

В демо-версии системы доступны два дополнительных инструмента для построения сложных запросов: класс `JoinField` для работы с JOIN-условиями и класс `FieldHandler` для операций над полями.

---

JoinField

Класс `JoinField` предназначен для описания полей, используемых в JOIN-условиях. Он позволяет указать базу данных, таблицу и имя поля отдельно, что удобно при работе с несколькими базами данных или когда требуются алиасы таблиц.

Класс предоставляет fluent-интерфейс для установки свойств.

php
$field = new JoinField()
    ->setBase('main_db')
    ->setTable('users')
    ->setField('user_id');

Методы

Метод	Описание
setBase($base)	Устанавливает имя базы данных
setTable($table)	Устанавливает имя таблицы или алиас
setField($field)	Устанавливает имя поля

FieldHandler

Класс FieldHandler позволяет применять различные операции к полям в SELECT-запросе. Поддерживаются агрегатные функции, условные операции и преобразования.

php
$handler = new FieldHandler()
    ->setBase('main_db')
    ->setTable('users')
    ->setField('created_at')
    ->setIfNull('1970-01-01');

Методы

Метод	Описание
setCount()	Применяет COUNT к полю
setMin()	Применяет MIN к полю
setMax()	Применяет MAX к полю
setIfNull($override)	Заменяет NULL на указанное значение
setReplace($search, $override)	Заменяет вхождение $search на $override
setConcat($list)	Объединяет несколько полей в строку
setGroupConcat()	Применяет GROUP_CONCAT (агрегация строк)
setAlias($value)	Устанавливает алиас для поля
setBase($value)	Устанавливает базу данных
setTable($value)	Устанавливает таблицу или алиас
setField($value)	Устанавливает имя поля
setFlag($value)	Устанавливает дополнительный флаг

Пример: JOIN с несколькими условиями

В этом примере JoinField используется для построения JOIN-условия между таблицами languages и project_languages с фильтрацией по project_id.

php
public static function getActive()
{
    $pLanguage = PL::getBase() . '.' . PL::$_table;
    
    return (static::getSelect())
        ->addWhere(
            static::createWhere(
                // Основное поле
                (new JoinField())
                    ->setBase(self::getBase())
                    ->setTable(self::$_table)
                    ->setField(self::LANGUAGE_ID),
                null,
                Where::NOT_NULL,
                [PL::getBase(), PL::$_table],
                [
                    // Условие связи: language_id = language_id
                    static::createWhere(
                        (new JoinField())
                            ->setBase(PL::getBase())
                            ->setTable(PL::$_table)
                            ->setField(PL::LANGUAGE_ID),
                        (new JoinField())
                            ->setBase(self::getBase())
                            ->setTable(self::$_table)
                            ->setField(self::LANGUAGE_ID)
                    ),
                    // Условие фильтрации: project_id = CURRENT_PROJECT
                    static::createWhere(
                        (new JoinField())
                            ->setBase(PL::getBase())
                            ->setTable(PL::$_table)
                            ->setField(PL::PROJECT_ID),
                        CURRENT_PROJECT
                    )
                ]
            )
        )
        ->order([
            (new FieldHandler())
                ->setBase(PL::getBase())
                ->setTable(PL::$_table)
                ->setField(PL::PROJECT_LANGUAGE_ORDER)
                ->setIfNull('9999')
        ])
        ->result();
}

Что здесь происходит

- Создаётся JoinField для поля LANGUAGE_ID основной таблицы.

- В JOIN добавляется таблица project_languages.

- Добавляются два условия:

- Связь по полю language_id и фильтр по project_id = CURRENT_PROJECT

- Для сортировки используется FieldHandler с setIfNull(), который заменяет NULL на 9999, чтобы записи без порядка сортировки оказались в конце.

Пример: сортировка с заменой NULL

php
$order = [
    (new FieldHandler())
        ->setBase('users')
        ->setTable('profiles')
        ->setField('display_order')
        ->setIfNull('9999')
];

В результате в ORDER BY будет добавлено: IFNULL(users.profiles.display_order, "9999")

Пример: агрегатные функции

php
$field = (new FieldHandler())
    ->setBase('orders')
    ->setTable('order_items')
    ->setField('price')
    ->setMax()
    ->setAlias('max_price');

Результат в SELECT: MAX(orders.order_items.price) AS max_price

Пример: объединение полей (CONCAT)

php
$field = (new FieldHandler())
    ->setConcat(['first_name', 'last_name'])
    ->setAlias('full_name');

Результат в SELECT: CONCAT(first_name, last_name) AS full_name

Пример: GROUP_CONCAT

php
$field = (new FieldHandler())
    ->setBase('products')
    ->setTable('categories')
    ->setField('name')
    ->setGroupConcat()
    ->setAlias('categories_list');

Результат в SELECT: GROUP_CONCAT(products.categories.name) AS categories_list

Пример: замена значения (REPLACE)

php
$field = (new FieldHandler())
    ->setBase('content')
    ->setTable('pages')
    ->setField('url')
    ->setReplace('old-domain.com', 'new-domain.com');

Результат в SELECT: REPLACE(content.pages.url, &

039;old-domain.com', 'new-domain.com')

Особенности использования

JoinField и FieldHandler предназначены для работы в связке с Select и createWhere.

JoinField может использоваться как в качестве поля, так и в качестве значения в createWhere.

FieldHandler поддерживает цепочку вызовов, что делает код более читаемым.

При использовании нескольких баз данных обязательно указывать setBase() для каждого поля.

Что дальше?

- ➡️ Раздел 19. Модели
- ➡️ Раздел 20. JSON-данные
- ➡️ Раздел 21. Типы контроллеров