Определяет объем текста сообщений, возвращаемых функциями pg_last_error и pg_result_error

# pg_set_error_verbosity

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

pg_set_error_verbosity — Определяет объем текста сообщений, возвращаемых функциями pg_last_error() и pg_result_error()

### Описание

function pg_set_error_verbosity(PgSql\Connection `$connection` = ?, int `$verbosity`): int|false

Определяет объем текста сообщений, возвращаемых функциями 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`, или `false` в случае ошибки.

### Список изменений

Версия | Описание
--- | ---
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);
    ?>

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

- pg_last_error() - Получает сообщение о последней произошедшей ошибке на соединении с базой данных
- pg_result_error() - Возвращает сообщение об ошибке, связанное с запросом результата

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open