TYPO3 Composer: So funk­tio­niert die In­stal­la­ti­on

Die In­stal­la­ti­on von TYPO3 mit Composer er­mög­licht eine einfache Ver­wal­tung und Ak­tua­li­sie­rung des TYPO3-Systems und seiner Ex­ten­si­ons. Dabei sorgt die au­to­ma­ti­sier­te Ab­hän­gig­keits­kon­trol­le dafür, dass Konflikte minimiert und die Ent­wick­lung ef­fi­zi­en­ter gestaltet werden.

Wofür wird TYPO3 mit Composer genutzt?

Composer ist ein wichtiges Tool für die moderne PHP-Ent­wick­lung und spielt eine zentrale Rolle bei TYPO3. Sie können den Composer nutzen, um TYPO3 und seine Ex­ten­si­ons effizient zu in­stal­lie­ren und zu verwalten. Das Tool lädt au­to­ma­tisch alle be­nö­tig­ten Ab­hän­gig­kei­ten wie Bi­blio­the­ken und Frame­works herunter und in­stal­liert sie. Dadurch re­du­zie­ren Sie Ver­si­ons­kon­flik­te und die Wartung des Systems wird einfacher. Ein großer Vorteil von Composer ist die un­kom­pli­zier­te Hand­ha­bung von Updates. Mit nur einem Befehl können Sie TYPO3 und alle in­stal­lier­ten Er­wei­te­run­gen auf die neuesten Versionen bringen. Dadurch erhöhen Sie die Si­cher­heit und Sta­bi­li­tät des Systems.

Composer fördert außerdem die Mo­du­la­ri­tät. Sie können gezielt nur die Er­wei­te­run­gen in­stal­lie­ren, die Sie benötigen, ohne den gesamten TYPO3-Kern zu be­ein­flus­sen. Zudem erlaubt Composer die Fest­le­gung spe­zi­fi­scher Versionen von TYPO3 und seinen Er­wei­te­run­gen. Das ist besonders nützlich, wenn mehrere Um­ge­bun­gen wie Ent­wick­lung, Test und Pro­duk­ti­on im Einsatz sind. So erhalten Sie eine kon­sis­ten­te und vor­her­seh­ba­re Umgebung für Ihre Projekte.

Schritt-für-Schritt-Anleitung: TYPO3 mit Composer in­stal­lie­ren

Es gibt ver­schie­de­ne Mög­lich­kei­ten, TYPO3 über Composer zu in­stal­lie­ren. Eine davon ist die reguläre In­stal­la­ti­on, bei der Sie die be­nö­tig­ten Pakete direkt mit Composer laden. Diese Methode bietet Ihnen die Fle­xi­bi­li­tät, genau die Pakete und Versionen aus­zu­wäh­len, die für Ihr Projekt er­for­der­lich sind. Um den Prozess zu er­leich­tern, können Sie einen Composer-Helfer verwenden, der Ihnen hilft, die richtigen Composer-Befehle zu ge­ne­rie­ren. Diese Methode eignet sich gut für Be­nut­ze­rin­nen und Benutzer, die spe­zi­fi­sche An­for­de­run­gen haben oder bereits eine be­stehen­de TYPO3-In­stal­la­ti­on anpassen möchten.

Eine weitere Mög­lich­keit ist die In­stal­la­ti­on des cms-base-distribution-Pakets. Diese Methode ist vor­teil­haft, wenn Sie DDEV verwenden, eine Ent­wick­lungs­um­ge­bung, die die Arbeit mit TYPO3 ver­ein­facht. Bei dieser In­stal­la­ti­on kümmert sich das Paket au­to­ma­tisch um die Kon­fi­gu­ra­ti­on Ihrer Datenbank und des Mail­ser­vers für Mailhog. Mailhog ist ein Tool, das es Ihnen er­mög­licht, E-Mails während der Ent­wick­lungs­pha­se zu testen, ohne sie tat­säch­lich zu versenden. Diese Methode be­schleu­nigt den Start von TYPO3-Projekten in DDEV-Um­ge­bun­gen erheblich, da viele grund­le­gen­de Ein­stel­lun­gen bereits vor­kon­fi­gu­riert sind.

Schritt 1: Ver­zeich­nis erstellen

Erstellen Sie ein Ver­zeich­nis für Ihr TYPO3-Projekt. Wechseln Sie in das Ver­zeich­nis, in dem Sie TYPO3 in­stal­lie­ren möchten.

mkdir typo3-project
cd typo3-project

Schritt 2: TYPO3 mit Composer in­stal­lie­ren

Führen Sie den folgenden Composer-Befehl aus, um die neueste Version von TYPO3 zu in­stal­lie­ren:

composer create-project typo3/cms-base-distribution . --no-interaction

Dieser Befehl lädt alle not­wen­di­gen Dateien und Ab­hän­gig­kei­ten für TYPO3 herunter.

Schritt 3: Datenbank erstellen

