Installation von Contao in einer Subdomain bei 1&1 WebHosting

Das folgende Beispiel beschreibt Schritt für Schritt die Einrichtung von Contao (Version 2.9.1) auf einem Webspace von 1&1 WebHosting.

Um Contao im Rahmen eines Hosting-Pakets von 1&1 WebHosting betreiben zu können, muss ein Paket bestellt werden, das zumindest eine MySQL 5-Datenbank enthält. Zur Zeit ist Homepage Perfect das kleinste und günstigste Paket, welches diese Mindestanforderung erfüllt (Stand Oktober 2010).

Aus Sicherheits- bzw. Datenschutzgründen wurden die angegebenen Zugangsdaten und Domainnamen nur für dieses Beispiel verwendet.

Vorbereitung

Datenbank anlegen

Im 1&1 ControlCenter legt man als erstes eine neue Datenbank an. In einigen der angebotenen Hosting-Pakete könnte es eventuell noch eine Auswahl zwischen verschiedenen MySQL-Versionen geben. Es ist unbedingt darauf zu achten, dass es sich bei der neu installierten Datenbank um eine MySQL 5-Datenbank handelt.

Das für die Datenbank angelegte MySQL-Passwort sollte man sich gut merken bzw. notieren. Nachdem das Passwort angelegt wurde, wird es nicht mehr offen angezeigt. Ändern lässt es sich nur, wenn man in der Datenbank eingeloggt ist.

Die Einrichtung der MySQL 5-Datenbank erfolgt über ein Eingabeformular:

Es kann im Zuge der Datenbankinstallation ein Weile dauern, bis der Status Fertig angezeigt wird. Anschließend sollte das Resultat etwa so aussehen:

Eine Übersicht über die Zugangsdaten (Datenbankname, Hostname, Benutzername) findet man unter dem Menüpunkt Bearbeiten:

Damit ist die Datenbank vorbereitet.

FTP-Zugang kontrollieren

Einen FTP-Zugang braucht man normalerweise nicht selbst anzulegen, da er von 1&1 WebHosting vorinstalliert wurde. Das Passwort hat man nach der Einrichtung des Webspace vom Provider per Mail zugesandt bekommen.

Der Zugang setzt direkt im Basisverzeichnis des Webspace auf (deshalb wird als Verzeichnis /. angezeigt). Hat man das Passwort vergessen, kann unter Bearbeiten ein neues vergeben werden.

Subdomain anlegen und konfigurieren

Über dieses Icon gelangt man im 1&1 ControlCenter in die Domainübersicht. Dort ist die bestellte Domain eingetragen. Bei einem bereits bestehenden Webspace kann es sein, dass auf der Domain eine alte Website läuft, die erst nach Fertigstellung der neuen Contao-Installation durch diese ersetzt werden soll.

Deshalb baut die neue Contao-Website zunächst unter einer Subdomain auf:

Um die bestehende Website zu ersetzen, genügt es, die Domainziele zu ändern, um die Subdomain zur Hauptdomain zu machen. Weitere Änderungen sind nicht erforderlich.

Unter Neu kann eine neue Subdomain eingerichtet werden. Für diese Beispiel-Anleitung erhält sie den Namen contao.meinedomain.de:

Mit einem Haken in der Übersicht vor der neuen Subdomain und dem Button Verwendungsart kann die Subdomain konfiguriert werden. Da Contao in einem Unterverzeichnis installiert werden soll, um eine klare Trennung zu anderen Anwendungen zu haben, wird ein Verzeichnis cms1 angelegt.

Nach dem OK gelangt man wieder in die Domainübersicht, wo jetzt die Subdomain auf das Verzeichnis /cms1 verweist.

Installation

FTP-Programm einrichten

Um Contao auf die richtige Stelle im Webspace zu kopieren, müssen die FTP-Zugangsdaten in das verwendete FTP-Programm eintragen werden. Bei Eingabe der richtigen Daten wird das Programm direkt das Verzeichnis /cms1 öffnen. Jedes FTP-Programm ist etwas anders aufgebaut, deshalb zeigt der Screenshot nur die Eingabemaske eines bestimmten Programms. In allen Programmen müssen aber die gleichen Zugangsdaten für den Webspace eingetragen werden.

