# Lockfile

> Ein Lockfile ist die Datei, in der die exakt installierten Versionen aller Pakete eines Projekts stehen, damit jede Installation denselben Stand erhält (bei Composer die composer.lock).

Originalseite: https://t10.de/glossar/lockfile
Herausgeber: total10 GmbH, https://t10.de/glossar

Die composer.lock entsteht mit dem Befehl composer update. Er ermittelt für alle Abhängigkeiten aus der composer.json passende Versionen und schreibt jedes Paket mit seiner exakten Version in die Datei. Das Projekt ist so auf genau diesen Stand festgelegt. Die composer.json bestimmt, welche Versionen erlaubt sind, das Lockfile hält fest, welche tatsächlich gewählt wurden. Liegt es vor, installiert der Befehl composer install genau diese Versionen. Neuere kommen erst mit einem ausdrücklichen Update ins Projekt.

Die [Composer-Dokumentation](https://getcomposer.org/doc/01-basic-usage.md) empfiehlt, die composer.lock ins Repository einzuchecken, also zusammen mit dem Code zu versionieren, und rät, das Verzeichnis vendor mit dem installierten Code Dritter dort herauszuhalten. Dann arbeiten alle Beteiligten, Testserver und Produktivsysteme mit exakt denselben Versionen der Abhängigkeiten. Was auf dem Testsystem geprüft wurde, läuft in derselben Fassung im Shop.

Auch für Bibliotheken, also Pakete, die andere Projekte einbinden, empfiehlt die aktuelle Fassung der Dokumentation das Einchecken. Es kann unter anderem helfen, Angriffe über die Lieferkette einzudämmen. Auf die Projekte, die eine solche Bibliothek nutzen, wirkt ihr Lockfile allerdings nicht.

Das Lockfile, das Shopware 5 mitliefert, prüfen wir auf bekannte Security Advisories. Für den aktualisierten Stand führen wir ein eigenes Lockfile. Es gehört zu unserem eigenen Composer-Manifest, einer weiteren Datei neben der mitgelieferten composer.json, in der die aktualisierten Abhängigkeiten stehen.

## Siehe auch

- [Composer](https://t10.de/glossar/composer): Composer ist ein Werkzeug für die Programmiersprache PHP, das festhält, welche fremden Programmbibliotheken ein Projekt braucht, und diese installiert und aktualisiert.
- [Abhängigkeit](https://t10.de/glossar/abhaengigkeit): Eine Abhängigkeit ist ein fremdes Software-Paket, auf dem ein Projekt aufbaut und das es zum Laufen braucht, ebenso jedes Paket, das dieses Paket seinerseits benötigt.
- [Repository](https://t10.de/glossar/repository): Ein Repository ist die Ablage eines Software-Projekts mit allen Dateien, der Dokumentation und der Versionsgeschichte jeder Datei, zum Beispiel auf der Plattform GitHub.

## Quellen

1. [Composer Documentation: Basic usage](https://getcomposer.org/doc/01-basic-usage.md), Composer (getcomposer.org), abgerufen am 2026-11-16
2. [Composer Documentation: Libraries](https://getcomposer.org/doc/02-libraries.md), Composer (getcomposer.org), abgerufen am 2026-11-16
