Fehlerdiagnose
Benutzung der debug.php
Die debug.php stellt sich als nützliches Instrument dar, um eventuell vorhandene Fehler der Installation oder nach Eingriffen ins System, zu finden. Ursprünglich für die Entwickler gedacht, bietet Sie aber auch jedem Anwender die Möglichkeit Fehler zu erkennen und diese zu melden, falls eine Abstellung selbiger nicht möglich ist. Für den Einsatz gelten folgende Regeln.
- Prüfen ob die debug.php im ROOT Verzeichnis der Clansphere Installation vorhanden ist. (In "ROOT" Verzeichniss sind auch die Dateien "admin.php", "content.php" etc. zu finden).
- Falls dies nicht der Fall sein sollte die debug.php aus dem heruntergeladenen CSP Archiv in das o.g. Verzeichniss laden.
- Prüfen ob die debug.htm im verwendeten Template Ordner zu finden ist. Bei der Installation von Clansphere ist das Template "Apple" standardmässig eingestellt (/templates/apple). Dort ist bereits die debug.htm vorhanden.
- Falls ein eigenes Template verwendet wird, gibt es zwei Möglichkeiten. Zum einen kann man sich eine vorhandene debug.htm aus dem Ordner /templates/apple (Besipiel) in seinen Template Ordner kopieren.. Die bessere Alternative ist aber, da man dann gleichzeitig in seiner eigenen "Design" Umgebung testen kann, die index.htm, die man erstellt hat, zu kopieren und in debug.htm umzubennnen. Dieser Datei fügt man noch folgendes hinzu:
<div id="debug"> <span id="errors">{func:errors}</span> <span id="sql">{func:sql}</span> </div>Sinnigerweise sollte der Eintrag direkt unter dem body tag erfolgen, was im Endergebnis so aussieht:<body> <--- vorhandenen Eintrag in der debug.htm <div id="debug"> <span id="errors">{func:errors}</span> <span id="sql">{func:sql}</span> </div> - Über den Aufruf http://www.iherdomain.de/debug.php erfolgt dann die neue "Darstellung der Seite" mit einem Bereich oberhalb des Designs in dem eventuelle Fehlermeldungen, sowie Warnungen und Abfrage Operationen angezeigt werden. Die Grösse und Darstellung dieses Bereich wird über einen Eintrag in der clansphere.css (Standarmässig) defniert
#debug { <-- Definition der Grösse und Platzierung height:100px; margin-bottom:20px; overflow:auto; padding-left:4px; width:100%; text-align:left; } #errors { <-- Farbe der Fehlermeldungen (in diesem Fall rot) color:#CC0000; } #sql { <-- Frabe der Abfrage Operationen (in diesem Fall grau) color:#777777; }
Zur Deutung der Meldungen:
ERRORS: Grundlegende Fehler, die das Ausführen von Befehlen verhindern, bzw. auch auf fehlende Dateien oder Grafiken hinweisen.
WARNINGS: Diese Meldungen sind zu vernachlässingen, da Sie als Hinweise für zukunüftige Releases zu sehen sind. Z.B. das ein Befehl oder eine Funktion bald nicht mehr vorhanden sein wird.
SQL-BEFEHLE: Hier wird der Datenbank Zugriff, also die Lese- und Schreibefunktionen zur Zeit der Verarbeitung angezeigt.
Falls es Ihnen nicht möglich sein sollte die Meldungen selber zu deuten, bzw. Abhilfe zu schaffen, hilft die Nennung dieser, um eine schnellere Hilfestellung und Problemlösung zu gewährleisten.
