Zum Hauptinhalt springen

So installieren Sie TYPO3 mit composer (in weniger als 5 Minuten)

Während der letzten TYPO3 User Experience Week (T3UXW) wurde deutlich, dass einige Teilnehmer die Vorteile einer composer-basierten TYPO3-Installation nicht kannten. Heute möchte ich die Gelegenheit nutzen, die Einrichtung einer neuen TYPO3-Installation mit nur wenigen Befehlen zu demonstrieren, um den Weg zu TYPO3 so weit wie möglich zu erleichtern.

 

Voraussetzungen

Dieses Handbuch setzt voraus, dass Sie Zugriff auf die Shell Ihres Systems haben und dass Sie composer installiert haben. 
Wenn Sie composer noch nicht installiert haben, klicken Sie bitte hier und prüfen Sie, wie Sie composer auf Ihrem Betriebssystem installieren können.

Erstellen Sie Ihren Code

cd /path/to/your/htdocs/directory

Bei der Installation wird ein Unterordner namens "web" angelegt.  Alles, was öffentlich zugänglich ist, muss in diesem Ordner gespeichert werden, und vertrauliche Dateien, wie z.B. die Konfiguration, sollte außerhalb dieses "Web"-Ordners gespeichert werden.(Tip: Wenn Sie den Namen des Ordners "web" ändern wollen, ist das sehr einfach. Dazu komme ich noch zu einem späteren Zeitpunkt in diesem Artikel.)

 

(copy 4)

composer init

Hiermit wird der Composer-Konfigurationsgenerator gestartet.Sie werden um einige Informationen gebeten, die alle später bearbeitet werden können.

  • Paketname: Ein Schlüssel zur Beschreibung Ihres Projekts. Z.B. "typo3inc/testcomposersetup".
  • Beschreibung: In diesem Fall benutze ich einfach: "Dieses Projekt ist da um zu demonstrieren, wie einfach es ist, eine composer-basierte TYPO3-Installation zu erstellen".
  • Autor: Der Name des Autors steht hier.
  • Minimale Stabilität: Mögliche Werte sind dev, alpha, beta, RC und stabil.
  • Pakettyp: Projekt
  • Lizenz: Kann jede Art von String sein.
  • "Möchten Sie Ihre Abhängigkeiten (require) interaktiv definieren?": Ja
  • typo3/cms (als Versionsbeschränkung können Sie entweder "8" eingeben, um auf der LTS-Version zu bleiben, oder das Feld leer lassen, um immer die neueste Sprint-Version zu erhalten.
  • "Möchten Sie Ihre Entwicklungs-Abhängigkeiten (require-dev) interaktiv definieren?": Nein
  • "Bestätigen Sie die Erstellung?": Ja

Überprüfen Sie nun den Inhalt des Verzeichnisses, Sie finden eine Datei namens composer.json.
Erinnern Sie sich, dass ich Ihnen gesagt habe, es sei möglich den Namen des Ordners "web" zu ändern? Hier sehen Sie, wie man das macht.

Fügen Sie den folgenden Teil zu Ihrer composer.json-Datei hinzu:

"extra": {
       "typo3/cms": {
           "web-dir": "web/public"
       }
}

 

Die Option "web-dir" erlaubt es uns, einen anderen Pfad/Namen für den Webordner zu definieren. In diesem Beispiel wird der Name des Webordners in "web/public" geändert. Wenn Sie sich auf einem case-sensitiven System befinden, achten Sie auf Groß- und Kleinschreibung, die Sie hier definiert haben.


Lassen Sie nun "Composer" seine Magie entfalten.

 

composer install

Abhängig von Ihrer Kaffeemaschine und Ihrer Internetverbindung können Sie sich vielleicht eine schnelle Tasse Kaffee holen, aber seien Sie wirklich schnell, denn selbst bei kalten Caches sollte es nicht länger als 2 Minuten dauern.
Öffnen Sie nun Ihr Install Tool im Browser, und los geht's. (Denken Sie daran, dass der Ordner mit Ihrer Installation der Web-Ordner ist. Konfigurieren Sie Ihren Webserver entsprechend.)

 

Mehr Automatisierung

 

Ich glaube uns bleiben noch zwei Minuten, also bereiten wir die Datenbankverbindung vor.

 

composer require helhum/dotenv-connector

Dieses Composer-Paket bietet eine einfache Möglichkeit, die Konfiguration außerhalb Ihres Web-Root zu speichern. Erstellen Sie eine Datei namens ".env" im übergeordneten Ordner Ihres Web-Ordners und geben Sie die folgenden Zeilen ein (bitte vervöllständigen Sie diese):

 

TYPO3_INSTALL_DB_DRIVER=<your custom driver>
TYPO3_INSTALL_DB_HOST=<your host e.g. localhost>
TYPO3_INSTALL_DB_USER=<your db user for this project>
TYPO3_INSTALL_DB_PASSWORD=<the users password>
TYPO3_INSTALL_DB_PORT=<your custom port or omit this setting>
TYPO3_INSTALL_DB_DBNAME=<the db of your project>
TYPO3_INSTALL_DB_UNIX_SOCKET=<your custom socket or omit this setting>

Wenn Sie zum Install Tool zurückkehren, ist der größte Teil der Datenbankkonfiguration bereits abgeschlossen.

 

Abschluss

Wir haben nicht nur eine TYPO3-Installation in weniger als 5 Minuten abgeschlossen, Sie haben auch einen Blick darauf werfen können, was passieren würde, wenn Sie die composer.json und eine angepasste .env-Datei erstellt hätten, um hundert TYPO3-Installationen auf einmal bereitzustellen.

Auf unserem TYPO3 YouTube-Channel finden Sie Antworten auf weitere häufig gestellte technische Fragen, Anleitungsclips und viele hilfreiche Videos. Wenn Sie diesen Artikel nützlich fanden, teilen Sie bitte den Link in Ihrem Netzwerk.