Function:cs_error_sql
cs_error_sql ($file, $part, $message, $stop)
Funktion/Verwendung
Diese Funktion generiert bei einem eventuell auftretenden Datenbank-Fehler die entsprechende Fehlermeldung für den Template-Platzhalter {func:errors} und die sehr viel ausführlichere Meldung mit weiteren Informationen für die Logdateien. Um Fehler zurückverfolgen und damit auch beheben zu können, ist es sehr wichtig, dass die Funktion an fehlerrelevanten Stellen zum Einsatz kommt. Mit dieser Funktion kann bei einem schwerwiegenden Fehler auch die Ausführung des Scripts abgebrochen werden.Parameter
Für die ordnungsgemäße Ausführung der Funktion ist mindestens die Übergabe der folgenden Parameter erforderlich:- $file
- $part
- $message
$file
Für die Variable $file wird entweder die PHP Konstante __FILE__ oder der genaue Pfad der Datei übergeben, in der der Fehler aufgetreten ist.$part
Mit der Variable $part wird die betroffene Stelle oder Funktion übergeben, in der der Fehler aufgetreten ist.$message
In der Variable $message wird die Fehlermeldung übergeben. Diese erscheint dann in dieser Form im Template und auch in den Logdateien.$stop
Ist die Variable $stop nicht null (Standardwert 0), wird die weitere Ausführung des Scripts abgebrochen.Beispiel
cs_error_sql(__FILE__, 'cs_sql_connect', $error, 1);Das Beispiel ist aus der Datei mysql.php im Ordner system/database von ClanSphere. Tritt beim Verbinden zur Datenbank ein Fehler auf, wird ein Eintrag in den Logdateien geschrieben und die Ausführung des Scripts abgebrochen.