Safe Mode Hack anlegen

Bevor du Contao installierst, solltest du deinen Webspace mit dem Contao-Check prüfen. Lade den Contao-Check herunter, entpacke ihn auf deinem Computer und übertrage dann den darin enthaltenen "check"-Ordner in das Basisverzeichnis deiner Contao-Installation. Ruf den Contao-Check dann im Browser mit www.domain.tld/check/ auf (www.domain.tld mit deiner Webadresse ersetzen) und schau dir dir Ergebnisse an.
Möglicherweise erscheint dabei die Meldung, dass du den Safe Mode Hack benötigst.

Es gibt Ausnahmen von dieser Regel, da man bei manchen Webspaces Sondereinstellungen machen kann, damit der SMH doch nicht nötig ist. Schau mal in der Hosting-Liste nach, ob es zu dem von dir gewählten Webhoster eine Anleitung gibt. Darin ist meist vermerkt, ob du den SMH benötigst.

Wichtig: Die Contao-Partner für Webhosting bieten natürlich nur Webspace an der optimal auf Contao abgestimmt ist und keinen SMH benötigt.

1. Schritt: localconfig.php anpassen
Lade per FTP die Datei localconfig.php aus dem Ordner system/config/ herunter und füge die nachfolgenden Zeilen in die Datei ein. Achte unbedingt darauf, dass du die Datei mit einem Editor im UTF-8 Zeichensatz (z. B. PSPad) bearbeitest und speicherst!

$GLOBALS['TL_CONFIG']['useFTP'] = true;
$GLOBALS['TL_CONFIG']['ftpHost'] = 'HIER DEN FTP-HOSTNAMEN EINFÜGEN';
$GLOBALS['TL_CONFIG']['ftpPath'] = 'HIER DEN RELATIVEN FTP-PFAD EINFÜGEN';
$GLOBALS['TL_CONFIG']['ftpUser'] = 'HIER DEN FTP-BENUTZERNAME EINFÜGEN';
$GLOBALS['TL_CONFIG']['ftpPass'] = 'HIER DAS FTP-PASSWORT EINFÜGEN';

Der FTP-Pfad muss aus Sicht des FTP-Programms eingegeben werden.
Wenn du Contao also direkt im Root-Verzeichnis installiert hast und per FTP unmittelbar darauf verbunden wirst, gibst du einfach / ein.
Wenn du hingegen nach dem Verbinden per FTP noch z. B. in den Unterordner htdocs wechseln musst, gibst du in diesem Fall htdocs/ ein. Vergiss den abschließenden Schrägstrich nicht!

Speichere deine Änderung und lade die localconfig.php per FTP-Programm wieder in den Ordner system/config/.


Ein paar wenige Verzeichnisse benötigen trotz Safe Mode Hack Schreibrechte, weil PHP direkt auf sie zugreift:

Versionen bis 2.11.x:
system/html
system/logs
system/temp

Versionen ab 3.x:
assets/images
assets/images/*
system/logs
system/tmp


Im Normalfall setzt das Installtool automatisch die Schreibrechte auf CHMOD 777. Falls das nicht klappt, müssen sie manuell per FTP entsprechend gesetzt werden.

• SMH funktioniert nur mit normalem FTP, nicht jedoch mit SFTP. Wer nur SFTP verwenden kann, sollte sich auch einen Server aussuchen oder installieren der kein SMH braucht.
• Der richtige "Path" ist relativ zum Basisverzeichnis des FTP Users anzugeben, d.h. von dort aus wo man landet wenn man sich per FTP anmeldet. Sieht man dort z.B. dass Contao Root-Verzeichnis unter www/mysite, so muss als Path www/mysite/ angegeben werden.
• Der Schrägstrich am Ende der Path-Angabe ist zwingend, in seltenen Fällen muss der Schrägstrich auch am Anfang eingegeben werden, z.B. /www/mysite/.

Probleme mit System tmp

Manchmal verweigert der Hoster PHP den Zugriff auf das System-tmp (z.B. /tmp), unterlässt es jedoch die Umgebungsvariable TMPDIR (oder TEMP bei Windows) dafür auf ein Ersatz-Verzeichnis einzustellen. Einzelne PHP Funktionen der FTP Library verlassen sich jedoch darauf dass dort Lese- und Schreibberechtigung vorhanden sind und funktionieren somit nicht. Ein populäres Beispiel ist HostEurope.

In diesem Fall kann es helfen die Umgebungsvariable selber zu setzen indem folgender Befehl als zweite Zeile in system/Initialize.php eingesetzt wird:

PHP-Code:

---

putenv('TMPDIR='.ini_get('upload_tmp_dir')); 


---

Alternativ kann der Pfad auch fix angegeben werden:

PHP-Code:

---

putenv('TMPDIR=/pfad/zum/user/tmp'); 


---

Leider führt das aber nur dann zum Ziel wenn der Hoster nicht auch noch die Funktion putenv im PHP deaktiviert hat. In diesem Fall muss man den Hoster bitten die Umgebungsvariable TMPDIR (bei Linux) resp. TEMP (bei Windows) richtig einzustellen.