Fehlercodes und Meldungen der Datenbank #

Diese Seite richtet sich an Datenbankadministratoren und Entwickler, die die Datenbankfehler von Exponential lesen oder Code schreiben, der darauf reagieren muss. Sie beantwortet: welche Nummer eine gescheiterte Anweisung auf jeder Engine meldet, wie Fehler den Code erreichen und was die eigenen Meldungen der Treiber bedeuten. Quelle: Eine Website betreiben, kennen Sie Ihren Datenbanktreiber und die Treiber in lib/ezdb/classes/.

Inhalt #

1. Die eigene Nummer der Engine
2. Zwei Arten der Fehlerbehandlung
3. Exception-Klassen
4. Meldungen und wo sie erscheinen
5. Eine Fehlerreferenz lesen

Die eigene Nummer der Engine #

Die Fehlernummer einer gescheiterten Anweisung ist die eigene der Datenbank, in $db->errorNumber() und, bei Exception-Behandlung, als getCode() der geworfenen eZDBException:

Hinweis zum Upgrade: errorNumber() von PostgreSQL war früher für jeden Fehler 1 und ist jetzt der SQLSTATE.

Zwei Arten der Fehlerbehandlung #

$db = eZDB::instance();
$db->setErrorHandling( eZDB::ERROR_HANDLING_EXCEPTIONS );
try
{
    $db->query( "INSERT INTO my_table ( id ) VALUES ( 1 )" );
}
catch ( eZDBException $e )
{
    if ( $e->getCode() === 1062 || $e->getCode() === '23505' )   // MySQL, PostgreSQL
        { /* the row is there already */ }
}
$db->setErrorHandling( eZDB::ERROR_HANDLING_STANDARD );

• Standard (der Standard): Eine gescheiterte Anweisung wird protokolliert, und der Aufruf gibt false zurück; innerhalb einer Transaktion meldet der Kernel das Scheitern.
• Exceptions: eZDBException mit dem Code der Engine. Damit wirft MySQL unter PHP 8.1 und neuer eZDBException statt PHPs mysqli_sql_exception.
• Der SQLite-Treiber wirft innerhalb einer Transaktion; außerhalb antwortet er mit false und gesetztem errorNumber().

Vergleichen Sie Codes je Engine, nie den Text der Meldung, der sich nach Engine, Version und Sprache unterscheidet.

Exception-Klassen #

Meldungen und wo sie erscheinen #

Eine Fehlerreferenz lesen #

Eine Fehlerseite zeigt eine kurze Referenz. exp:logs findet den Fehler anhand dieser Referenz und zeigt die Zeilen seiner Anfrage, mit standardmäßig maskierten personenbezogenen Daten (Einen Fehler anhand seiner Referenz finden).

Verwandte Seiten #

• Datenbankfehler beheben
• SQL von Erweiterungen für jede Engine prüfen
• Wenn etwas schiefgeht
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.