3.1.0

What's Changed

• Add SARIF output format for GitHub Actions code scanning by @jdrieghe in #57
• Update GitHub Actions to Node.js 24 compatible versions by @jdrieghe in #58
• Auto-update github actions by @WouterSioen in #59
• Bump actions/checkout from 5 to 6 by @dependabot[bot] in #60

New Contributors

• @dependabot[bot] made their first contribution in #60

Full Changelog: v3.0.1...3.1.0

v3.0.1

Fixed

Bumped the Docker image's PHP version

Full Changelog: v3.0.0...v3.0.1

v3.0.0

Breaking changes

PHP 8.4+ required

PHP 8.3 is no longer supported. Minimum version is now PHP 8.4.

Symfony 7.4+ required

Support for Symfony 4, 5, and 6 has been dropped. Minimum version is now Symfony 7.4 (with 8.x support).

New configuration format

The plain YAML list in .allowed-licenses has been replaced by a structured .license-checker.yml file:

Before (2.x):

# .allowed-licenses
- MIT
- BSD-3-Clause

After (3.x):

# .license-checker.yml
allowed:
  - MIT
  - BSD-3-Clause

Renamed commands

2.x	3.x
allowed	list-config

New features

Denylist mode

You can now deny specific licenses instead of maintaining an allowlist. Use the denied: key in your config:

# .license-checker.yml
denied:
  - GPL-3.0
  - AGPL-3.0

allowed and denied are mutually exclusive — use one or the other.

Migration command

A migrate-config command is included to automatically upgrade from 2.x:

vendor/bin/license-checker migrate-config --remove-old

This reads your old .allowed-licenses and writes a new .license-checker.yml with the allowed: key. The --remove-old flag removes the old file after migration.

Under the hood

• Replaced Psalm with PHPStan at max level
• Bumped PHPUnit from 12 to 13
• Pinned GitHub Actions to stable versions
• Added PHP 8.5 to CI test matrix

Full Changelog: v2.1...v3.0.0

The One With The JSON Format

What's Changed

• Fix typo about '.allowed-licenses' in README by @hosni in #50
• add JSON and Text output formatter and tests by @ishifoev in #51

New Contributors

• @hosni made their first contribution in #50
• @ishifoev made their first contribution in #51

Full Changelog: v2.0...v2.1

The One With Dropped PHP Version Support

Changed

• Dropped support for PHP 8.1 and PHP 8.2
• Upgraded all dependencies
• Improve some of the internal classes using new PHP language structures

The one with Symfony 7 and PHP 8.3 support

What's Changed

• Symfony v7 support by @saulens22 in #46
• PHP 8.3 support by @WouterSioen in #47

New Contributors

• @saulens22 made their first contribution in #46

Full Changelog: v1.5...v1.6

The One With The Empty License Fixes

Fixed

• #41
• #42

Changed

• [INTERNAL] Updated dev dependencies to latest version

The One With The Minimum PHP 8.1 Requirement

Changed

• Minimum required PHP version is now 8.1
• [INTERNAL] Refactored some internal value objects for improved maintainability

The One With The Absolute Path Support And License Output

Changed

• Absolute paths are now supported in the --filename flag (Thanks for the suggestion @dvdmunckhof)
• Package licenses are now displayed as part of the CLI output (Thanks for the suggestion @codegain)

The One With The Symfony 6 Support

Changed

• Added support for Symfony 6 dependencies (thanks @ramsey)
• PHP 8.1 is now the default version used in the CI pipeline