install-composer.asciidoc

Composer zum Herunterladen und Aktualisieren von Dateien verwenden

Wie Sie den Composer zur Verwaltung der Dateien im Kernsystem und in Zusatzmodulen verwenden.

Zielsetzung

Verwenden Sie den Composer, um Dateien des Kernsystems bzw. von installierten Zusatzmodulen und Themes zu aktualisieren und herunterzuladen.

Überspringen Sie dieses Thema, wenn Sie den Composer nicht verwenden.

Erforderliche Vorkenntnisse

[install-tools]

Anforderungen an die Website

Wenn Sie den Composer verwenden möchten, muss er entweder innerhalb einer lokalen Entwicklungsumgebung oder direkt auf dem Server installiert sein, auf dem sich Ihre Live-Website befindet. Siehe: [install-tools].

Arbeitsschritte

Wenn Sie das Tool Composer nicht auf Ihrem Live-Server installieren können, können Sie die Schritte in einem der folgenden Abschnitte auf Ihrem lokalen Server ausführen und dann alle aktualisierten oder hinzugefügten Dateien auf Ihren Live-Server übertragen. Das empfohlene Verfahren ist:

1. Ein Archiv oder eine Zip-Datei erstellen, in der die neuen und geänderten Verzeichnisse und Dateien enthalten sind.

2. Übertragen Sie das Archiv auf Ihren Live-Server

3. Löschen Sie dort die Verzeichnisse, an denen Sie (lokal) Änderungen vorgenommen haben

4. Extrahieren Sie das Archiv zur Aktualisierung auf dem Live-Server.

5. Prüfen Sie, ob in den folgenden Verzeichnissen und Dateien im Hauptverzeichnis Ihrer Installation nach dem Aktualisieren Änderungen und Ergänzungen zu finden sind:

   • Das Verzeichnis vendor

   • Die Datei autoload.php

   • Die Datei composer.json

   • Die Datei composer.lock

Composer zum Herunterladen des Kernsystems verwenden

Führen Sie folgende Schritte aus, wenn Sie das Kernsystem noch nicht heruntergeladen oder installiert haben und Sie Composer verwenden möchten, um sowohl das Kernsystem als auch dessen externe Abhängigkeiten herunterzuladen:

1. Wechseln Sie auf der Kommandozeile in das Verzeichnis, dass sich eine Ebene über dem Verzeichnis befindet, in welches Sie die Software, extrahieren wollen.

2. Geben Sie folgenden Befehl ein, wobei mydir das Verzeichnis ist, das Sie erstellen möchten:

   composer create-project drupal/recommended-project mydir

3. Die neueste Version des Kernsystems wird in das Unterverzeichnis mydir/web heruntergeladen.

Eine zuvor heruntergeladene Website für die Verwaltung mit Composer vorbereiten

Wenn Sie zuvor das Kernsystem heruntergeladen haben, ohne Composer zu verwenden, können Sie später feststellen, dass Sie den Composer zur Verwaltung und Aktualisierung von Abhängigkeiten verwenden wollen oder müssen. Websites die mit Version 8.8.0 oder höher des Kernsystems erstellt wurden enthalten bereits die hierfür erforderliche Composer-Konfiguration und Sie können jederzeit damit beginnen Composer zu nutzen.

Wenn Ihre Website schon Module, Themes oder Profile enthält, die nicht Teil des Kernsystems sind, ist es eine gute Idee, sie in die Datei composer.json im Stammverzeichnis Ihrer Website zu übertragen.

1. Ermitteln Sie den Systemnamen des Projekts: Dies ist der letzte Teil der URL der Projektseite eines Moduls oder Themes. Das Modul Geofield ist beispielsweise unter https://www.drupal.org/project/geofield zu finden und hat den Systemnamen geofield.

2. Führen Sie für jedes heruntergeladene Modul, Theme oder Profil einmal den folgenden Befehl aus, wobei+systemname+ durch den Namen des des gewünschten Projekts ersetzt wird, um das jeweilige Projekt zur Datei composer.json hinzuzufügen:

