Преобразовать значение для базы данных ExpressionField::convertValueToDb

Модуль: main — подключать отдельно не нужно

Метод ExpressionField::convertValueToDb преобразует значение в строку для SQL-запроса. Метод вызывает convertValueToDb поля типа значения. Запрос использует метод, когда строит условие фильтра по выражению.

Сигнатура метода в классе Bitrix\Main\ORM\Fields\ExpressionField:

public function convertValueToDb($value)

Параметры

Обязательные параметры обозначены *

Параметр Тип Описание
value* mixed Задает значение

Возвращаемое значение

Метод возвращает строку для подстановки в SQL, например число или строку в кавычках.

Особенности

Метод работает только после привязки поля к сущности.

Примеры

Пример. Код преобразует значение для целого и строкового типа:

<?php
use Bitrix\Main\Localization\LanguageTable;
use Bitrix\Main\ORM\Fields\ExpressionField;
use Bitrix\Main\ORM\Fields\IntegerField;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

$query = LanguageTable::query()
    ->registerRuntimeField((new ExpressionField('NAME_LEN', 'LENGTH(%s)', 'NAME'))->configureValueType(IntegerField::class))
    ->registerRuntimeField(new ExpressionField('NAME_UP', 'UPPER(%s)', 'NAME'));

$entity = $query->getEntity();

echo $entity->getField('NAME_LEN')->convertValueToDb('7') . ' ' . $entity->getField('NAME_UP')->convertValueToDb('kg');

Код выведет 7 'kg'.

Смотрите также