Получить сообщение об ошибке Connection::getErrorMessage

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

Метод Connection::getErrorMessage возвращает сообщение базы данных об ошибке последней операции на этом подключении. Аналог в классическом API — CDatabase::GetErrorMessage.

Метод query передает сообщение в исключение SqlQueryException. При обработке исключения читайте сообщение методом исключения getDatabaseMessage. Если установлен модуль кластера cluster, запрос SELECT может выполнить соединение с репликой, и getErrorMessage основного соединения вернет сведения о другой операции.

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

abstract public function getErrorMessage();

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

Метод возвращает строку string. Формат зависит от реализации.

Реализация Формат
MysqliConnection Код и текст ошибки, например (1054) Unknown column 'X' in 'field list'. Если ошибки не было, код равен 0, а текст пустой
PgsqlConnection Текст функции pg_last_error

Вызывайте метод, только когда подключение уже открыто. Реализации обращаются к ресурсу подключения напрямую.

Примеры

Пример. Код выполняет ошибочный запрос и выводит сообщение базы данных из исключения и из соединения:

<?php
use Bitrix\Main\Application;
use Bitrix\Main\DB\SqlQueryException;
use Bitrix\Main\UserTable;

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

$connection = Application::getConnection();

try
{
    $connection->query('SELECT MISSING_COLUMN FROM ' . UserTable::getTableName());
}
catch (SqlQueryException $exception)
{
    echo $exception->getDatabaseMessage() . PHP_EOL;
    echo $connection->getErrorMessage();
}

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