Contao: Von 2.11 nach 3.2, vom Catalog zu MetaModels

Natürlich ist alles auch ein wenig von den Voraussetzungen abhängig. Wie habe ich unterContao 2 gearbeitet? Setze ich problematische Erweiterungen ein? Habe ich den Ordner /templates ohne Not mit unzähligen geänderten Templates bestückt? Diese Fragen sollte man vorher klären - vielleicht ist das ja auch ein Anstoß um zukünftig Templateänderungen wo immer es geht zu vermeiden. CSS ist erstaunlich mächtig.

Vorspiel

Zunächst aber einmal zur bisherigen Systemkonfiguration, die ich im Beispiel referenziere. Ein Contao-2.11-System, das drei Unternehmensteile jeweils zweisprachig abbildet. Alles ist über verschiedene Domains realisiert - insgesamt sieben an der Zahl. Darin ein Catalog, der zur Darstellung von Referenzen auf einer Karte benutzt wird - alles kein Hexenwerk, aber schon etwas anspruchsvoller, denn für die Zuordnung der Referenzen (also Firmendaten inklusive der Anschrift) sorgt der eher experimentelle ContaoMaps-Layer von Christian Schiffler. Der Kunde mag es, im Backend auf einer Karte einen Marker zu setzen und dann die Geokoordinaten ausgefüllt zu bekommen - und umgekehrt.

ContaoMaps hat den Vorteil, dass es nicht nur eine Anbindung an den Catalog sondern auch an MetaModels gibt. Und es gibt eine Version, die vermutlich auch mit Contao 3.2 lauffähig ist. Also eigentlich ganz gute Voraussetzungen.

Bevor wir aber auch nur einen einzigen Knopf zum Update drücken machen wir erst einmal ein Backup. Ich benutze dafür gerne SynCto, da ich damit eine Installation vollständig replizieren kann ohne mir einen Kopf darum zu machen, was ich jetzt in welcher Reihenfolge wohin kopieren muss. Klick und los. Trotzdem erst einmal ein einseitiges Vergnügen - zur Zeit vertragen sich MetaModels, SyncCto und der DC_General nicht sonderlich, und es gibt mehrere Versionen, da man mal installieren, mal deinstallieren und gegeneinander austauschen muss.

Vor der Replikation lege ich noch schnell auf dem Zielserver ein paar Subdomains an - zum testen will ich ja jeden Teil des Seitenbaumes direkt aufrufen können. Alles ins Zielverzeichnis geleitet, dort mit dem Contao-Check die erst einmal benötigte Contao-Version 2.11 installiert und mit SyncCto auf den Stand gebracht. Das Bett ist jetzt gemacht, und wir arbeiten im Folgenden auschließlich mit dieser Seitenkopie und nicht mit der Livesite.

Den TabImporter benötige ich ebenfalls nicht mehr und lösche ihn also. Und dann gibt es ja noch Erweiterunugen, von denen ich zunächst erstmal nur weiß, dass ich sie vielleicht noch einmal brauchen kann, die aber ganz sicher beim Upgrade der Installation Ärger machen können. Das TaskCenter ist so ein Fall - deaktivieren, genauso wie alles andere was ich nicht zwingend benötige (oder von dem ich nicht verstehe wozu ich es benötigen könnte). Vor dem Upgrade ist ein guter Zeitpunkt dafür. Was nicht aktiv ist kann auch keinen Ärger machen, schließlich möchten wir nachher noch den Composer benutzen.

Contao 3, FTW!

Im Forum gibt es eine recht gute Anleitung zum Systemupdate von C2 nach C3 - einfach mal nachlesen. Vieles beschäftigt sich mit Contao 3.0, aber das Prinzip gilt für alle Versionssprünge genauso. Ich möchte direkt auf Contao 3.2 LTS, und ich möchte, dass alle Dateien von 'tl_files' nach 'files' wandern. Das sollte machbar sein.

Der nächste Schritt ist es, ein Archiv mit der gewünschten Contao-Version lokal zu entpacken und per FTP (oder FTP-Synchronisation, wenn man neckisch veranlagt ist) in unsere gesicherte Updateinstalltion zu verschieben. Leo Feyer und andere haben sich die Mühe gemacht, die Differenzen zwischen C2 und C2 zu dokumentieren: eine Liste von verwaisten Dateien, die ich mit dem Finger über der Löschtaste abarbeite. Übrig bleibt etwas, was im Kern ein Contao 3.2 sein sollte, und es ist eine gute Idee, das mit demContao-Check zu überprüfen.

Wenn der Check positiv ausgefallen ist dann wird jetzt das Contao-Installtool aufgerufen. Mehrere Datenbankupdates später kann ich mich das erste mal im Backend anmelden. mein Sytsem läuft im abgesicherten Modus, da kann eigentlich nichts schiefgehen. Et voilá.

MetaModels installiere ich ebenfalls via Composer auf Version 1.1 (die TNG möchte ich in diesem Fall nicht) und nutze dann den Bundle-Installer (metamodels/bundle_all) um Attribute und Filter auf den Stand zu bringen. Das geht schneller als erwartet, auch wenn ich bei manchen Erweiterungen mehrere Anläufe brauche (gefühlt).

Zeit für den letzten Akt: aus tl_files wird files. dazu gibt es ein kleines Script von Tristan Lins und Leo feyer, das auf Github zu finden ist. Dieses Script versehe ich mit meinen Zugansdaten zu Datenbank, und lade es es ins Domainroot auf dem Webserver hoch. Der nächste Schritt ist, im Contao-Backend unter Einstellungen der Speicherort für Dateien von /tl_files nach /files zu ändern.

Dann erst rufe ich das Script es im Browser auf. Alle Ressourcen, die bisher auf den tl_files-Ordner zeigten werden jetzt im datenbankgestützten Dateisystem von Contao auf den files-Ordner umgeschrieben. Nach Abschuss des Scripts benenne ich per FTP den Ordner /files in /files_empty und den Ordner /tl_files in /files um. Anschließend logge ich mich ins Backend ein, klicke zur Überprüfung in der Dateiverwaltung auf "synchronisieren" und freue mich abschließend daran, dass alles geklappt hat.