ondrejmirtes / backward-compatibility-check

8.27.0.2 2026-10-30 20:21 UTC

Requires

• php: ~8.4.0 || ~8.5.0
• ext-dom: *
• ext-json: *
• ext-libxml: *
• ext-simplexml: *
• composer/composer: ^2.9.8
• nikic/php-parser: ^5.7.0
• nikolaposa/version: ^4.2.1
• ocramius/package-versions: ^2.11.0
• php-standard-library/async: ^6.1.1
• php-standard-library/dict: ^6.1.1
• php-standard-library/env: ^6.1.1
• php-standard-library/file: ^6.1.1
• php-standard-library/filesystem: ^6.1.1
• php-standard-library/foundation: ^6.1.1
• php-standard-library/iter: ^6.1.1
• php-standard-library/json: ^6.1.1
• php-standard-library/regex: ^6.1.1
• php-standard-library/shell: ^6.1.1
• php-standard-library/str: ^6.1.1
• php-standard-library/type: ^6.1.1
• php-standard-library/vec: ^6.1.1
• roave/better-reflection: ^6.71.0
• symfony/console: ^7.4.11

Requires (Dev)

• doctrine/coding-standard: ^14.0.0
• justinrainbow/json-schema: ^6.8.2
• php-standard-library/hash: ^6.1.1
• php-standard-library/psalm-plugin: ^2.4.0
• php-standard-library/secure-random: ^6.1.1
• phpunit/phpunit: ^13.1.10
• psalm/plugin-phpunit: ^0.19.7
• roave/infection-static-analysis-plugin: ^1.44.0
• roave/security-advisories: dev-master
• squizlabs/php_codesniffer: ^4.0.1
• vimeo/psalm: ^6.16.1

Conflicts

• marc-mabe/php-enum: <4.7.2
• revolt/event-loop: <0.2.5
• symfony/process: <5.3.7

MIT

• James Titcumb
• Marco Pivetta

Published on Packagist.org on 2026-10-30 20:30 UTC

README

A tool that can be used to verify BC breaks between two versions of a PHP library.

This fork changes internal classes and methods interpretation according to PHPStan backward compatibility promise.

Pre-requisites/assumptions

• Your project uses git
• Your project uses composer.json to define its dependencies
• All source paths are covered by an "autoload" section in composer.json
• Changes need to be committed to git to be covered. You can implement your own logic to extract sources and dependencies from a project though.

Installation

composer require --dev ondrejmirtes/backward-compatibility-check

Usage

Adding to a continuous integration pipeline

The typical intended usage is to just add roave-backward-compatibility-check to your CI build:

vendor/bin/roave-backward-compatibility-check

This will automatically detect the last minor version tagged, and compare the API against the current HEAD. If any BC breaks are found, the tool returns a non-zero status, which on most CI systems will cause the build to fail.

NOTE: detecting the base version only works if you have git tags in the SemVer-compliant x.y.z format, such as 1.2.3.

NOTE: since this tool relies on tags, you need to make sure tags are fetched as part of your CI pipeline. For example in a GitHub action, note the use of fetch-depth: 0:

jobs:
  roave-backwards-compatibility-check:
    name: Roave Backwards Compatibility Check
      runs-on: ubuntu-latest
      steps:
        - uses: actions/checkout@v2
          with:
            fetch-depth: 0
        - name: "Install PHP"
          uses: shivammathur/setup-php@v2
          with:
            php-version: "8.0"
        - name: "Install dependencies"
          run: "composer install"
        - name: "Check for BC breaks"
          run: "vendor/bin/roave-backward-compatibility-check"

Running manually

To generate additional documentation for changelogs:

vendor/bin/roave-backward-compatibility-check --format=markdown > results.md

GitHub Actions

When running in GitHub Actions, it is endorsed to use the --format=github-actions output format:

vendor/bin/roave-backward-compatibility-check --format=github-actions

Documentation

If you need further guidance:

vendor/bin/roave-backward-compatibility-check --help

Configuration

There are currently no configuration options available.