Wie man den Safe Mode Hack konfiguriert

Eventuell haben Sie beim Aufruf des Contao-Installtools die Mitteilung erhalten, dass die lokale Konfigurationsdatei nicht beschreibbar ist.

Dateizugriffsrechte ¶

Die Bezeichnung "Safe Mode Hack" ist eigentlich nicht korrekt, da sie impliziert, dass das Problem durch den PHP safe_mode verursacht würde. Tatsächlich wird es jedoch von unzureichenden Dateizugriffsrechten verursacht und tritt auch bei deaktiviertem safe_mode auf, daher sollte es richtiger "File Permission Hack" heißen. PHP als Apache-Modul läuft normalerweise als Benutzer wwwrun, www-data oder nobody, wohingegen die Dateien, die Sie per FTP hochgeladen haben, Ihrem Benutzer (z.B. web4 oder ab5678) gehören. Der Server verweigert Benutzern grundsätzlich den Zugriff auf fremde Dateien und macht auch für das PHP-Skript Contao keine Ausnahme.

FTP für Dateioperationen verwenden

Um das Rechteproblem zu umgehen, baut Contao eine FTP-Verbindung auf und legt die Ressourcen unter dem FTP-Benutzer an. Sie müssen dafür nur Ihre FTP-Zugangsdaten in der lokalen Konfigurationsdatei (system/config/localconfig.php) eintragen.

$GLOBALS['TL_CONFIG']['useFTP']  = true;
$GLOBALS['TL_CONFIG']['ftpHost'] = 'domain.com';
$GLOBALS['TL_CONFIG']['ftpPath'] = 'httpdocs/';
$GLOBALS['TL_CONFIG']['ftpUser'] = 'ab5678';
$GLOBALS['TL_CONFIG']['ftpPass'] = '********';

Ersetzen Sie die obigen Login-Daten mit Ihren eigenen und achten Sie besonders darauf, den korrekten ftpPath einzugeben. Es handelt sich dabei um den relativen Pfad vom FTP-Basisordner zum Contao-Verzeichnis (z.B. html/, public_html/ oder httpdocs/).

Schreibrechte zuweisen

Die Third-Party-Plugins, die in Contao verwendet werden, kennen den Safe Mode Hack natürlich nicht und benötigen daher Schreibrechte für bestimmte Verzeichnisse. Verwenden Sie Ihr FTP-Programm oder SSH-Terminal, um die nachfolgend genannten Ordner beschreibbar zu machen (CHMOD 777). Unabhängig davon, was Sie eventuell in einem Tutorial oder im Contao-Forum gelesen haben, müssen und sollten nur diese drei Verzeichnisse angepasst werden, um den Safe Mode Hack zu nutzen!

• system/html
• system/logs
• system/tmp

Ab Version 2.7.3 werden die benötigten Schreibrechte automatisch gesetzt.

Die FTP-Verbindung prüfen

Um zu prüfen, ob der richtige ftpPath gesetzt ist, klicken Sie auf die Check FTP connection-Schaltfläche.