Gehen Sie ins Kun­den­me­nü und erstellen Sie eine neue Datenbank für Ihr TYPO3-Projekt. Wählen Sie dabei eine MariaDB-Datenbank aus, da diese mit der aktuellen TYPO3-Version kom­pa­ti­bel ist. An­schlie­ßend ent­schei­den Sie sich für eine bereits vor­han­de­ne Subdomain oder erstellen eine neue. Achten Sie darauf, dass der Zielpfad auf das Ver­zeich­nis public/ innerhalb Ihres Pro­jekt­ver­zeich­nis­ses zeigt. Dies könnte zum Beispiel beim Cloud-Hosting der Pfad httpdocs/typo3cms/projektname oder beim Classic Hosting typo3cms/projektname/public/ sein.

Schritt 4: TYPO3 in­stal­lie­ren

Stellen Sie sicher, dass die PHP-Version für die TYPO3-Version, die Sie in­stal­lie­ren möchten, geeignet ist. Für TYPO3 Version 12.4 sollten Sie PHP 8.2 wählen. Um die In­stal­la­ti­on zu starten, führen Sie folgenden Befehl aus:

touch public/FIRST_INSTALL

Rufen Sie dann die ein­ge­rich­te­te Subdomain im Browser auf, und der normale In­stal­la­ti­ons­pro­zess von TYPO3 wird gestartet. Geben Sie schließ­lich die Zu­gangs­da­ten zur zuvor er­stell­ten Datenbank ein. In unserem Ratgeber finden Sie eine aus­führ­li­che Anleitung zur TYPO3-In­stal­la­ti­on.

Schritt 5: Admin-Benutzer erstellen

Während der In­stal­la­ti­on werden Sie auf­ge­for­dert, einen Ad­mi­nis­tra­ti­ons­be­nut­zer zu erstellen. Tragen Sie die er­for­der­li­chen In­for­ma­tio­nen ein.

Schritt 6: In­stal­la­ti­ons­pro­zess ab­schlie­ßen

Nachdem Sie alle er­for­der­li­chen Schritte ab­ge­schlos­sen haben, wird TYPO3 in­stal­liert und Sie können das Backend über http://your-server/typo3-project/typo3 aufrufen.

Schritt 7: Updates durch­füh­ren

Um TYPO3 und alle in­stal­lier­ten Er­wei­te­run­gen zu ak­tua­li­sie­ren, führen Sie den folgenden Befehl aus:

composer update

Schritt-für-Schritt-Anleitung: Extension mit Composer in­stal­lie­ren

Im Folgenden erklären wir Ihnen Schritt für Schritt, wie Sie TYPO3-Er­wei­te­run­gen in­stal­lie­ren können.

Schritt 1: Ver­zeich­nis vor­be­rei­ten

Wechseln Sie in das Ver­zeich­nis Ihrer TYPO3-In­stal­la­ti­on. Dies ist nor­ma­ler­wei­se der Ordner, in dem sich Ihre TYPO3-composer.json-Datei befindet.

cd /path/to/your/typo3-project

Schritt 2: Extension suchen

Suchen Sie die ge­wünsch­te TYPO3-Extension. Sie können dazu das TYPO3 Extension Re­po­si­to­ry nutzen oder die ent­spre­chen­de Extension auf Packagist finden. Notieren Sie sich den Namen des Pakets, zum Beispiel vendor/extension-name.

Schritt 3: Extension mit TYPO3-Composer in­stal­lie­ren

Verwenden Sie den folgenden Befehl, um die Extension zu in­stal­lie­ren:

composer require vendor/extension-name

Ersetzen Sie vendor/extension-name durch den tat­säch­li­chen Namen der Extension, die Sie in­stal­lie­ren möchten.

Schritt 4: Extension ak­ti­vie­ren

Um die Extension zu ak­ti­vie­ren, geben Sie folgenden Befehl ein:

./vendor/bin/typo3 extension:activate <extension key>

Schritt 5: Kon­fi­gu­ra­ti­on durch­füh­ren

Nach der Ak­ti­vie­rung müssen Sie mög­li­cher­wei­se spe­zi­fi­sche Ein­stel­lun­gen für die Extension vornehmen. Diese finden Sie in der Regel im Mo­dul­be­reich des TYPO3-Backends, abhängig von der je­wei­li­gen Extension.

Schritt 6: Cache leeren

Um si­cher­zu­stel­len, dass die Än­de­run­gen wirksam werden, leeren Sie den TYPO3-Cache. Gehen Sie zu „Admin Tools“ -> „Main­ten­an­ce“ -> „Flush TYPO3 and PHP Cache“.

Schritt 7: Updates der Extension durch­füh­ren

Um die Extension zu ak­tua­li­sie­ren, verwenden Sie den folgenden Befehl:

composer update vendor/extension-name

Schritt 8: De­instal­la­ti­on der Extension

Falls Sie die Extension nicht mehr benötigen, können Sie sie mit folgendem Befehl de­instal­lie­ren:

composer remove vendor/extension-name