PHP Composer: Der ultimative Guide 2025

1. Was ist Composer?

Composer ist ein Dependency Manager für PHP, ähnlich wie npm für Node.js oder pip für Python. Es löst automatisch Abhängigkeiten auf, lädt Pakete herunter und konfiguriert Autoloading.

2. Installation & Setup

🔧 Composer installieren

Composer kann auf verschiedene Weise installiert werden. Die einfachste Methode ist der Download des Installers von der offiziellen Website.

# Composer-Setup.exe herunterladen
# Von https://getcomposer.org/download/

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

composer --version
# Composer version 2.6.5 2023-10-06 10:11:52

3. composer.json verstehen

Die composer.json ist das Herzstück jedes Composer-Projekts. Sie definiert Abhängigkeiten, Autoloading-Regeln und Projekt-Metadaten.

📄 Grundstruktur einer composer.json

{
    "name": "vendor/project-name",
    "description": "Eine kurze Projektbeschreibung",
    "type": "project",
    "license": "MIT",
    "authors": [
        {
            "name": "Dein Name",
            "email": "ihre.email@example.com"
        }
    ],
    "require": {
        "php": ">=8.1",
        "monolog/monolog": "^3.0"
    },
    "require-dev": {
        "phpunit/phpunit": "^10.0"
    },
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}

4. Dependencies verwalten

Composer macht es einfach, externe Bibliotheken zu installieren und zu verwalten. Alle Pakete werden von Packagist.org heruntergeladen.

📦 Pakete installieren

# Neues Paket hinzufügen
composer require monolog/monolog

# Entwicklungs-Dependency hinzufügen
composer require --dev phpunit/phpunit

# Spezifische Version installieren
composer require "doctrine/orm:^2.14"

# Paket entfernen
composer remove monolog/monolog

🔄 Version Constraints

5. Autoloading & PSR-4

Autoloading eliminiert die Notwendigkeit, Klassen manuell mit require oder include zu laden. PSR-4 ist der moderne Standard für Autoloading in PHP.

🗂️ PSR-4 Autoloading konfigurieren

// composer.json
{
    "autoload": {
        "psr-4": {
            "App\\": "src/",
            "Tests\\": "tests/"
        }
    },
    "autoload-dev": {
        "psr-4": {
            "Tests\\": "tests/"
        }
    }
}

📁 Verzeichnisstruktur

project/
├── composer.json
├── vendor/
│   └── autoload.php
└── src/
    ├── Models/
    │   └── User.php          # App\Models\User
    ├── Controllers/
    │   └── UserController.php # App\Controllers\UserController
    └── Services/
        └── EmailService.php   # App\Services\EmailService

🔧 Autoloader verwenden

<?php
// Autoloader einbinden
require_once 'vendor/autoload.php';

// Klassen automatisch laden
use App\Models\User;
use App\Services\EmailService;

$user = new User();
$emailService = new EmailService();

composer dump-autoload

6. Scripts & Automation

Composer Scripts ermöglichen es, benutzerdefinierte Befehle zu definieren und Build-Prozesse zu automatisieren.

⚙️ Scripts definieren

// composer.json
{
    "scripts": {
        "test": "phpunit",
        "test-coverage": "phpunit --coverage-html coverage",
        "cs-fix": "php-cs-fixer fix",
        "analyse": "phpstan analyse",
        "build": [
            "@cs-fix",
            "@analyse",
            "@test"
        ]
    }
}

🚀 Scripts ausführen

# Einzelne Scripts
composer test
composer cs-fix
composer analyse

# Zusammengesetztes Script
composer build

🔄 Event Hooks

{
    "scripts": {
        "pre-install-cmd": "echo 'Installing dependencies...'",
        "post-install-cmd": [
            "@php artisan key:generate --ansi",
            "@php artisan config:cache"
        ],
        "post-update-cmd": "@php artisan optimize"
    }
}

7. Semantic Versioning

Semantic Versioning (SemVer) ist ein Versionierungsschema, das Composer verwendet, um kompatible Updates zu bestimmen. Das Format ist: MAJOR.MINOR.PATCH

📊 Version Constraints Beispiele

# Caret Constraint (empfohlen)
"^2.1.3"  # >=2.1.3, <3.0.0

# Tilde Constraint
"~2.1.3"  # >=2.1.3, <2.2.0

# Exakte Version
"2.1.3"   # Genau 2.1.3

# Bereich
">=2.1.0 <2.3.0" # Von 2.1.0 bis unter 2.3.0

8. Best Practices

🔧 Nützliche Composer-Befehle