Fehlersuche in Joomla

2015 © formativ.net oHG 1

Woran hängt’s denn?Fehlersuche in Joomla!

2015 © formativ.net oHG 2

Mögliche/übliche Fehler

• Server falsch konfiguriert

• Joomla! falsch konfiguriert

• Fehlerhaften Code geschrieben

2015 © formativ.net oHG 3

Beispiel 1: Login-Fehler

2015 © formativ.net oHG 4

Beispiel 1: Login-Fehler

• Häufige Ursachen:

• Log-Pfad in configuration.php falsch definiert ($log_path)

• Log-Pfad hat falsche Zugriffsrechte

2015 © formativ.net oHG 5

Beispiel 1: Login-Fehler

• Lösung:

• Log-Pfad in configuration.php korrekt definieren

• Richtige Zugriffsrechte auf Tmp-Pfad erteilen (755 / 775)

• Auf lokalem Rechner: Schreibrechte sicherstellen

• Auf Server: Per FTP-Client oder per SSH

2015 © formativ.net oHG 6

Beispiel 2: Update-Fehler

2015 © formativ.net oHG 7

Beispiel 2: Update-Fehler

• Häufige Ursachen:

• Tmp-Pfad in configuration.php falsch definiert ($tmp_path)

• Tmp-Pfad hat falsche Zugriffsrechte

2015 © formativ.net oHG 8

Beispiel 2: Update-Fehler

• Lösung:

• Tmp-Pfad in configuration.php korrekt definieren

• Richtige Zugriffsrechte für Tmp-Pfad erteilen (755 / 775)

• Auf lokalem Rechner: Schreibrechte sicherstellen

• Auf Server: Per FTP-Client oder per SSH

2015 © formativ.net oHG 9

Beispiel 3: Error 500

2015 © formativ.net oHG 10

Beispiel 3: Error 500

• Häufige Ursachen:

• .htaccess Syntaxfehler / falsch konfiguriert

• „Options +FollowSymlinks“

• „RewriteBase /“

• Eigener PHP-Code in Template fehlerhaft

• Template nicht gefunden

• PHP auf dem Server falsch konfiguriert

2015 © formativ.net oHG 11

Beispiel 3: Error 500

• Lösung:

• .htaccess-Syntax prüfen, ggf. zurück auf Original-Datei

• .htaccess richtig konfigurieren

• „Options"+FollowSymlinks“ auskommentieren

• „RewriteBase“ richtig setzen (/Pfad)

• Eigenen Code / Template prüfen & debuggen

• Ansonsten: Provider anrufen ;)

2015 © formativ.net oHG 12

Beispiel 4: Blank Page

2015 © formativ.net oHG 13

Beispiel 4: Blank Page

• Häufige Ursachen:

• Fehler beim Upload auf den Server (FTP)

• Datenbank-Dump auf Server nicht aktuell

• Auf Server fehlen Joomla!-Erweiterungen

2015 © formativ.net oHG 14

Beispiel 4: Blank Page

• Lösung:

• Daten pauschal erneut hochladen (wenn möglich per SSH!)

• DB-Dump erneut hochladen (Encoding prüfen!)

• Alle nötigen Erweiterungen nachinstallieren

2015 © formativ.net oHG 15

Fehleranalyse

• Logfile unter $log_path prüfen

2015 © formativ.net oHG 16

Fehleranalyse

• Server-Logfile prüfen (error.log)

• XAMPP: C:\xampp\apache\logs\error.log

• MAMP: /Applications/MAMP/logs/apache_error.log

• Webserver (Linux): /var/log/apache2/error.log

• Wichtig: Error-Reporting in Joomla!

2015 © formativ.net oHG 17

Fehleranalyse

• Über Web-Developer-Tools Status-Codes prüfen

2015 © formativ.net oHG 18

Fehleranalyse

• Ggf. Mod-Rewrite-Log aktivieren

• in .htaccess-Datei eintragen:

• RewriteLog /mein/logfile.txt

• RewriteLogLevel 0-9 (0 = kein Logging, 9 = alles loggen)

2015 © formativ.net oHG 19

Fehleranalyse

• PHP-Code debuggen in Templates

• Empfehlung: Xdebug (http://xdebug.org)

• Ablauf

• Xdebug lokal einrichten (XAMPP, IDE)

• Debugging starten

• Joomla! im Browser aufrufen und in IDE Ergebnisse verfolgen

• Breakpoints setzen, Zeile für Zeile verfolgen …

2015 © formativ.net oHG 20

Vielen Dank! ;)... and have a nice day.