Выполнить запрос без результата Connection::queryExecute
Модуль: main — подключать отдельно не нужно
Доступно с версии: 14.0.0
Метод Connection::queryExecute выполняет SQL-запрос через query и не возвращает результат. Метод подходит для запросов INSERT, UPDATE, DELETE и изменения структуры таблиц.
Сигнатура метода в классе Bitrix\Main\DB\Connection:
public function queryExecute($sql, ?array $binds = null)
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| sql* | string |
Задает текст SQL-запроса |
| binds | array, null |
Передает массив значений в сведения о запросе для startTracker. Реализации MySQL и PostgreSQL не подставляют эти значения в текст запроса. По умолчанию — null |
Тип sql в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.
Возвращаемое значение
Метод ничего не возвращает. Метод getAffectedRowsCount возвращает число измененных строк.
Исключения
| Исключение | Когда возникает |
|---|---|
Bitrix\Main\DB\SqlQueryException |
База данных вернула ошибку при выполнении запроса |
Bitrix\Main\DB\DuplicateEntryException |
Запрос нарушил уникальность ключа. Класс наследует SqlQueryException |
Bitrix\Main\DB\ConnectionException |
Подключиться к базе данных не удалось |
Примеры
Пример. Код создает рабочую таблицу, добавляет строку, меняет ее и выводит число измененных строк. Блок finally удаляет таблицу:
<?php
use Bitrix\Main\Application;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$connection = Application::getConnection();
$helper = $connection->getSqlHelper();
$table = $helper->quote('demo_api_status');
$connection->queryExecute("CREATE TABLE {$table} (ID INT NOT NULL, STATUS VARCHAR(20) NOT NULL)");
try
{
$connection->queryExecute("INSERT INTO {$table} (ID, STATUS) VALUES (1, 'new')");
$connection->queryExecute("UPDATE {$table} SET STATUS = '" . $helper->forSql('done') . "' WHERE ID = 1");
echo $connection->getAffectedRowsCount();
}
finally
{
$connection->dropTable('demo_api_status');
}
Смотрите также
Была ли статья полезна?
Предыдущая
Следующая