Aus den Paketquellen¶

Composer ist seit Ubuntu 16.04 in den Paketquellen enthalten und wird über folgendes Paket installiert:

• composer (universe)

Befehl zum Installieren der Pakete:

sudo apt-get install composer 

Oder mit apturl installieren, Link: apt://composer

Manuelle Installation¶

Legt man Wert auf die aktuellste Version von Composer, so empfiehlt sich die manuelle Installation.

sudo apt-get install php-cli 

cd ~
wget -qO composer-setup.php https://getcomposer.org/installer  

COMPOSER_HASH=HIER-DEN-HASH-KEY-EINFÜGEN
php -r "if (hash_file('SHA384', 'composer-setup.php') === '$COMPOSER_HASH') { echo 'Installationsskript ist in Ordnung.'; } else { echo 'ACHTUNG: Das Installationsskript ist FEHLERHAFT.'; unlink('composer-setup.php'); } echo PHP_EOL;" 

Installationsskript ist in Ordnung.

ACHTUNG: Das Installationsskript ist FEHLERHAFT.

sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer 

sudo composer self-update 

Installation überprüfen¶

Unabhängig davon, für welche Installationsmethode man sich entschieden hat, kann wie folgt überprüft werden, ob die Installation erfolgreich war:

composer 

Sollte bei der manuellen Installation die Fehlermeldung

bash: /usr/bin/composer: Datei oder Verzeichnis nicht gefunden

erscheinen. So muss der Befehl

hash composer 

ausgeführt werden.

Es sollte die installierte Version und Informationen zu Composer erscheinen:

   ______
  / ____/___  ____ ___  ____  ____  ________  _____
 / /   / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__  )  __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
                    /_/
Composer version 1.10.7 2020-06-03 10:03:56

Usage:
  command [options] [arguments]

Options:
  -h, --help                     Display this help message
  -q, --quiet                    Do not output any message
  -V, --version                  Display this application version
      --ansi                     Force ANSI output
      --no-ansi                  Disable ANSI output
  -n, --no-interaction           Do not ask any interactive question
      --profile                  Display timing and memory usage information
      --no-plugins               Whether to disable plugins.
  -d, --working-dir=WORKING-DIR  If specified, use the given directory as working directory.
      --no-cache                 Prevent use of the cache
  -v|vv|vvv, --verbose           Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug

Available commands:
...

Hat man Composer manuell installiert, so sollte man nun die zuvor heruntergeladene Datei composer-setup.php löschen.

Wo sich die Benutzereinstellungen befinden¶

Hat man als Ubuntuuser Composer genutzt, werden folgende Verzeichnisse im Heimverzeichnis angelegt. Das zu wissen kann hilfreich sein, wenn man seine Einstellungen zurücksetzen will, beziehungsweise ein Deinstallation vollständig durchführen will.

Ein Paket installieren¶

Eine Composer-Paket-Bezeichnung besteht normalerweise aus dem Namen des Paketbetreuers, vendor genannt, und des Paketnamens. Ein Beispiel:

Angenommenen, man möchte das Programm ZendMail von Zend-Framework (einen Mailer für PHP) für sein eigenes Projekt installieren, benötigt man zunächst die genaue Paketbezeichnung. Wie man die Paketbezeichnung heraus findet, wird weiter unten erklärt. Für ZendMail lautet die korrekte Paketbezeichnung zendframework/zend-mail. Nun gibt man auf der Konsole im gewünschten Projektverzeichnis lediglich:

composer require zendframework/zend-mail 

ein.

Was nun geschieht:

• Composer gibt auf der Konsole aus:

Using version ^2.10 for zendframework/zend-mail
./composer.json has been created
Loading composer repositories with package information
Updating dependencies (including require-dev)
Package operations: 9 installs, 0 updates, 0 removals
  - Installing symfony/polyfill-mbstring (v1.11.0): Loading from cache
  - Installing true/punycode (v2.1.1): Loading from cache
  - Installing psr/container (1.0.0): Loading from cache
  - Installing container-interop/container-interop (1.2.0): Loading from cache
  - Installing zendframework/zend-stdlib (3.2.1): Loading from cache
  - Installing zendframework/zend-validator (2.12.0): Loading from cache
  - Installing zendframework/zend-mime (2.7.1): Loading from cache
  - Installing zendframework/zend-loader (2.6.0): Loading from cache
  - Installing zendframework/zend-mail (2.10.0): Loading from cache
