Kurz gefasst
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.
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
}
}
], composer require yourvendor/yourextension:@dev 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
urlzum Ordner passt undnamegültig ist (Kleinbuchstaben, mit Schrägstrich). - Klasse nicht gefunden: Prüfen Sie den PSR-4-Namespace und führen Sie
composer dump-autoloadaus. - Extension fehlt im Backend:
typemusstypo3-cms-extensionsein undextension-keygesetzt. - Änderungen nicht sichtbar: Caches leeren.
Suchen Sie stattdessen fertige Erweiterungen? Entdecken Sie die TYPO3 Extensions.
FAQs
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.
Sanjay Chauhan
Sanjay Chauhan A young technology enthusiast and entrepreneur. At 24, he co-founded NITSAN – a TYPO3 Agency in Bhavnagar, India. I love TYPO3, I would like to furnish TYPO3 people with informative content, tutorials, and experiences by composing regular TYPO3 blogs “as to give back to the community”. Today Sanjay is CTO and a TYPO3 innovator at NITSAN.
More From Author