composer require drupal/systemname

Weitere Informationen zur Verwaltung von Abhängigkeiten mit Composer finden Sie weiter unten.

So konvertieren Sie eine Site, die mit einer Version des Kernsystems vor 8.8.0, oder aus einer Zip- oder tar.gz-Datei heraus installiert wurde, die von Drupal.org heruntergeladen wurde, für doe erwendung mit Composer. Lesen Sie die Anweisungen unter Composer zu einer bestehenden Website hinzufügen (englisch).

Composer zum Herunterladen eines Moduls oder Themes verwenden

Befolgen Sie diese Arbeitsschritte, wenn Sie bereits Composer zur Verwaltung des Kernsystems verwenden, und Composer verwenden möchten, um ein von der Community bereitgestelltes Zusatzmodul oder Theme und dessen Abhängigkeiten hinzuzufügen.

1. Bestimmen Sie den Systemnamen des Projekts

2. Zum Herunterladen eines von der Community bereitgestellten Moduls oder Themes, und dessen externer Komponenten, auch Abhängigkeiten genannt, geben Sie den folgenden Befehl im Hauptverzeichnis Ihrer Website ein (ersetzen Sie systemname durch den Namen, des von Ihnen benötigten Projekts):

   composer require drupal/systemname

Composer verwenden, um zuvor heruntergeladene Dateien zu aktualisieren

Befolgen Sie diese Arbeitsschritte, um die Dateien des Kernsystems oder die Dateien eines von der Community bereitgestellten Zusatzmodules oder Themes, mittels Composer zu aktualisieren, wenn bereits eine Website vorhanden ist:

1. Bestimmen Sie den Systemnamen des Projekts.

2. Wenn Sie auf die neueste stabile Ausgabe des Quellcodes (Release) aktualisieren möchten, verwenden Sie folgenden Befehl, und ersetzen Sie systemname durch den Systemnamen des von Ihnen benötigten Moduls oder Thems:

   composer update drupal/systemname --with-dependencies

3. Wenn Sie eine bestimmte Version benötigen, legen Sie fest, wie Sie die Versionsnummer eingeben, auf die Sie aktualisieren möchten. Zum Beispiel würden Sie für die Version 8.x-1.16 eines von der Community bereitgestellten Zusatzmoduls nur 1.16 eingeben, und für die Version 9.0.7 des Kernsystems würden Sie 9.0.7 eingeben. Geben Sie dann im Stammverzeichnis Ihrer Website den folgenden Befehl ein (ersetzen Sie systemname durch den Systemnamen des Projekts und die korrekte Versionsnummer):

   composer require drupal/systemname:1.16

Vertiefen Sie Ihr Wissen

Weitere Einzelheiten über die Befehle von Composer erfahren Sie, indem Sie die integrierte Hilfe von Composer verwenden. Um beispielsweise mehr über den Befehl create-project zu erfahren, geben Sie composer help create-project auf der Kommandozeile ein.

Videos

Verwendung von Composer und Git zum Herunterladen von Dateien (englisch)

Your browser does not support the video tag.

Zusätzliche Ressourcen

• „Verwendung von Composer zur Verwaltung von Drupal-Site-Abhängigkeiten"(englisch)

• „Das Kernsystem mittels Composer aktualisieren" (englisch)

• „Composer zu einer bestehenden Website hinzufügen" (englisch)

Mitwirkende

Bearbeitet von Jennifer Hodgdon, Hans Fredrik Nordhaug, und Joe Shindelar bei Drupalize.Me von „Verwendung des Composers zur Verwaltung von Drupal-Site-Abhängigkeiten"(englisch) , copyright 2000 - copyright_upper_year liegt bei den einzelnen Mitwirkenden an der Dokumentation der Drupal-Community.

Ins Deutsche übersetzt von Joachim Namyslo.