dominikb/composer-license-checker

Utility to check for licenses of dependencies and block/allow them.

2.5.1 2024-01-05 15:16 UTC

Requires

• php: ^7.3|^8.0
• ext-json: *
• composer/composer: ^1.10.27|~2.2.22|^2.6.4
• guzzlehttp/guzzle: ^6.3|^7.2
• psr/simple-cache: ^1.0|^2.0|^3.0
• symfony/cache: ^4.2.3|^5.2|^6.0|^7.0
• symfony/css-selector: ^4.2|^5.2|^6.0|^7.0
• symfony/dom-crawler: ^5.2|^6.0|^7.0

Requires (Dev)

• mockery/mockery: ^1.3.3
• phpunit/phpunit: ^9.3
• symfony/var-dumper: ^4.2|^5.2|^6.0|^7.0

MIT

• Dominik Bauernfeind

• dominikb
• composer-license-checker

README

Quickly scan your dependencies, see what licenses they use or check in your CI that no unwanted licenses were merged.

The lookup of the summaries for every license done on https://tldrlegal.com/.
Please inform yourself in more detail about the licenses you use and do not use the provided summary as your sole information.

Installation

You can install the package via composer:

composer require --dev dominikb/composer-license-checker

Usage

Two separate commands are provided:

• ./composer-license-checker check
• ./composer-license-checker report

Use ./composer-license-checker help to get info about general usage or use the syntax ./composer-license-checker help COMMAND_NAME to see more information about a specific command available.

./vendor/bin/composer-license-checker check \
        --allowlist MIT \ # Fail if anything but MIT license is used
        --blocklist GPL \ # Fail if any dependency uses GPL
        --allow dominikb/composer-license-checker # Always allow this dependency regardless of its license

vendor/bin/composer-license-checker report -p /path/to/your/project -c /path/to/composer.phar

Testing

composer test

Code coverage reports are output to the build folder. See .phpunit.xml.dist for more testing configuration.

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Credits

• Dominik Bauernfeind
• All Contributors

License

The MIT License (MIT). Please see License File for more information.