Bestimmt den Detaillierungsgrad von Fehlermeldungen, die von pg_last_error und pg_result_error zurückgegeben werden

# pg_set_error_verbosity

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

pg_set_error_verbosity — Bestimmt den Detaillierungsgrad von Fehlermeldungen, die von pg_last_error() und pg_result_error() zurückgegeben werden

### Beschreibung

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

Bestimmt den Detaillierungsgrad von Fehlermeldungen, die von pg_last_error() und pg_result_error() zurückgegeben werden.

pg_set_error_verbosity() setzt einen neuen Modus für Fehlermeldungen und gibt die zuvor gesetzte Einstellung zurück. Im Modus `PGSQL_ERRORS_TERSE` enthalten die Meldungen nur Angaben über den Detaillierungsgrad, einen Kurztext, sowie die Position des Fehlers. Dies passt normalerweise in eine Zeile. Im Standard-Modus, `PGSQL_ERRORS_DEFAULT`, wird das obige samt aller Einzelheiten, Hinweise oder Kontextfelder des Fehlers ausgegeben (was mehrere Zeilen in Anspruch nehmen kann). Der Modus `PGSQL_ERRORS_VERBOSE` schließt alle verfügbaren Felder ein. Eine Änderung des Detaillierungsgrads hat keine Auswirkung auf Meldungen bereits existierender Ergebnisse, sondern nur auf die, die danach erzeugt wurden.

### Parameter-Liste

`connection`

  Eine PgSql\Connection-Instanz. Falls `connection` nicht angegeben wurde, wird die Standardverbindung benutzt. Das ist die zuletzt mit pg_connect() oder pg_pconnect() aufgebaute Verbindung.

  Warnung

  Seit PHP 8.1.0 ist die Verwendung der Standardverbindung veraltet.

`verbosity`

  Der gewünschte Detaillierungsgrad: `PGSQL_ERRORS_TERSE`, `PGSQL_ERRORS_DEFAULT` oder `PGSQL_ERRORS_VERBOSE`.

### Rückgabewerte

Der vorher eingestellte Detaillierungsgrad: `PGSQL_ERRORS_TERSE`, `PGSQL_ERRORS_DEFAULT` oder `PGSQL_ERRORS_VERBOSE`.

### Changelog

Version | Beschreibung
--- | ---
8.1.0 | Der Parameter `connection` erwartet nun eine PgSql\Connection-Instanz; vorher wurde eine Ressource erwartet.

### Beispiele

Beispiel #1 pg_set_error_verbosity() Beispiel

`<?php
$dbconn = pg_connect("dbname=publisher") or die("Konnte nicht verbinden");
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);
?>`

### Siehe auch

- pg_last_error() - Liefert die letzte Fehlermeldung einer Verbindung
- pg_result_error() - Liefert die mit der Ergebniskennung verknüpfte Fehlermeldung

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