Safe Mode Hack anlegen

[Nina]

Bevor du TYPOlight installierst, solltest du deinen Webspace mit dem Systemdiagnosetool prüfen. Möglicherweise erscheint dabei die Meldung You will most likely not be able to run TYPOlight without Safe Mode Hack. In diesem Fall solltest du den sogenannten Safe Mode Hack (SMH) einrichten.

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 TYPOlight-Partner für Webhosting bieten natürlich nur Webspace an der optimal auf TYPOlight 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 TYPOlight 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/.

Lade dir nun aus der Erweiterungsliste den SMHCheck runter und entzippe die Datei. Im daraus entpackten Ordner findest du die Datei smhcheck.php. Lade diese Datei in das Root-Verzeichnis deines Webspaces. Nun kannst du im Browser die Adresse www.domain.de/smhcheck.php (www.domain.de natürlich mit dem Namen deiner genutzten Domain austauschen) aufrufen. Wenn ganz unten dann der Hinweis "Safe Mode Hack is enabled and appears to be working steht, hast du den Safe Mode Hack fertig eingebaut.

Wenn du hingegen die Meldung Creation of temporary file failed siehst, musst du noch per FTP die Zugriffs-/Schreibrechte der nachfolgenden folgenden Ordner anpassen.

system/html CHMOD 0777
system/logs CHMOD 0777
system/tmp CHMOD 0777

Wichtig ist auch, dass die Ordner und Dateien den gleichen "Benutzer" haben wie es als FTP-Nutzer im SMH angegeben wurde und nicht z. B. den Benutzer „wwwrun“ oder "nobody"!

[acenes]

• Typolight hat "ab Werk" bereits ein Testprogramm für den SMH an Bord. Allerdings prüft dieses nicht so umfassend wie die smhcheck Erweiterung. Zu finden ist es unter http://www.deinedomain.de/typolight/ftp.php
• 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. das TYPOlight 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:

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

Alternativ kann der Pfad auch fix angegeben werden:

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.