Wie installiert man lokale TYPO3 Extensions im Composer-Modus?

Entwickeln Sie eine lokale benutzerdefinierte TYPO3-Extension im "Composer-Modus"? Das bedeutet, dass Ihre Extension nicht auf dem Composer-Server wie packagist.org liegt. Kein Problem, führen Sie einfach die folgenden Schritte aus, um Ihre benutzerdefinierte lokale TYPO3-Extension im TYPO3 Composer zu installieren.

Wie installiert man lokale TYPO3 Extensions im Composer-Modus?

Um eine lokale TYPO3-Extension im Composer-Modus zu nutzen, legen Sie sie in einen Ordner Ihres Projekts, ergänzen in der composer.json ein Path Repository und binden sie mit @dev ein. Diese Anleitung zeigt jeden Schritt und wie Sie die Extension sicher ausliefern.

Aktualisiert am 8. November 2026 | T3Planet-Redaktion

Entwickeln Sie eine lokale benutzerdefinierte TYPO3-Extension im "Composer-Modus"? Das bedeutet, dass Ihre Extension nicht auf dem Composer-Server wie packagist.org liegt. Kein Problem, führen Sie einfach die folgenden Schritte aus, um Ihre benutzerdefinierte lokale TYPO3-Extension im TYPO3 Composer zu installieren. So wird sie korrekt installiert.

Step 1: Erstellen Sie /extensions im Stammverzeichnis und legen Sie Ihre Erweiterung

Step 2: composer.json konfigurieren

// composer.json
"repositories": [
	{
        "type": "path",
        "url": "extensions/*",
        "options": {
          "symlink": true
        }
    }
],

Step 3: Erweiterung mit @dev installieren

composer require yourvendor/yourextension:@dev

Step 4: Erledigt! Aktivieren Sie es im Erweiterungsmanager.

Schritt 5: Klassen hinzufügen

Eine Klasse in Classes/Controller/ItemController.php nutzt den Namespace Vendor\MyExt\Controller. Nach neuen Klassenordnern führen Sie aus:

composer dump-autoload

Deployment

Lokale Entwicklung und Deployment funktionieren unterschiedlich, halten Sie sie getrennt.

Was ins Repository gehört: composer.json, composer.lock, packages/ (Quellcode Ihrer Extensions) und config/. Committen Sie vendor/ nicht.

Lokale Entwicklung: Das Path Repository legt einen Symlink an, vendor/vendor/my-ext zeigt also auf packages/my_ext. Änderungen gelten sofort.

Deployment: Bauen Sie auf einem sauberen Checkout oder in Ihrer CI:

git clone <your-repo> build && cd build
composer install --no-dev --optimize-autoloader
vendor/bin/typo3 extension:setup

composer install liest composer.lock, der Server bekommt also genau die getesteten Versionen. Führen Sie auf dem Server nie composer update aus.

Symlinks auf dem Server: Ein Symlink funktioniert nur, wenn packages/ neben vendor/ ausgeliefert wird. Liefern Sie nur vendor/ aus, bricht der Link. Liefern Sie beide Ordner aus oder erzwingen Sie beim Build eine Kopie:

COMPOSER_MIRROR_PATH_REPOS=1 composer install --no-dev --optimize-autoloader

Prüfung: Öffnen Sie nach dem Build das TYPO3-Backend (oder führen Sie vendor/bin/typo3 extension:list aus) und prüfen Sie, ob Ihre Extension geladen ist.

Häufige Probleme

  • Paket nicht gefunden: Prüfen Sie, ob url zum Ordner passt und name gültig ist (Kleinbuchstaben, mit Schrägstrich).
  • Klasse nicht gefunden: Prüfen Sie den PSR-4-Namespace und führen Sie composer dump-autoload aus.
  • Extension fehlt im Backend: type muss typo3-cms-extension sein und extension-key gesetzt.
  • Änderungen nicht sichtbar: Caches leeren.

Suchen Sie stattdessen fertige Erweiterungen? Entdecken Sie die TYPO3 Extensions.

Ergänzen Sie in der composer.json ein Path Repository und binden Sie die Extension mit @dev ein, wie in den Schritten dieser Anleitung gezeigt.

In einem Ordner Ihres Projekts, auf den die URL des Path Repository zeigt. Schritt 1 und der Abschnitt Deployment zeigen die Struktur.

Nein. Ein Path Repository erlaubt Composer, eine Extension zu nutzen, die nur in Ihrem Projekt liegt.

Bauen Sie auf einem sauberen Checkout mit composer install --no-dev --optimize-autoloader, führen Sie extension:setup aus und liefern Sie packages/ neben vendor/ aus oder erzwingen Sie eine Kopie mit COMPOSER_MIRROR_PATH_REPOS=1.

Prüfen Sie den PSR-4-Namespace in der composer.json und führen Sie composer dump-autoload aus.

You May Also Like