Backport Builder

At a glance

Use nextpdf/backport-builder only for release engineering. It transforms NextPDF source packages into generated distributions for older PHP (PHP: Hypertext Preprocessor) runtimes. It is not an application runtime dependency.

Section map

Page	Use it for
Overview	Product boundaries and generated artifacts.
Install	Installation on a build host.
Quickstart	Dry-run and full build workflows.
Configuration	Rector configs, custom rules, and build flags.
API	Command-line interface scripts, configuration files, and custom Rector rules.
Developer guide	Build pipeline lifecycle, branch model, and release extension points.
Production usage	Continuous integration release operations.
Security and operations	Supply chain boundary and artifact controls.
Troubleshooting	Diagnostics for build and validation failures.

Primary APIs

Surface	Role
scripts/build.php	Main build entry point.
rector/config/rector-php81.php	Downgrade configuration for PHP 8.1.
rector/config/rector-php74.php	Downgrade configuration for PHP 7.4 after enum conversion.
rector/rules/*Rector.php	Custom downgrade rules for PHP syntax that needs project-specific handling.