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
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
connectionnicht angegeben wurde, wird die Standardverbindung benutzt. Das ist die zuletzt mit pg_connect() oder pg_pconnect() aufgebaute Verbindung.WarnungSeit PHP 8.1.0 ist die Verwendung der Standardverbindung veraltet.
-
verbosity -
Der gewünschte Detaillierungsgrad:
PGSQL_ERRORS_TERSE,PGSQL_ERRORS_DEFAULToderPGSQL_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
