(PHP 5 >= 5.1.0, PHP 7, PHP 8)
pg_set_error_verbosity — Определяет объем текста сообщений, возвращаемых функциями pg_last_error() и pg_result_error()
Определяет объем текста сообщений, возвращаемых функциями pg_last_error() и pg_result_error().
pg_set_error_verbosity() устанавливает режим, отвечающий за полноту сообщений об ошибках. В режиме PGSQL_ERRORS_TERSE
сообщения будут содержать только важность ошибки, основной текст и место возникновения; эта информация обычно умещается в одну строку. В режиме по умолчанию PGSQL_ERRORS_DEFAULT
в сообщения будут добавлены детали ошибки, подсказка или поля контекста (это может занять несколько строк). В режиме PGSQL_ERRORS_VERBOSE
сообщения будут содержать все возможные поля. Изменение режима не затронет сообщения уже существующих ресурсов. Новый режим будет применяться только к вновь создаваемым.
connection
Экземпляр класса PgSql\Connection. Если параметр connection
не указали, функция выберет соединение по умолчанию. Соединение по умолчанию — это последнее соединение, которое установила функция pg_connect() или pg_pconnect().
Начиная с версии PHP 8.1.0 использование соединения по умолчанию устарело.
verbosity
Требуемый режим: PGSQL_ERRORS_TERSE
, PGSQL_ERRORS_DEFAULT
или PGSQL_ERRORS_VERBOSE
.
Предыдущий режим действовавший до запуска функции: PGSQL_ERRORS_TERSE
, PGSQL_ERRORS_DEFAULT
или PGSQL_ERRORS_VERBOSE
.
Версия | Описание |
---|---|
8.1.0 | Параметр connection теперь ожидает экземпляр класса PgSql\Connection; раньше параметр ждал ресурс (resource). |
Пример #1 Пример использования pg_set_error_verbosity()
<?php
$dbconn = pg_connect("dbname=publisher") or die("Could not connect");
if (!pg_connection_busy($dbconn)) {
pg_send_query($dbconn, "select * from doesnotexist;");
}
pg_set_error_verbosity($dbconn, PGSQL_ERRORS_VERBOSE);
$res1 = pg_get_result($dbconn);
echo pg_result_error($res1);
?>