Rigel-Computer - TYPO3 mit Composer lokal installieren: die Grundlagen

Für dieses HOW-TO ist ebenfalls die Erfahrung entscheidend, dass man zwar alles Mögliche findet zu DDEV/Docker, TYPO3 im Zusammenhang mit COMPOSER, aber halt nicht alles - und schon gar nicht alles AUF EINER SEITE (*).

Das möchte ich hier ändern:

Es werden die grundlegenden Schritte von der DDEV-Installation bis zu einer frischen, laufenden Installation aufgezeigt. Das sind nur ein paar - aber halt ein paar entscheidende - und auf einmal und in der korrekten Reihenfolge aufgezeigt.

Allerdings, wie schon in meinem Projekt "TYPO3-Version upgraden - als lokale Kopie - mit Docker & DDEV" erwähnt:
DDEV und Docker lokal unter Windows zu installieren, dafür gibt ausreichend Tipp-Geber (*).
Schon die Homepages von DDEV und Docker geben hier richtig gute Hilfe an die Hand.

Dass DDEV & Docker laufen, wird also vorausgesetzt.

Stand des How-TOs: August 2024

(noch in Arbeit, wird aktuell ergänzt)

Eine DDEV-Installation erstellen

Auf dem lokalen Rechner wird ein neues Verzeichnis angelegt. Dort wird eine Bash (hier: Git-Bash) gestartet und mit folgendem Einzeiler:

ddev config --project-type=typo3 --php-version 8.1 --webserver-type=apache-fpm --database mariadb:10.7 --timezone Europe/Berlin --composer-version 2

eine DDEV-Konfiguration für ein
TYPO3-Projekt
unter MariaDB 10.7
und Apache-Webserver
erstellt.

Danach ein ddev start auf der Bash, und das Verzeichnis sieht danach so aus wie nebenstehend.

Möchte man zusätzlich PHPMYADMIN unter DDEV haben, muss man dies per ddev get ddev/ddev-phpmyadmin manuell anwerfen. Ist aber problemlos.

Das Docroot-Verzeichnis soll /public werden

Um das für eine Composer-Installation notwendige Docroot=public anzulegen, sollte es eigentlich reichen, o.g. Zeile um
--docroot=public --create-docroot
zu ergänzen, sodass der komplette Befehl so aussieht:

ddev config --performance-mode --project-type=typo3 --docroot=public --create-docroot --php-version 8.1 --webserver-type=apache-fpm --database mariadb: 10.7 --timezone Europe/Berlin --composer-version 2

Das hatte (hier, auch erstmalig) nicht geklappt, es gab reichlich nebulöse Fehlermeldungen.
Vielleicht nur ein Tippfehler (beim nächsten Projekt lief es einwandfrei durch) Ist aber auch nicht nötig, denn es gibt für den Fall einen Workaround:

DDEV legt standardmäßig eine config.yaml im .ddev-Verzeichnis an.

Das ist nach der Installation die Umsetzung unserer ersten Zeile oben, die mit ddev config... beginnt. Und eine der wichtigsten und interessantesten (weil manipulierbaren) Dateien unter DDEV!

Diese Datei editiert man an der Stelle Docroot, und ergänzt ein public.
Speichern.
ddev restart auf der Bash - und es wird ein neues Docroot-Verzeichnis "public" angelegt.

TYPO3 im neuen Verzeichnis installieren - mittels Composer

Erst einmal sehr erfreulich einfach, denn DDEV bringt den Composer von Haus aus mit!

Und get.typo3.org stellt eine Reihe von Befehlen zur Verfügung, um direkt ein normales TYPO3 (hier 12.4.x) mittels Composer zu installieren.

Man kann aber auch sein eigenes Paket zusammenstellen, hier gibt es den Composer-Helper auf get.typo3.org:
Hier kann man zwischen FULL, MINIMAL und DEFAULT auswählen.

Einfach die geünschten Core-Extensions zusammenklicken - und den oben erzeugten Code in die Bash kopieren und ausführen.

Nimmt man u.g. Zeile aus der Sektion "Setting up TYPO3 with DDEV and Composer"

ddev composer create --no-install "typo3/cms-base-distribution:^12.4"

wird automatisch die DEFAULT-Version installiert.

Die Zeile wird ebenfalls in die Bash kopiert, ausgeführt.

Dann folgt man den Schritten, die auf get.typo3.org aufgezeigt sind:

ddev composer install

Jetzt kann es etwas dauern, die Dateien werden automatisch geladen und die Verzeichnisstruktur erstellt

ddev restart
und
ddev typo3 setup

Leicht wird dort folgender Hinweis überlesen:

Important note for Git Bash users on Windows using the default terminal MSYS2, don't forget to prepend winpty to interactive commands:

winpty ddev typo3 setup

Es wird die Git-Bash eingesetzt - also ddev typo3 setup statt winpty ddev typo3 setup

Schade: Es tut sich nichts, weder mit noch ohne winpty....

Ein Blick in die config.yaml verrät: (warum-auch-immer) steht dort (Projekt)type: php - nix von TYPO3...
obwohl --project-type=typo3 bei ddev config mit angegeben wurde...Das wird geändert in "typo3" - natürlich danach ein ddev restart.

und diesmal läuft winpty ddev typo3 setup auch durch - mit u.g. Nachfragen (s.Screenshot)

Und erst nach dem letzten Befehl hat man auch eine vollständige Ordner struktur im Verzeichnis:

... to be continued

(*)

Die Ausnahme: eins von Wolfgang Wagners super YouTube-Videos! Das sich genau mit dem Thema beschäftigt

Allerdings gehöre ich zur denjenigen, die

Informationen einfach schneller, präziser und auch besser memorierbar über TEXT

erfassen (können).

Und gearde beim Suchen von Problemlösungen NICHT ein ganzes Video schauen wollen.
Oder sich durch die Timeline scrollen - ob, wenn überhaupt, etwas Relevantes für die eigene Causa dabei ist. Und da bin ich nicht allein.

Das Video - nicht nur dieses von Wolfgang btw. - ist aber 100%ig sehenswert:

Und vor allem enthält es auch auch Schritt-für-Schritt-Anleitung, wie man Docker & DDEV lokal installiert.

Leider ist es - passend zu unserem Metier - mit Erstell-Datum Mai '23 bereits teilweise veraltet, einige der genannten config-commands sind deprecated oder haben sich sonstwie geändert.
Aber um mal gemütlich auf dem Sofa mit der sonoren Stimme von Wolfgang in die Sache einzusteigen, und dabei noch jede Menge zu lernen, ist es immer noch bestens geeignet.