MysqliSqlHelper — SQL для MySQL

Пространство имен: Bitrix\Main\DB

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

Доступно с версии: 12.0.7

Когда использовать

Класс MysqliSqlHelper — реализация SqlHelper для MySQL. Объект возвращает метод getSqlHelper соединения MysqliConnection, создавать его конструктором не нужно.

Класс SqlHelper описывает все методы, которые вызывает код приложения. Собственных методов у класса нет.

Наследование

Класс наследует SqlHelper.

Реализация методов базового класса

Метод Особенность реализации
getLeftQuote, getRightQuote Возвращают обратную кавычку `
getAliasLength Возвращает 256
getQueryDelimiter Возвращает ;
forSql Экранирует строку методом mysqli::real_escape_string. Подключается к базе данных, если подключения еще нет
getCurrentDateTimeFunction Возвращает NOW()
getCurrentDateFunction Возвращает CURDATE()
addSecondsToDateTime Строит DATE_ADD(<from>, INTERVAL <seconds> SECOND)
addDaysToDateTime Строит DATE_ADD(<from>, INTERVAL <days> DAY)
getDatetimeToDateFunction Строит DATE(<value>)
formatDate Переводит формат в обозначения DATE_FORMAT, например YYYY в %Y
getConcatFunction Строит CONCAT(...). Без аргументов возвращает пустую строку
getIsNullFunction Строит IFNULL(...)
getLengthFunction Строит LENGTH(...)
getCharToDateFunction Возвращает дату в одинарных кавычках
getDateToCharFunction Возвращает колонку без изменений
castToChar Строит CAST(<fieldName> AS char)
softCastTextToChar Возвращает колонку без изменений
getConverter Возвращает функции преобразования для полей даты и даты и времени
convertFromDbDate Разбирает дату в формате Y-m-d. Для null и 0000-00-00 возвращает null
convertFromDbDateTime Разбирает дату и время в формате Y-m-d H:i:s. Для null и 0000-00-00 00:00:00 возвращает null
getColumnTypeByField Использует типы int, bigint, double, datetime, longtext и другие типы MySQL
getFieldByColumnType Принимает константы MYSQLI_TYPE_*
getTopSql Добавляет LIMIT <offset>, <limit>
prepareMerge Строит INSERT ... ON DUPLICATE KEY UPDATE. Не использует primaryFields
prepareMergeMultiple Строит REPLACE INTO
prepareMergeSelect Строит INSERT ... SELECT ... ON DUPLICATE KEY UPDATE
prepareDeleteLimit Строит DELETE ... ORDER BY ... LIMIT
prepareCorrelatedUpdate Строит UPDATE <таблица> AS <псевдоним>, <другие таблицы> SET ...
getInsertIgnore Строит INSERT IGNORE INTO
getRegexpOperator Строит <field> regexp <regexp>
getIlikeOperator Строит <field> LIKE <value>
values Строит VALUES(`<колонка>`)
getMatchFunction Строит MATCH (...) AGAINST (... IN BOOLEAN MODE)
getMatchAndExpression Собирает +a +b, для поиска по началу — +a* +b*
getMatchOrExpression Собирает a b, для поиска по началу — a* b*
initRowNumber Возвращает set @<имя> = 0
getRowNumber Строит @<имя>:=@<имя> + 1
isBigType Считает большими типы BLOB и JSON
getOrderByStringField, getOrderByIntField Строят выражение FIELD(...) через переопределенный защищенный метод getOrderByField

Унаследованные методы

Остальные методы работают как в классе SqlHelper.

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