Achtung: Bei einigen FTP-Programmen ist standardmäßig die Übertragung von versteckten Dateien (z.B. .htaccess) abgeschaltet. Für eine vollständige Installation von Contao ist es sehr wichtig, diese Dateien mit zu übertragen. Sie gewährleisten die Sicherheit der neuen Contao-Website gegen ungewolltes Auslesen von Daten. Häufig ist es möglich, Parameter für den LIST-Befehl anzugeben, dann bitte -la angeben. Hier sollte die Dokumentation des verwendeten FTP-Programms weiter helfen.

	Protokoll:	Es soll eine FTP-Verbindung aufgebaut werden.
	Server:	Hier wird einfach die Hauptdomain eingetragen, welche automatisch auf die richtige IP aufgelöst wird.
	Port:	Hier trägt man den Standard-Port einer FTP-Verbindung, den Port 21, ein.
	Benutzername:	Den Benutzernamen hat man beim FTP-Zugang im 1&1 ControlCenter abgelesen.
	Passwort:	Das FTP-Passwort wurde vom Provider mitgeteilt, oder man hat beim FTP-Zugang ein neues Passwort erstellt.
	Anfangsverzeichnis:	Hier muss das Basisverzeichnis für die Installation angegeben werden, welches bei der Subdomain-Einrichtung erstellt wurde.

Wenn das FTP-Programm mit diesen Parametern gestartet wird, sollte es auf dem Server ein leeres Verzeichnis aufrufen.

Upload Contao

Nachdem Contao von der offiziellen Contao-Homepage herunter geladen wurde, entpackt man das ZIP-Archiv auf dem lokalen Rechner. In dem ZIP-Paket ist ein Basisverzeichnis mit der Contao-Versionskennung enthalten. Der Inhalt ist (ohne das Basisverzeichnis selbst!) auf den Webserver zu laden.

Als Besonderheit von 1&1 WebHosting erstellt man nun im Basisverzeichnis des Webspace eine .htaccess-Datei mit folgendem Inhalt:

AddType x-mapp-php5 .php
AddHandler x-mapp-php5 .php

Hinweis: Die beiden Zeilen Addtype und AddHandler werden ab php5.4 nicht mehr benötigt. Damit wird die php Version 5.2.xx unabhängig von den Control-Center Einstellungen vorgenommen. Ab April 2013 überschreibt das Control Center die .htaccess und fügt AddHandler x-mapp-php6 .php3 .php4 .php .phtml ein. Zusätzlich wird die Datei schreibgeschützt

Des Weiteren bereitet man die .htaccess.default für eine spätere Verwendung vor, indem man (speziell für 1&1 WebHosting) auch hier dieselben zwei Zeilen einträgt:

AddType x-mapp-php5 .php
AddHandler x-mapp-php5 .php
##
# Contao Open Source CMS
# Copyright (C) 2005-2010 Leo Feyer
#
# Formerly known as TYPOlight Open Source CMS.
#

Anmerkung: Ich persönlich verwende für die Installation die einfache Variante der .htaccess und wechsle erst später, wenn alles läuft, auf die im Contao-Paket enthaltene Datei, die für die URL-Umschreibung zuständig ist. Dazu muss man dann .htaccess.default in .htaccess umbenennen.

Hinweis: Unter Umständen funktioniert die URL-Umschreibung nur, wenn die RewriteBase auf jeden Fall gesetzt ist. RewriteBase / Die optimierte Umschreibung mit mod_cache funktioniert unter Umständen auch. Bitte ausprobieren. RewriteRule (.*\.html)$ index.php/$1 [L]

Aufruf des Installtools

Inzwischen sollte auch die Subdomain contao.meinedomain.de verfügbar sein, so dass man mit der Installation von Contao beginnen kann.

Da die Installation aus der Sicht der Subdomain in der Root liegt (/cms1 ist die Root der Subdomain!), braucht man kein Unterverzeichnis beim Aufruf anzugeben oder die Rewrite-Base in der .htaccess zu verändern.

Den Contao-Installer ruft man mit http://contao.meinedomain.de/contao/install.php auf (bei älteren Paketen natürlich mit dem Pfad typolight statt contao). Der Ablauf der Installation ist auf der Seite Installation beschrieben, hier zeige ich nur die speziellen Einstellungen, die bei 1&1 WebHosting anzuwenden sind:

Hier werden alle Daten eingetragen, die man zuvor im ControlCenter bei der Anlage der Datenbank notiert hat.

Das sollte es dann gewesen sein

-- do_while - 2010-06-28