Zum Inhalt springen

TYPO3 per Composer installieren (typo3/minimal)

Mit Hilfe dieser Anleitung kannst du TYPO3 per Composer in deinem Hostingpaket installieren.

Im Beispiel wird dabei eine Minimal-Installation angelegt, in der nur die absolut notwendigen System-Extensions vorhanden sind, damit TYPO3 funktioniert. Weiter unten zeigen wir dir noch, wie du eine angepasste Version ganz einfach mit dem Composer Helper zusammenstellen kannst.

Der Vorteil dieser Methode ist, dass man dabei mit einem sehr schlanken System startet und nur bei Bedarf weitere System-Extensions installiert, wenn sie wirklich benötigt werden.

WICHTIG: In unseren Cloud-Hosting ist Composer (Version 2) bereits installiert und kann direkt verwendet werden. In den Classic-Tarifen muss dagegen zuvor Composer mit Hilfe dieser Anleitung installiert werden.

1. TYPO3 per Composer downloaden

Melde dich per SSH auf dem Webserver an (Anleitung dazu für Windows, Linux/Mac).

Wechsle in das Verzeichnis typo3cms:

cd typo3cms

Erzeuge ein neues Verzeichnis für das Projekt. Hier kannst du einen beliebigen Verzeichnisnamen wählen, der aber keine Leerzeichen, Sonderzeichen oder Umlaute enthalten darf.

mkdir projektname

Wechsle in das Projektverzeichnis:

cd projektname

Starte den Download der TYPO3-Dateien mit dem Befehl:

composer require typo3/minimal

2. Datenbank und (Sub)Domain einrichten

Rufe das Kundenmenü auf und erzeuge eine neue Datenbank für das Projekt. Im Cloud-Hosting wähle eine MariaDB Datenbank, im Classic Hosting ist es immer MySQL 5.6

Wähle eine vorhandene (Sub)Domain oder lege eine neue Subdomain an. Der Zielpfad muss auf das Verzeichnis public/ im Projektverzeichnis zeigen, zum Beispiel beim Cloud Hosting httpdocs/typo3cms/projektname oder beim Classic Hosting typo3cms/projektname/public/

Lege nun noch die für die zu installierende TYPO3 Version die passende PHP Version fest:

Für TYPO3 Version 11.4 wähle PHP 8.0 oder 7.4
Für TYPO3 Version 10.5 wähle PHP 7.4 oder 7.3 (beim Classic Hosting PHP 7.3LATEST als FASTCGI)
Für TYPO3 Version 9.5 wähle PHP 7.2 (beim Classic Hosting PHP 7.2LATEST als FASTCGI)

3. TYPO3 installieren

Erzeuge die Datei FIRST_INSTALL im Verzeichnis public/:

touch public/FIRST_INSTALL

Rufe eingerichtete (Sub)Domain im Browser auf. Der normale Installationsvorgang von TYPO3 startet. Gebe dann die Zugangsdaten zur Datenbank ein.

WICHTIG: der Datenbank-Host lautet beim Cloud Hosting db.mariadb103 und beim Classic Hosting 127.0.0.3

Lege einen Admin-Account an.

WICHTIG: Nutze unbedingt ein sicheres Passwort und verwende NICHT admin, admin2 oder etwas ähnliches als Benutzername!

4. Weitere Extensions installieren

Die Installationsvariante typo3/minimal liefert ein sehr schlankes System, da nur die Extensions installiert sind, die für die Funktion von TYPO3 notwendig sind.

Natürlich kann man bei Bedarf weitere System-Extensions installieren, sofern sie benötigt werden. Diese sogenannten Packages findet man alle auf packagist.org, wenn man dort nach typo3/cms sucht.

Per composer lassen sich diese dann installieren. 

Beispiel: CKEditor installieren:

composer require typo3/cms-rte-ckeditor

Es lassen sich auch mehrere Extensions mit einem Befehl installieren. Dazu müssen die Paketnamen nur mit Leerzeichen getrennt übergeben werden.

Beispiel: das Template- und das Info-Backendmodul installieren:

composer require typo3/cms-tstemplate typo3/cms-info

Anschließen müssen diese Extensions dann im Backend im Extensionmanager aktiviert werden. Eventuell ist auch ein Database Compare im Bereich "Maintenance" in den Admin Tools empfehlenswert.

Composer Pakete individuell auswählen

Wenn die Minimal-Variante nicht ausreicht und man sich entweder die Standard-Extensions oder eine individuell zusammengestallte Auswahl an Extensions installieren möchte, ist die Website "Composer Helper" sehr hilfreich.

Hier kann man entweder vorgefertigte Presets nutzen oder die gewünschen Pakete individuell auswählen.

Es wird eine Befehlszeile für die Shell generiert, die man ganz einfach per Copy&Paste nutzen kann.

Aktualisiert: 21.04.2024