Seminar TYPO3 v14: Installation mit Composer und DDEV

Das Seminar erstellt eine reproduzierbare TYPO3-v14-Projektbasis mit DDEV und Composer. Jeder Schritt wird so dokumentiert, dass Installation, Teamübergabe, Wiederherstellung und späteres Deployment ohne lokale Sonderwege möglich bleiben.

Die Inhalte sind auf einzelseminar mit hohem Praxisanteil ausgelegt. Theorie, Demonstration, geführte Konfiguration und kontrollierte Übungen greifen unmittelbar ineinander.

Lernziele

• Lokale Entwicklungsumgebung reproduzierbar vorbereiten
• TYPO3 v14 kontrolliert mit Composer installieren
• CLI-Setup, Datenbank und Backend-Zugang sicher durchführen
• Site-Konfiguration und grundlegendes Sitepackage einrichten
• Umgebungswerte, Versionsstand und Übergabe dokumentieren

Inhaltsübersicht

1. Projektvoraussetzungen und Verzeichnisstruktur
2. DDEV-Projekt und Dienste
3. Composer-Installation und Abhängigkeiten
4. CLI-Setup und Datenbank
5. Site-Konfiguration und erste Website
6. Umgebungen, Sicherheit und Übergabe

Kapitel 1: Projektvoraussetzungen und Verzeichnisstruktur

Inhaltsübersicht des Kapitels

• Systemvoraussetzungen prüfen
• Projektstruktur festlegen
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Systemvoraussetzungen prüfen, Projektstruktur festlegen. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 1.1: Systemvoraussetzungen prüfen

Fachliche Ausarbeitung: Werkzeuge, PHP-Laufzeit, Datenbank, Containerumgebung und benötigte Zugriffe vor dem Start kontrolliert. Praktische Umsetzung: Eine reproduzierbare Startcheckliste für Arbeitsplatz und Projekt erstellt. Die entstandene Lösung wird mit einer Checkliste geprüft und bei Abweichungen gezielt korrigiert.

Schritt 1.2: Projektstruktur festlegen

Fachliche Ausarbeitung: Konfiguration, lokale Pakete, öffentliche Dateien, persistente Daten und nicht versionierte Werte getrennt. Praktische Umsetzung: Eine klare Git- und Verzeichnisstruktur für das TYPO3-Projekt aufgebaut. Ein definierter Kontrollpunkt gleicht Konfiguration, Funktion und redaktionelle Wirkung miteinander ab.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 2: DDEV-Projekt und Dienste

Inhaltsübersicht des Kapitels

• Lokale Umgebung konfigurieren
• Dienste und Zugriffe prüfen
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Lokale Umgebung konfigurieren, Dienste und Zugriffe prüfen. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 2.1: Lokale Umgebung konfigurieren

Fachliche Ausarbeitung: Projektname, Dokumentenstamm, PHP-Version, Datenbanktyp und zusätzliche Dienste in DDEV festgelegt. Praktische Umsetzung: Eine startbare Umgebung mit nachvollziehbarer Konfiguration erstellt. Ein definierter Kontrollpunkt gleicht Konfiguration, Funktion und redaktionelle Wirkung miteinander ab.

Schritt 2.2: Dienste und Zugriffe prüfen

Fachliche Ausarbeitung: Webserver, PHP, Datenbank, Mailfang und Kommandozeile auf Erreichbarkeit kontrolliert. Praktische Umsetzung: Eine kurze technische Funktionsprüfung mit protokollierten Ergebnissen durchgeführt. Die Arbeitsschritte werden nachvollziehbar dokumentiert und anhand eines fachlichen Prüfkriteriums kontrolliert.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 3: Composer-Installation und Abhängigkeiten

Inhaltsübersicht des Kapitels

• Basisdistribution installieren
• Abhängigkeiten nachvollziehbar verwalten
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Basisdistribution installieren, Abhängigkeiten nachvollziehbar verwalten. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 3.1: Basisdistribution installieren

Fachliche Ausarbeitung: Projektpaket, TYPO3-Core und erforderliche Systempakete über Composer bezogen. Praktische Umsetzung: Eine saubere Installation mit festgeschriebenem Lockfile erzeugt. Die Arbeitsschritte werden nachvollziehbar dokumentiert und anhand eines fachlichen Prüfkriteriums kontrolliert.

