Документация для разработчиков
Темная тема

QueryBindSelect

Описание и параметры

Только для Oracle версии!



mixed
CDatabase::QueryBindSelect(
	string sql,
	array binds,
	bool ignore_errors=false,
	string error_position="" 
)

Выполняет SQL-запрос типа "SELECT", в котором есть необходимость связывание переменных. Нестатический метод.

В случае успешного выполнения метод возвращает объект класса CDBResult.
Если произошла ошибка и параметр ignore_errors равен "true", то метод вернет "false".
Если произошла ошибка и параметр ignore_errors равен "false", то метод прерывает выполнение страницы, выполняя перед этим следующие действия:

  1. Вызов функции AddMessage2Log.
  2. Если текущий пользователь является администратором сайта, либо в файле /bitrix/php_interface/dbconn.php была инициализирована переменная $DBDebug=true;, то на экран будет выведен полный текст ошибки, в противном случае будет вызвана функция SendError.
  3. Будет подключен файл /bitrix/php_interface/dbquery_error.php, если он не существует, то будет подключен файл /bitrix/modules/main/include/dbquery_error.php

Параметры

ПараметрОписание
sql SQL запрос.
binds Массив полей типа BLOB, CLOB, LONG и т.п. в формате array("имя поля" => "значение" [, ...])
ignore_errors Игнорировать ошибки. Если true, то в случае ошибки метод возвращает "false". Если параметр ignore_errors равен "false", то в случае ошибки метод прекращает выполнение всей страницы.
Необязательный. По умолчанию - "false".
error_position Строка идентифицирующая позицию в коде, откуда был вызван метод CDatabase::QueryBindSelect. Если в SQL запросе будет ошибка и если в файле /bitrix/php_interface/dbconn.php установлена переменная $DBDebug=true;, то на экране будет выведена данная информация и сам SQL запрос.

Примеры использования

<?
$strSql = "
	SELECT 
		*
	FROM
		my_table
	WHERE
		:url like '/ru/index.php%'
	";
$arrBind = array("url" => $APPLICATION->GetCurUri());
$rs = $DB->QueryBindSelect($strSql, $arrBind, false, "F: ".__FILE__." L: ".__LINE__);
?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024