Function:cs_error
cs_error ($file, $message, $log_only)
Funktion/Verwendung
Diese Funktion generiert bei einem eventuell auftretenden 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.Parameter
Für die ordnungsgemäße Ausführung der Funktion ist mindestens die Übergabe der folgenden Parameter erforderlich:- $file
- $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.$message
In der Variable $message wird die Fehlermeldung übergeben. Diese erscheint dann in dieser Form im Template und auch in den Logdateien.$log_only
Ist die Variable $log_only nicht null (Standardwert 0), so wird der Fehler zwar in die Logdateien geschrieben, nicht jedoch im Template angezeigt.Beispiel
if (!file_exists($cs_main['show'])) { cs_error($cs_main['show'], 'cs_template - File not found'); }
Das Beispiel ist aus der Datei templates.php von ClanSphere. Existiert die Datei, welche mit $cs_main['show'] übergeben wird nicht, so erzeugt ClanSphere damit einen Fehlereintrag in die Logdateien.