Schritt 3.2: Abhängigkeiten nachvollziehbar verwalten

Fachliche Ausarbeitung: Versionseinschränkungen, lokale Pakete, Scripts und sichere Aktualisierung erklärt. Praktische Umsetzung: Eine Erweiterung hinzugefügt, geprüft und wieder kontrolliert entfernt. Abschließend erfolgt eine Prüfung auf Konsistenz, Wartbarkeit und sichere Wiederholbarkeit.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 4: CLI-Setup und Datenbank

Inhaltsübersicht des Kapitels

• Systemeinrichtung per Konsole durchführen
• Datenbankschema und Backend prüfen
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Systemeinrichtung per Konsole durchführen, Datenbankschema und Backend prüfen. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 4.1: Systemeinrichtung per Konsole durchführen

Fachliche Ausarbeitung: Datenbankzugang, Administrator, Sitename und grundlegende Einstellungen über die TYPO3-CLI gesetzt. Praktische Umsetzung: Eine vollständig installierte Instanz ohne manuelle Zwischenschritte erzeugt. Abschließend erfolgt eine Prüfung auf Konsistenz, Wartbarkeit und sichere Wiederholbarkeit.

Schritt 4.2: Datenbankschema und Backend prüfen

Fachliche Ausarbeitung: Schema, Paketstatus, Backend-Anmeldung und zentrale Systemmeldungen kontrolliert. Praktische Umsetzung: Abweichungen behoben und ein dokumentierter Ausgangszustand hergestellt. Die entstandene Lösung wird mit einer Checkliste geprüft und bei Abweichungen gezielt korrigiert.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 5: Site-Konfiguration und erste Website

Inhaltsübersicht des Kapitels

• Site-Datensatz konfigurieren
• Theme oder Sitepackage anbinden
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Site-Datensatz konfigurieren, Theme oder Sitepackage anbinden. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 5.1: Site-Datensatz konfigurieren

Fachliche Ausarbeitung: Root Page, Basis, Sprache, Fehlerbehandlung und Routing als zusammengehörige Site-Einstellungen angelegt. Praktische Umsetzung: Eine erreichbare Website mit konsistenter Sprach- und URL-Konfiguration erstellt. Die entstandene Lösung wird mit einer Checkliste geprüft und bei Abweichungen gezielt korrigiert.

Schritt 5.2: Theme oder Sitepackage anbinden

Fachliche Ausarbeitung: Vorgefertigtes Theme und eigenes Sitepackage als unterschiedliche Startwege eingeordnet. Praktische Umsetzung: Eine minimale Frontend-Ausgabe über ein versioniertes Paket bereitgestellt. Ein definierter Kontrollpunkt gleicht Konfiguration, Funktion und redaktionelle Wirkung miteinander ab.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 6: Umgebungen, Sicherheit und Übergabe

Inhaltsübersicht des Kapitels

• Konfigurationswerte trennen
• Projekt übergabefähig dokumentieren
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Konfigurationswerte trennen, Projekt übergabefähig dokumentieren. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 6.1: Konfigurationswerte trennen

Fachliche Ausarbeitung: Allgemeine Projektkonfiguration, Umgebungsvariablen, lokale Geheimnisse und produktive Werte voneinander getrennt. Praktische Umsetzung: Eine sichere Beispielkonfiguration ohne eingecheckte Zugangsdaten erstellt. Ein definierter Kontrollpunkt gleicht Konfiguration, Funktion und redaktionelle Wirkung miteinander ab.

Schritt 6.2: Projekt übergabefähig dokumentieren

Fachliche Ausarbeitung: Start, Stop, Installation, Datenimport, Cache, CLI, Versionsstand und Fehlerdiagnose beschrieben. Praktische Umsetzung: Eine Teamübergabe auf einer frisch gestarteten Umgebung nachvollzogen. Die Arbeitsschritte werden nachvollziehbar dokumentiert und anhand eines fachlichen Prüfkriteriums kontrolliert.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Didaktischer Aufbau

Jeder Themenblock beginnt mit einer Einordnung, wird am System demonstriert und anschließend praktisch umgesetzt. Übungen bauen aufeinander auf, sodass am Ende eine zusammenhängende, prüfbare TYPO3-Konfiguration oder ein vollständiger redaktioneller Arbeitsablauf vorliegt.