Backport Builder

Auf einen Blick

Verwenden Sie nextpdf/backport-builder ausschließlich im Release-Engineering. Es erzeugt aus NextPDF-Quellpaketen Distributionen für ältere PHP-Laufzeitumgebungen und ist keine Laufzeitabhängigkeit der Anwendung.

Abschnittsübersicht

Seite	Einsatzbereich
Übersicht	Produktabgrenzung und erzeugte Artefakte.
Installation	Installation auf dem Build-Host.
Schnellstart	Trockenlauf und vollständiger Build-Ablauf.
Konfiguration	Rector-Konfigurationen, eigene Regeln und Build-Flags.
API	CLI-Skripte, Konfigurationsdateien und eigene Rector-Regeln.
Entwicklerhandbuch	Lebenszyklus der Build-Pipeline, Branch-Modell und Erweiterungspunkte für Releases.
Produktivnutzung	Release-Betrieb in der CI.
Sicherheit und Betrieb	Lieferkettengrenze und Artefaktkontrollen.
Fehlerbehebung	Diagnose von Build- und Validierungsfehlern.

Wichtigste APIs

Schnittstelle	Rolle
scripts/build.php	Haupteinstiegspunkt für den Build.
rector/config/rector-php81.php	Downgrade-Konfiguration für PHP 8.1.
rector/config/rector-php74.php	Downgrade-Konfiguration für PHP 7.4 nach der Enum-Konvertierung.
rector/rules/*Rector.php	Eigene Downgrade-Regeln für PHP-Syntax, die eine projektspezifische Behandlung erfordert.