... usw

• Es wurde die Datei composer.json im aktuellen Arbeitsverzeichnis angelegt.

• Das Verzeichnis vendor/ wurde erstellt. Dort wiederum wurde folgendes neu erstellt:

  • Die Datei autoload.php. Sie muss im Projekt für das automatische Laden eingebunden werden (Autoloading) - siehe unten.

  • Das Unterverzeichnis composer/. Es regelt das automatische Laden aller per Composer installierten Pakete.

  • Das Unterverzeichnis zend-framework/ - die ist die Bezeichnung des Paketbetreuers (vendor) von ZendMail - hierin befindet sich das eigentlich Paket: zend-mail/.

  • Neben zend-framework/ wurden hier noch alle Abhängigkeiten in weiteren Unterverzeichnissen mit installiert - eine der wichtigsten Funktionen von Composer.

Pakete einbinden¶

In dem Skript, in dem man die mittels Composer installierte Bibliothek nutzen möchte, bindet man nun die von Composer erstellte Datei vendor/autoload.php ein und schon hat man mittels Namensräumen 🇩🇪 Zugriff auf sämtliche mittels Composer installierten Klassen. In unserem Beispiel mit ZendMail könnte unser PHP-Skript folgendermaßen aussehen:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

<?php
// Composer autoloading.
// Wir gehen davon aus, dass dieses Skript sich eine Ebene über
// den von Composer erstellten vendor-Verzeichnis befindet
include __DIR__ . '/vendor/autoload.php';

//Die Komponenten, die gebraucht werden, per Namespaces einbinden.
// In unserem Beispiel:
use Zend\Mail;

//Jetzt kann es losgehen und ZendMail verwendet werden:
$mail = new Mail\Message();
$mail->setBody('Hallo, lieber Ubuntuuser!');
$mail->setFrom('I.Bims@example.org', "Max Mustermann");
$mail->addTo('Kevin@example.com', 'Name des Empfängers');
$mail->setSubject('Betreff: Ich nutze jetzt Composer!');

// ... usw.

Projektbezogene Befehle¶

Folgende Befehle bzw. Optionen dienen der Verwaltung des jeweiligen Projektes, in welchem man Composer ausführt. Dazu muss man Composer in dem Verzeichnis des Projektes ausführen, in dem sich die composer.json befindet. Üblicherweise ist dies die oberste Verzeichnisebene des jeweiligen Projektes. Eine Ausnahme bildet der Befehl require. Ist noch keine composer.json Datei in einem (neuem) Projekt-Verzeichnis vorhanden, so wird sie erstellt.

Globale Optionen¶

Diese Optionen können zu jedem Composer-Befehl mit eingegeben werden. Die Syntax lautet dabei:

composer <Befehl> [--Option]
composer <Befehl> [-Optionskürzel] 

Beispiel:

composer require symfony/console -d /var/www/lib/meine-tools/ 

Hier werden die Konsolen-Werkzeuge 🇬🇧 des PHP-Frameworks Symfony in das Verzeichnis /var/www/lib/meine-tools/ installiert.

Eine ausführliche Übersicht aller Befehle und Optionen findet man auf der offiziellen Dokumentationsseite 🇬🇧 des Projektes.

Per IDE¶

Einige Entwicklungsumgebungen (IDEs) bieten recht komfortable grafische Bedienelemente, um die composer.json-Datei zu verwalten. Zum Beispiel:

Eclipse mit PDT¶

Eclipse hat mit der Erweiterung PHP Development Tools 🇬🇧 ein umfangreiches Werkzeug mit im Programm, um fast alle Modifikationen an einem Composer-Projekt vorzunehmen. Das GUI-Fenster für Composer, das für eine bessere Übersicht in mehrere Reiter aufgegliedert ist, bietet sogar eine integrierte Suchfunktion für Packagist, mit der man neue Pakete installieren kann. Sobald man die composer.json innerhalb von Eclipse per Doppel-Klick öffnet, wird die GUI gestartet.

Paketverwaltung in Eclipse mit Packagist Suchfenster	Abhängigkeitein-Graph in Eclipse

Composercat¶

Composercat 🇬🇧 bietet DEB-Pakete zur Installation an. Das Projekt befindet sich noch in der Beta-Phase, ist aber bereits gut zu gebrauchen. Allerdings stammt die letzte Version aus Juli 2017 und die Software scheint nicht mehr weiterentwickelt zu werden.