Contao 5.3 richtig kopieren und dann umziehen auf neuen Hostingserver

Wie man Contao 5.3 mit dem Contao Manager umziehen kann – hier eine Step by Step Anleitung.

Erste Schritte - Alle Backups anfertigen:

1.) Ein Datenbank Backup machen. Einfach den MySQL-Dump erstellen und in diesen dann in eine neue, leere Datenbank importieren (meist mit PHPMyAdmin einfach ausführbar).

2.) Via FTP ein Backup der Datei composer.json und composer.lock machen. Ebenso muss man die Datei localconfig.php im Ordner /system/config/ sichern (ggf. auch andere Dateien die man hier hinterlegt hat).

Weitere Backups macht man vom Ordner /files und /templates.

Von manuell installierten Modulen sollte man auch ein Backup machen (/system/modules/), hat man den Manager für die Modulinstallation genutzt ist dies nicht notwendig.

Nächste Schritte:

3.) Einen neuen, leeren FTP Zugang im Ziel-Hosting anlegen und dort Contao 5.3 einfach wie üblich im Ordner /web mittels der Datei contao-manager.phar.php installieren. Wichtig ist, nicht am Ende der Contao Installtion die Datenbank eintragen. Diese Schritt einfach überspringen / abbrechen (Contao Manger neu laden, z.B. durch drücken von F5). Startet man den Contao-Manager bleibt er bei der Datenbank Einrichtung stehen. Hier dann einfach den abgesicherten Modus starten.

4.) Es ist wichtig, dass nun alle Zusatzmodule installiert werden. Dafür gibt es 2 Wege:
a.) Alle Module, so wie dise in der Quellinstalltion vorhanden waren, im Contao-Mananger nach und nach installieren. (auch jetzt nicht "Datenbank einrichten")
oder
b.) composer.json und composer.lock in den Root Ordner der neue installierten Homepage ablagen. Oft werden diese Module aber nicht sofort im Contao-Manager angezeigt. Meist genügt es F5 zu drücken und den Browsercache zu leeren. Klappt dies nicht, sollte alle Caches in der Systemwartung geleert werden.
Nun die Installation der angezeigten Zusatzmodule vornehmen und abschließen (auch jetzt nicht "Datenbank einrichten"). Prüfe nun ob alle Zusazmodule korrekt installiert wurden und keines fehlt.

5.) Die zuvor gesicherten Dateien aus Schritt 2 werden nun an die passenden Stellen in die korrekten Ordner zurück kopiert (Ordnerstruktur muss erhalten bleiben). Hier ist es enorm wichtig die Daten an die korrekten Stellen zurück zu kopieren, also nicht in den /web Ordner sondern eine Ebene darüber. Die meisten Ordner sind schon angelegt. Gibt es einen Ordner nicht einfach anlagen um die Daten dort abzulegen. Das sind meist der Ordner /templates und /files.

6.) Nun den Contao-Manager neu aufrufen (Systemprüfung) ausführen. Nun sollte man die Datenbank Einrichtung vornehmen und die Zugangsdaten der neuen Datenbank eintragen. (Der Dump aus dem Backup sollte in dieser neuen Datenbank bereits eingespielt worden sein). Sind alle Zusatzmoduel vollsätndig, wird dies ohne größere Meldungen ablaufen. Spätenstens hier kanna ber auffallen, das evtl. noch Mdouel fehlen. Dann nichts löschen lassen, sondern diese Moduel nachinstallieren und erneut die Datenbank prüfung starten.

7.) Zum Abschluss meldet man sich im Contao-Backend (Wichtig im Backend, nicht im Contao-Manager an (dies sollte nun klappen) und wählt in der der Systemwartung die Option 'Symlinks neu erstellen'. Außerdem an dieser Stelle noch den 'Bilderchache leeren' und den 'Skriptcache leeren' damit Bilder und CSS Dateien und Scripte korrekt geladen werden.

Nun sollte die Webseite funktionieren. Klappt etwas nicht sollte man die Schritte alle nochmal durchgehen. Gerade beim ersten mal kann es etwas kniffelig sein.