Fehlersuche

Fehler bei der Anwendung, aber auch Programmierfehler, passieren und werden wohl auch immer wieder mal vorkommen. CMSimple_XH bietet für solche Fälle Unterstützung an.

Der Debug-Modus

Dieser Modus kann in vielen Fällen helfen, Probleme zu lösen oder zumindest Fehler-Ursachen aufzuspüren. Treten irgendwelche Schwierigkeiten auf, sollte man als erstes CMSimple_XH in diesen Modus versetzen.

Aktivieren

Im Ordner userfiles/download befindet sich eine Datei XHdebug.txt.

Wird diese Datei durch Anfügen eines Unterstrichs vorn am Dateinamen umbenannt, wird damit der Debug-Modus aktiviert.

Also so: _XHdebug.txt

Sobald diese Datei (mit Unterstrich) existiert, wird im Admin-Modus der aktive Debug-Modus sichtbar gemacht (mit einer hervorgehobenen Textmeldung oder mit einem Käfer-Icon) und mögliche Fehlermeldungen bzw. Warnungen werden angezeigt.

Die Fehlermeldungen erscheinen normalerweise nur im Admin-Modus. Die Ausnahme: „fatale“ PHP-Fehler (das sind solche, die einen Blank-Screen verursachen), werden immer – also auch im Frontend – angezeigt.

Die Umbenennung der XHdebug.txt kann entweder per FTP, per Filebrowser oder mithilfe eines Plugins (siehe z.B. Switchdebug_XH) erfolgen.

Datei-Inhalt

Der Inhalt dieser Datei muss/darf nur eine einzige Ziffer von 0 bis 6 (die Debug-Stufe) sein. Die Bedeutung dieser Ziffer ist der folgenden Liste zu entnehmen:

0 = Keine Fehler-Anzeige
1 = Anzeige von Laufzeitfehlern außer Warnungen
2 = Anzeige von Laufzeitfehlern
3 = Anzeige von Laufzeitfehlern und Hinweisen
4 = Anzeige aller Fehler außer Hinweisen und Warnungen
5 = Anzeige aller Fehler außer Hinweisen
6 = Anzeige aller Fehler (Standard)

Ist die Datei leer, dann wird Debug-Stufe 1 aktiviert.

Fehlermeldungen

Anhand der Fehlermeldungen bzw. Warnungen, kann man nun versuchen, die gemeldeten Probleme zu lösen.

Sollte das eigene Wissen oder die eigene Recherche nicht zum Erfolg führen, kann man sich an das CMSimple_XH Forum wenden. Dort sollte man das Problem möglichst nachvollziehbar schildern. Die Fehlermeldungen sollten kopiert und als Zitat dort gezeigt werden. In den meisten Fällen wird in diesem Forum schnelle und qualifizierte Hilfe geleistet.

Deaktivieren

Da es immer „böse“ Menschen auf dieser Welt gibt, die anhand der Informationen aus den Fehlermeldungen vielleicht Angriffe starten könnten, sollte der Debug-Modus wirklich nur zur Fehlersuche eingeschaltet werden.

Hat man sich längere Zeit nicht mit seiner Website beschäftigt (mindestens nach einem halben Jahr), empfiehlt sich ebenfalls eine kurze Überprüfung des CMS-Zustandes. Bei dieser Gelegenheit kann man auch gleich nach möglichen Updates Ausschau halten.

Ist alles in Ordnung, sollte man den Debug-Modus wieder deaktivieren – in umgekehrter Reihenfolge, wie unter Aktivieren beschrieben.