NewYour coding agent can read the release notes before it upgrades.Set up the MCP server โ
Packagist
Packagist, #2639 most downloaded on Packagist
Compares composer.lock changes and generates Markdown report so you can use it in PR description.
Latest stable
v2.4.0
Last release 1 months ago
05 Oct 2026
Release timing varies
gaps range from 3 weeks to 1.6 years
Nearly every release is documented
notes for 30 of 33 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
33 releases ยท first in 2020
Drag across the ruler to compare, or tap a release to open it.
--with-platform now also reports platform requirements that come from your dependencies (see Platform requirements):
--with-platform now also reports platform requirements that come from your dependencies (see Platform requirements):
php still show your own requirements from composer.json, exactly as writtenphp (effective) show the version range required by your project and all locked packages together, so you can see when a dependency raises its minimum PHP version or starts requiring a new extension>=7.2.5 <8.0), so a row only appears when the effective requirement actually changesprovide or replace (for example by symfony/polyfill-mbstring) are skipped, and constraints without a common range show conflicting (N constraints)effective field, and CSV output has a new last column, effective, so existing columns keep their positions--strict and --with-platform, changes in your dependencies' platform requirements now count as changes and set the exit code accordinglyFull Changelog: https://github.com/IonBazan/composer-diff/compare/v2.3.0...v2.4.0
Add extension points (see Extensions):
Your coding agent can read these notes before it upgrades. Set up the MCP server โ
csv output format--formatpost-composer-diff event lets plugins or your project's composer.json scripts filter or change the reported packages and set the exit code, for example to fail CI on unwanted changesFull Changelog: https://github.com/IonBazan/composer-diff/compare/v2.2.1...v2.3.0
Fix comparing against the wrong composer.lock when run from a subdirectory of a git repository
composer.lock when run from a subdirectory of a git repository| in Markdown tables and special characters in GitHub annotationsgitlab.com--format and --sort values and combining --no-dev with --no-prodThese fixes are also backported to v1.13.1
Full Changelog: https://github.com/IonBazan/composer-diff/compare/v2.2.0...v2.2.1
Add --allow-missing option to ignore missing composer.lock files and treat them as empty.
--allow-missing option to ignore missing composer.lock files and treat them as empty.Add --filter option to restrict output to matching packages
Full Changelog: https://github.com/IonBazan/composer-diff/compare/v2.0.0...v2.1.0
BC Break: Drop support for PHP < 7.2
Full Changelog: https://github.com/IonBazan/composer-diff/compare/v1.13.0...v2.0.0
Fix comparing against the wrong composer.lock when run from a subdirectory of a git repository
composer.lock when run from a subdirectory of a git repository| in Markdown tables and special characters in GitHub annotationsgitlab.com--format values and combining --no-dev with --no-prodFull Changelog: https://github.com/IonBazan/composer-diff/compare/v1.13.0...v1.13.1
Symfony 8 compatibility ๐
Bug: Flip Bitbucket versions for compare URLs (#45) thx @indykoning
BC break: Refactor internal classes (mostly Formatter and DiffEntry to allow using this package as a library
Formatter and DiffEntry to allow using this package as a library (#43)licenses are now string[] instead of string|null when using json format output๐ Added support to filter out non-direct dependencies using --direct (-D) flag similarly to composer outdated (#40) thx @royduin for the idea
๐ Added support to filter out non-direct dependencies using --direct (-D) flag similarly to composer outdated (#40) thx @royduin for the idea
๐ Add new --with-licenses (-c) option to display license information for each package change (#38 thanks @giggsey)
๐ Add new --with-licenses (-c) option to display license information for each package change (#38 thanks @giggsey)
๐ Return package homepage when repository URL cannot be determined - this should provide better context for packages using custom repositories and Wor
๐ Return package homepage when repository URL cannot be determined - this should provide better context for packages using custom repositories and WordPress Packagist. ๐ง Upgrade to PHPStan v2
๐ Improve GitHub compare links to use 3-dot syntax (#35) ๐ Fix Readme typos and ensure PSR-4 compliance (#33, #32 thx @szepeviktor)
๐ Improve GitHub compare links to use 3-dot syntax (#35) ๐ Fix Readme typos and ensure PSR-4 compliance (#33, #32 thx @szepeviktor)
๐ Added generating URLs for Drupal.org packages (#31 thx @darthsteven) ๐ Added more documentation and refactored formatter resolution ๐ง Update CI
๐ Added generating URLs for Drupal.org packages (#31 thx @darthsteven) ๐ Added more documentation and refactored formatter resolution ๐ง Update CI
๐ Added compatibility with Symfony 7 when using this package as a dependency (when symfony/console is at v7 and composer/composer is installed as depe
๐ Added compatibility with Symfony 7 when using this package as a dependency (when symfony/console is at v7 and composer/composer is installed as dependency too).
๐ Use console hyperlinks for mdtable formatter. This is only supported by Symfony Console 4.3+ (when using as standalone) or Composer 2.3+ (when using
๐ Use console hyperlinks for mdtable formatter. This is only supported by Symfony Console 4.3+ (when using as standalone) or Composer 2.3+ (when using as plugin). You may opt out of this feature (and other decorations) using --no-ansi flag. (#23)
๐ฏ Add tests for console decorations for supported formatters (mdtable and mdlist) (#23)
<img width="536" alt="image" src="https://user-images.githubusercontent.com/1985514/167793869-c17ce656-d5dd-4599-9d1b-1355c9cfe520.png">
Full Changelog: https://github.com/IonBazan/composer-diff/compare/v1.6.1...v1.7.0
๐๏ธ Add better logging for git commands (#19) ๐ฏ Remove remaining PHP 8.1 deprecations (#19) ๐ Fix Composer 2.3 compatibility in tests
๐๏ธ Add better logging for git commands (#19) ๐ฏ Remove remaining PHP 8.1 deprecations (#19) ๐ Fix Composer 2.3 compatibility in tests (#19)
๐ Add project links to the output (#16 thx @giggsey)
๐ Add project links to the output (#16 thx @giggsey)
:octocat: Add GitHub Annotation formatter (#14) ๐ Fix CI and test with PHP 8.1
:octocat: Add GitHub Annotation formatter (#14) ๐ Fix CI and test with PHP 8.1 (#13)
โฆextends ArrayIterator instead. This is to avoid deprecations in PHP 8.1.
๐๐ป Skip aliased package versions in diff output (#12)
โจ Add new public getDiff() method allowing to compare two repositories (Composer\Repository\RepositoryInterface)
๐ฏ BC Break: DiffEntries is no longer implementing IteratorAggregate but extends ArrayIterator instead. This is to avoid deprecations in PHP 8.1.
The package keeps providing support for all PHP versions from 5.3 up to 8.1 and beyond with a single code base! ๐
๐ Fix comparing dev versions from same branch (#9 thx @trakos)
๐ Fix comparing dev versions from same branch (#9 thx @trakos)
โจ Add new Changed operation type for those comparing dev- version of packages (#6) ๐ Add some integration tests for Plugin to make sure it works on bo
โจ Add new Changed operation type for those comparing dev- version of packages (#6)
๐ Add some integration tests for Plugin to make sure it works on both Composer v1 and v2 (#8)
๐ฎ๐ปโโ๏ธ Add --strict flag to return non-zero code (useful to detect package downgrades or changes in CI)
๐ฎ๐ปโโ๏ธ Add --strict flag to return non-zero code (useful to detect package downgrades or changes in CI) (#4)
๐ Fix Gitlab URL generation for subgroups (#3 thx @trakos) ๐ฉ๐ปโ๐ซ Add more detailed usage instructions in --help :octocat: Add GitHub Action reference i
๐ Fix Gitlab URL generation for subgroups (#3 thx @trakos)
๐ฉ๐ปโ๐ซ Add more detailed usage instructions in --help
:octocat: Add GitHub Action reference in README
๐ง Fix parsing platform versions like php: ^7.4.6 -> php: ^8.0 #2
๐ง Fix parsing platform versions like php: ^7.4.6 -> php: ^8.0 #2
๐ Add support for base and target arguments - you can now use composer diff master instead of composer diff --base=master
๐ Add support for base and target arguments - you can now use composer diff master instead of composer diff --base=master
Added some colors to the output (new column)
Nothing published for this version
Added colours in mdlist format and compare/release URLs.
Added colours in mdlist format and compare/release URLs.
Nothing published for this version
Add markdown list format support
Add markdown list format support
Nothing published for this version
One column per quarter.