Extensions in TYPO3 via Composer und Github einbinden

Extensions in TYPO3 via Composer und Github einbinden

Hin und wieder kommt es vor, dass man private TYPO3 Erweiterungen in ein Projekt einbinden möchte oder muss. Gründe können sein, dass die Extension kostenpflichtig ist oder dass man selbst eigene Extensions in mehreren Projekten nutzen möchte. Wie immer gibt es mehrere Wege die Aufgabe zu lösen. Dabei gilt es auch noch zu beachten, dass TYPO3 selbst in zwei Arten eingerichtet sein kann - klassisch oder Composer basiert.

Composer basierte TYPO3 Installation

Die bequemste Lösung ist, wenn man einen privaten Packagist Zugang besitzt. Für unser Early Access Programm bieten wir diesen Service im Rahmen des vollen Sponsorings an (im Freelancer Programm ist es nicht enthalten).

Private Packagist

Packagist dient dabei als offizieller Anlaufpunkt für Composer-Befehle und kann bequem eingerichtet werden. Das Verfahren läuft dabei in zwei Schritten ab:

Füge das benutzerdefinierte Repository zur composer.json hinzu und richte “authenticate” ein, um auf deine Pakete zuzugreifen. Das nachfolgende Beispiel zeigt die Konfiguration für das Early Access Programm von in2code.

1. Benutzerdefinierte Repository zur composer.json hinzufügen:

composer config repositories.private-packagist composer <a href="https://​​in2code.repo.packagist.com/yourName/" target="_blank" rel="noreferrer">​​in2code.repo.packagist.com/yourName/</a>


Speichere die Authentifizierung in deiner globalen Composer auth.json mit dem nachfolgenden Kommando:

composer config --global --auth http-basic.in2code.repo. packagist.com token XXXXXXXyourToken>XXXX

Einbindung via Github Repository

Eine Alternative ist die Nutzung eines lokalen Repositories, bzw. die Einbindung des Github Repositories. Dazu wird in der composer.json des Projektes ein Eintrag "repositories" ergänzt.

Bsp. Github Femanager Early Access Repository:

"repositories": [  {    "type": "vcs",    "url": "https://github.com/in2code-pro/femanager.git"  } ],

Über diesen Weg wird das Github Repository mit abgefragt, wenn Du dann per Composer die passende Extension requirierst (d.h., hier in unserem Beispiel die TYPO3 Extension femanager).

Eine weitere Alternative ist die Nutzung eines lokalen Git Repositories. Hier checkst Du selbst die Extension in einem Verzeichnis aus und bindest dieses via Composer ein.

Beispiel:

"repositories": [  {    "type": "path",    "url": "/packages/*"  } ],


Wenn wir beim Beispiel der Extension “femanager” bleiben, muss diese in das Verzeichnis unterhalb /packages/ hinein geklont werden. Im Anschluss kann auch wieder mit “composer require“ die Extension installiert werden.

Klassische TYPO3 Installation

In der klassischen Installation liegt der Quellcode der Extensions unterhalb von typo3conf/ext/. 

Hier gibt es zwei ähnliche Ansätze: Exportieren des Github Repositories in das passende Verzeichnis unterhalb von typo3conf/ext/. Hier kann z.B. der Befehl git export genutzt werden, um das Repository ohne die Metadaten (innerhalb von .git) zu holen.

Die Alternative ist der Git Checkout direkt ins Verzeichnis typo3conf/ext/. Bitte beachte, dass dabei auch die Metadaten unter (.git) enthalten sind.

Stefan Busemann

Projekte und Produkte im TYPO3-Bereich?

Haben Sie Fragen zu Projekten und Produkten im TYPO3-Bereich?

Unser Geschäftsführer Stefan Busemann hilft Ihnen gerne weiter.

Stefan Busemann  |  Geschäftsführung & Kundenbetreuung

TYPO3: Finding pages in mixed mode

In TYPO3, Mixed Mode refers to translated pages that contain content only partially related to the corresponding content in the main language. This is indicated in the backend by an error message. But...

Zum Beitrag

Extbase Extensions: Think extensibility with data, site and language

Today, I have a small request for the TYPO3 extension authors out there: Make sure your extensions are extensible. This will also promote the distribution of the corresponding plugins.

Zum Beitrag

SQL: Show all tables sorted by size in descending order

Lately I've been using the SQL command more often to find out which tables in the TYPO3 database are the largest. I've published the snippet once.

Zum Beitrag

TYPO3 12 with CKEditor 5: Styles in a single selection

If you set a link in the RTE in TYPO3, you may have to choose between different link classes, for example to create buttons in the frontend. What's new in TYPO3 12 is that you can select not just one...

Zum Beitrag

Null-Safe Operator in the TYPO3 area

With the introduction of PHP8, problems with undefined arrays or variables in general can arise in many places. Here are a few examples and simple solutions.

Zum Beitrag

Delete the first/last lines of a (SQL) file

There isn't much to say about the following commands. Sometimes it can be useful to delete the first (or last) X lines from a file. And if the file is too large to open with a conventional program, a...

Zum Beitrag