TYPO3 12 lokal mit Composer und DDEV installieren

25.01.2023, geschätzte Lesedauer: Minute(n). #entwicklung #typo3

Mit TYPO3 12 wird erstmals die Composer Installation ohne "Krücken" voll unterstützt und bringt ein paar wesentliche Änderungen bei der Installationstruktur mit. Da die Veröffentlichung von TYPO3 12 LTS vor der Tür steht, ist es also an der Zeit, sich das mal anzuschauen.

TYPO3 12 ist noch nicht als LTS Version veröffentlicht. Der Artikel wird bei weiteren Änderungen entsprechend aktualisiert. (TYPO3 12 LTS jetzt final, Artikel aktualisiert. Stand: 10.5.2023)

Um TYPO3 12 zu installieren, muss zunächst eine Entwicklungsumgebung wie Docker und DDEV auf dem Rechner installiert sein. Wie das geht, habe ich für macOS (unter Linux sollte das ähnlich sein) bereits hier erklärt. In der Console im Projektverzeichnis müssen nun folgende Befehle ausgeführt werden:

// DDEV initialisiert das Projekt als TYPO3 Projekt: ddev config --project-type=typo3 --docroot=public --create-docroot --php-version 8.1 // TYPO3 Erweiterungen wählen: ddev composer create "typo3/cms-base-distribution:^12" // (Alternativ können benötigte Core Extensions selber zusammengestellt werden: https://get.typo3.org/misc/composer/helper) // Erweiterung TYPO3 Console installieren: composer req helhum/typo3-console // DDEV neu starten ddev restart // TYPO3 installieren sowie Benutzername, Passwort für den Backend Zugang, Datenbank, TYPO3 Seiten Name etc. anlegen: ddev typo3 install:setup // Das Frontend der neuen Installation im Browser öffnen: ddev launch

Die Installation (und Deinstalltion) von zusätzlichen Extensions und von lokalen Erweiterungen erfolgt wie im Blogeintrag zur Installation von TYPO3 11 beschrieben.

Neue Installationsstruktur

Schaut man sich jetzt die Installationsstruktur an, zeigen sich deutliche Änderungen zu bisherigen TYPO3 Versionen. So liegt die index.php weiterhin im public Ordner, jedoch fehlt im Verzeichnis "typo3" das Unterverzeichnis "sysext" mit seinen Core Extensions. Core Erweiterungen liegen jetzt im Verzeichnis "vendor/typo3" außerhalb von "public", sind umbenannt ("cms-xyz") und werden über Symlinks mit langen kryptische Namen im Verzeichnis "public/_assets" geladen. In "vendor" liegen zudem alle Erweiterungen, die über Composer von anderen Anbietern installiert werden. Daher fehlt auch das Verzeichnis "typo3conf/ext". Überhaupt ist das komplette Verzeichnis "typo3conf" leer. Denn auch die Konfigurationsdateien "LocalConfiguration.php" und "AdditionalConfiguration.php" wurden verschoben und liegen jetzt außerhalb von "public" im Verzeichnis config/system und heißen "settings.php" und "additional.php".

Damit liegen im Verzeichnis "public", auf das die Domain(s) verweisen, nicht mehr systemrelevante Dateien. In "public " liegen jetzt ausschließlich die "index.php", die "install.php" sowie die Assets wie Fileadmin. Die neue Installationsstruktur ist damit logischer und dürfte TYPO3 nochmals sicherer machen.

Welche Auswirkung bringt das mit sich?

Für Integratoren bedeutet das vor allem, dass keine absoluten Pfade mehr im Stil von "/typo3conf/ext/provider/Resources/Public/Js/bundle.min.js" verwendet werden können. Eine gute Hilfe bietet folgender Blog: brot.krue.ml.

Weitere Änderungen

Alle Änderungen sind im Change Log aufgeführt, neue Feature werden in den Artikeln zu den jeweiligen Sprint Releases auf typo3.org kommuniziert. Hier nur ein paar Hinweise, die bei der Installation oder bei Updates wichtig sein könnten.

CKEditor

Der CKEditor ist in Version 5 integriert. Das bringt mit sich, dass die Plugins der Version 4 nicht mehr funktionieren. Auch die Konfiguration in der YAML Datei muss weitreichend angepasst werden. Am einfachsten geht das vermutlich, wenn man die alte YAML mit den Einstellungen aus vendor/typo3/cms-rte-ckeditor/Configuration/RTE/Full.yaml überschreibt und dann entsprechend der Doku anpasst.

UPDATE 7.2.2023:

Install Tool

Um (außerhalb des TYPO3 Backends) ins Install Tool zu gelangen, wurde bisher eine Datei "ENABLE_INSTALL_TOOL" im Verzeichnis "(public/)typo3conf" angelegt. Mit Version 12.2 hat sich der Ort geändert: "var/transient" oder wahlweise "config".