Logs und Fehler lesen
Fehler gehören zum Lernen. Je früher Sie sie lesen können, desto schneller lernen Sie. Diese Seite zeigt, wo Exponential festhält, was schiefgegangen ist, und wie Lernende das nutzen.
Inhalt
- Ist es überhaupt ein Fehler?
- Die Fehlerseite und ihre Referenz
- Die Logdateien
- Die Log-Anzeige in der Administrationsoberfläche
- Prüfen, bevor Sie nachsehen
- Ein Ablauf für jeden Fehler
- Vom Fehler zur Frage
Ist es überhaupt ein Fehler?
Manche Seiten sehen aus wie Fehler, sagen aber, dass etwas nicht erlaubt oder nicht vorhanden ist (Wenn etwas schiefgeht):
| Die Seite sagt | Das bedeutet |
|---|---|
| Die angeforderte Seite konnte nicht angezeigt werden. (1) oder Ihr Benutzerkonto hat nicht die notwendigen Privilegien um Zugriff auf die angeforderte Seite zu erhalten. | Ihre Rolle darf diese Seite nicht öffnen |
| Die angeforderte Seite konnte nicht angezeigt werden. (20) | Die Adresse ist falsch, oder dieser Teil ist nicht installiert |
| Möglicher Bearbeitungs-Konflikt | Es gibt bereits einen Entwurf des Elements |
| Eine ausgegraute Schaltfläche | Sie dürfen sie hier oder jetzt nicht verwenden |
Auf Ihrer eigenen Lernwebsite als admin sollte die erste nicht erscheinen; für ein Testkonto ist sie oft das
erwartete Ergebnis einer Übung zu Rollen (Projekt 9).
Die Fehlerseite und ihre Referenz
Ein echter Fehler zeigt eine Seite wie Bei uns ist etwas schiefgegangen mit einer Referenz unten. Der Fehler ist bereits protokolliert; mit der Referenz finden Sie diesen Zeitpunkt in den Logs (Wenn etwas schiefgeht, Einen Fehler anhand seiner Referenz finden).
Notieren Sie die Referenz, die Uhrzeit, die Adresse und was Sie unmittelbar davor getan haben.
Die Logdateien
Die Logs liegen in var/log/ der Installation. Diejenigen, denen Lernende am häufigsten begegnen:
| Datei | Was sie enthält | Quelle |
|---|---|---|
var/log/error.log | Fehler; der erste Ort, an dem Sie nach einer weißen Seite oder einem Fehler 500 nachsehen | Erste Schritte |
var/log/warning.log | Warnungen, zum Beispiel zu Caches | Caches |
var/log/setup.log | Der Fortschritt einer Installation | Erste Schritte |
var/log/security.log | Sicherheitsereignisse, zum Beispiel Zeilen zum Demomodus | Demomodus-FAQ |
Auf der Kommandozeile die letzten Zeilen eines Logs:
tail -n 50 var/log/error.logDie Log-Anzeige in der Administrationsoberfläche
Setup > Logdateien zeigt die Logs im Browser: Wählen Sie eine Datei, verfolgen Sie neue Zeilen, während sie
geschrieben werden, filtern Sie nach Stufe, suchen Sie nach einem Wort wie einer Fehlerreferenz und öffnen Sie die
Fehlerübersicht für einen Überblick. Sie braucht die Richtlinie setup/logs; personenbezogene Daten wie
IP-Adressen werden standardmäßig maskiert (Wie lese ich die Logdateien?).
Prüfen, bevor Sie nachsehen
Viele Fehler lassen sich abfangen, bevor Sie den Browser öffnen:
| Sie haben geändert | Prüfung | Erwartet | Quelle |
|---|---|---|---|
| Eine PHP-Datei | php -l <file> | No syntax errors detected in <file> | Erweiterungen |
| Ein Template | php bin/php/eztemplatecheck.php -s<siteaccess> <file> --allow-root-user | Template file valid: <file> | Templates und Design |
| Klassen einer Erweiterung | php bin/php/checkclasses.php --quiet-ok --allow-root-user | Keine Ausgabe, wenn alles geladen wird | Erweiterungen |
| Eine Einstellung | php bin/php/console exp:ini where <file/Block/Variable> <siteaccess> | Der wirksame Wert | Siteaccesses und Einstellungen verstehen |
Template-Pfadkommentare zeigen, welches Template welches Markup geschrieben hat (Templates und Design).
Ein Ablauf für jeden Fehler
- Lesen Sie die Meldung. Kopieren Sie sie genau in Ihr Lerntagebuch.
- Lesen Sie das Log.
var/log/error.log, die neuesten Zeilen. - Machen Sie die letzte Änderung gedanklich rückgängig: Was haben Sie unmittelbar davor geändert? Die meisten Fehler kommen vom letzten Schritt.
- Führen Sie die Prüfungen oben für die Dateien aus, die Sie angefasst haben.
- Schließen Sie Caches aus (Caches verstehen).
- Durchsuchen Sie die Hilfe nach der Meldung, dann die Issue-Tracker.
- Fragen Sie, mit den Fakten, die Sie gesammelt haben.
Vom Fehler zur Frage
Eine gute Frage oder ein guter Fehlerbericht enthält: was Sie getan haben, Schritt für Schritt; was Sie erwartet
haben; was passiert ist, mit der genauen Meldung; und die Umgebung (Versionen von Exponential und PHP, der Webserver,
die Datenbank). Die Seite Fehler melden der Hilfe und php bin/php/console exp:info --plain --no-logo liefern Ihnen
eine Zusammenfassung der Installation, die Passwörter, Schlüssel und Serverpfade weglässt
(Wenn etwas schiefgeht).
Siehe Um Hilfe bitten und Lerngruppen und Fehler, die Sie beim Lernen finden.
Verwandte Seiten
- Wenn etwas schiefgeht
- Caches verstehen
- Fehlerbehebung
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.