PHPackages                             ion-bazan/composer-diff - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Parsing & Serialization](/categories/parsing)
4. /
5. ion-bazan/composer-diff

ActiveComposer-plugin[Parsing & Serialization](/categories/parsing)

ion-bazan/composer-diff
=======================

Compares composer.lock changes and generates Markdown report so you can use it in PR description.

v2.2.0(1mo ago)1882.1M↓33.9%12[3 issues](https://github.com/IonBazan/composer-diff/issues)3MITPHPPHP >=7.2CI passing

Since Jun 24Pushed 1mo ago6 watchersCompare

[ Source](https://github.com/IonBazan/composer-diff)[ Packagist](https://packagist.org/packages/ion-bazan/composer-diff)[ GitHub Sponsors](https://github.com/IonBazan)[ RSS](/packages/ion-bazan-composer-diff/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (10)Dependencies (8)Versions (32)Used By (3)

Composer Diff Plugin
====================

[](#composer-diff-plugin)

[![PHP 7.2+ | 8.x](https://camo.githubusercontent.com/48b8cf36dd8a87a41c0df928a2c318bcf39c9905773ea40abba55887564efd21/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253545372e325f2537435f253545382d626c75652e737667)](https://packagist.org/packages/ion-bazan/composer-diff)[![Composer v2](https://camo.githubusercontent.com/047784b151dab84ba9ca8b4517f4621424be1a07561bbc5b0cc3e6b5099856d6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6d706f7365722d253545322d737563636573732e737667)](https://packagist.org/packages/ion-bazan/composer-diff)[![Dependencies: 0](https://camo.githubusercontent.com/bbe41f831684a9df3fb6dec2eb24be2f139420e1156f8b6147a037826153acb3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646570656e64656e636965732d302d737563636573732e737667)](https://packagist.org/packages/ion-bazan/composer-diff)[![Latest version](https://camo.githubusercontent.com/8da37b34249b895f02852cf41c58209bf3015da3311e24afb2e0af469702b905/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f696f6e2d62617a616e2f636f6d706f7365722d646966662e737667)](https://packagist.org/packages/ion-bazan/composer-diff)[![GitHub Workflow Status](https://camo.githubusercontent.com/2d96a6748d071db6894e50745309dffed00ce50bd9ad6b3f69c1698fdaf54598/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f496f6e42617a616e2f636f6d706f7365722d646966662f746573742e796d6c)](https://github.com/IonBazan/composer-diff/actions)[![Codecov](https://camo.githubusercontent.com/f2767fb60caaedfe1ef383fc5e62eaef4df1c40bd57b14b788e89eeed5f4016d/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f67682f496f6e42617a616e2f636f6d706f7365722d64696666)](https://codecov.io/gh/IonBazan/composer-diff)[![Mutation testing badge](https://camo.githubusercontent.com/c2b9fcd577c4e23bf7bfb206dd9e09f81282aec1a76de7028588b1af62f2e431/68747470733a2f2f696d672e736869656c64732e696f2f656e64706f696e743f7374796c653d666c61742675726c3d687474707325334125324625324662616467652d6170692e737472796b65722d6d757461746f722e696f2532466769746875622e636f6d253246496f6e42617a616e253246636f6d706f7365722d646966662532466d6173746572)](https://dashboard.stryker-mutator.io/reports/github.com/IonBazan/composer-diff/master)[![Downloads](https://camo.githubusercontent.com/27b6bff01d82ca005f6190bc1dc3eb076ab02da32b40533fa0993704be3de861/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f696f6e2d62617a616e2f636f6d706f7365722d646966662e737667)](https://packagist.org/packages/ion-bazan/composer-diff)[![License](https://camo.githubusercontent.com/7dd90934c304f41105fd7dd44623fcbbff0c57528ad234f1c8630dccda9ccb7a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f696f6e2d62617a616e2f636f6d706f7365722d646966662e737667)](https://packagist.org/packages/ion-bazan/composer-diff)

Generates packages changes report in Markdown format by comparing `composer.lock` files. Compares with last-committed changes by default.

**Now available as [GitHub Action](https://github.com/marketplace/actions/composer-diff)!**

**Web version available at **

[![preview](preview.png)](preview.png)

Installation
============

[](#installation)

```
composer global require ion-bazan/composer-diff
```

If you are using Composer v1 (deprecated) or PHP version older than 7.2, please refer to [version 1.x](https://github.com/IonBazan/composer-diff/tree/1.x) of this package which offers compatibility with PHP 5.3+.

Usage
=====

[](#usage)

```
composer diff # Displays packages changed in current git tree compared with HEAD
composer diff --help # Display detailed usage instructions
```

Example output
--------------

[](#example-output)

Prod PackagesOperationBaseTargetpsr/event-dispatcherNew-1.0.0symfony/deprecation-contractsNew-v2.1.2symfony/event-dispatcherUpgradedv2.8.52v5.1.2symfony/event-dispatcher-contractsNew-v2.1.2symfony/polyfill-php80New-v1.17.1phpNew->=5.3Dev PackagesOperationBaseTargetphpunit/php-code-coverageDowngraded8.0.27.0.10phpunit/php-file-iteratorDowngraded3.0.22.0.2phpunit/php-text-templateDowngraded2.0.11.2.1phpunit/php-timerDowngraded5.0.02.1.2phpunit/php-token-streamDowngraded4.0.23.1.1phpunit/phpunitDowngraded9.2.58.5.8sebastian/code-unit-reverse-lookupDowngraded2.0.11.0.1sebastian/comparatorDowngraded4.0.23.0.2sebastian/diffDowngraded4.0.13.0.2sebastian/environmentDowngraded5.1.14.2.3sebastian/exporterDowngraded4.0.13.1.2sebastian/global-stateDowngraded4.0.03.0.0sebastian/object-enumeratorDowngraded4.0.13.0.3sebastian/object-reflectorDowngraded2.0.11.1.1sebastian/recursion-contextDowngraded4.0.13.0.0sebastian/resource-operationsDowngraded3.0.12.0.1sebastian/typeDowngraded2.1.01.1.3sebastian/versionDowngraded3.0.02.0.1phpunit/php-invokerRemoved3.0.1-sebastian/code-unitRemoved1.0.3-Options
-------

[](#options)

- `--base` (`-b`) - path, URL or git ref to original `composer.lock` file
- `--target` (`-t`) - path, URL or git ref to modified `composer.lock` file
- `--no-dev` - ignore dev dependencies (`require-dev`)
- `--no-prod` - ignore prod dependencies (`require`)
- `--direct` (`-D`) - only show direct dependencies
- `--with-platform` (`-p`) - include platform dependencies (PHP, extensions, etc.)
- `--with-links` (`-l`) - include compare/release URLs
- `--with-licenses` (`-c`) - include license information
- `--format` (`-f`) - output format (mdtable, mdlist, json, github, pr) - default: `mdtable`
- `--gitlab-domains` - custom gitlab domains for compare/release URLs - default: use composer config
- `--filter` - limit output to packages matching the given glob pattern (e.g. `symfony/*`); can be specified multiple times
- `--sort` - sort packages alphabetically by name; use `--sort=operation` to group by operation type (installs, upgrades, downgrades, removals)
- `--allow-missing` - treat missing `composer.lock` files as empty (all target packages reported as new installs)

Advanced usage
--------------

[](#advanced-usage)

```
composer diff master # Compare current composer.lock with the one on master branch
composer diff master:composer.lock develop:composer.lock -p # Compare master and develop branches, including platform dependencies
composer diff --no-dev # ignore dev dependencies
composer diff -p # include platform dependencies
composer diff -f json # Output as JSON instead of table
composer diff -f pr # Collapsible  blocks for GitHub PR descriptions
composer diff --filter="symfony/*" # Show only symfony packages
composer diff --filter="symfony/*" --filter="doctrine/*" # Show symfony and doctrine packages
composer diff --sort # Sort packages alphabetically by name
composer diff --sort=operation # Group packages by operation type (installs, upgrades, downgrades, removals)
composer diff HEAD:new-dir/composer.lock composer.lock --allow-missing # Compare against a lockfile that doesn't exist on the base ref
```

You can find more documentation in the [docs](docs) directory.

### Strict mode

[](#strict-mode)

To help you control your dependencies, you may pass `--strict` option when running in CI. If there are any changes detected, a non-zero exit code will be returned.

Exit code of the command is built using following bit flags:

- `0` - OK.
- `1` - General error.
- `2` - There were changes in prod packages.
- `4` - There were changes is dev packages.
- `8` - There were downgrades in prod packages.
- `16` - There were downgrades in dev packages.

You may check for individual flags or simply check if the status is greater or equal 8 if you don't want to downgrade any package.

Contributing
============

[](#contributing)

Composer Diff is an open source project that welcomes pull requests and issues from anyone. Before opening pull requests, please consider reading our short [Contribution Guidelines](docs/CONTRIBUTING.md).

Similar packages
================

[](#similar-packages)

While there are several existing packages offering similar functionality:

- [jbzoo/composer-diff](https://packagist.org/packages/jbzoo/composer-diff) - requires PHP 7.2+, no composer plugin support
- [josefglatz/composer-diff-plugin](https://packagist.org/packages/josefglatz/composer-diff-plugin) - works only right after install/update
- [davidrjonas/composer-lock-diff](https://packagist.org/packages/davidrjonas/composer-lock-diff) - does not work as composer plugin

This package offers:

- Support for wide range of PHP versions, starting from 7.2 up to 8.5 and newer (v1.x supports PHP 5.3.2+).
- No dependencies if you run it as composer plugin.
- Both standalone executable and composer plugin interface - you choose how you want to use it.
- Allows generating reports in several formats.
- Extra Gitlab domains support.
- [GitHub Action](https://github.com/marketplace/actions/composer-diff) with example workflow
- 100% test coverage.
- MIT license.

###  Health Score

63

—

FairBetter than 99% of packages

Maintenance93

Actively maintained with recent releases

Popularity58

Moderate usage in the ecosystem

Community25

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 71.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~76 days

Recently: every ~82 days

Total

30

Last Release

31d ago

Major Versions

v0.3.1 → v1.0.02021-03-08

1.x-dev → v2.0.02026-07-16

PHP version history (2 changes)v0.1.0PHP >=5.3.2

v2.0.0PHP >=7.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1985514?v=4)[Ion Bazan](/maintainers/IonBazan)[@IonBazan](https://github.com/IonBazan)

---

Top Contributors

[![IonBazan](https://avatars.githubusercontent.com/u/1985514?v=4)](https://github.com/IonBazan "IonBazan (90 commits)")[![darthsteven](https://avatars.githubusercontent.com/u/95782?v=4)](https://github.com/darthsteven "darthsteven (21 commits)")[![davereid](https://avatars.githubusercontent.com/u/62967?v=4)](https://github.com/davereid "davereid (6 commits)")[![giggsey](https://avatars.githubusercontent.com/u/305730?v=4)](https://github.com/giggsey "giggsey (3 commits)")[![trakos](https://avatars.githubusercontent.com/u/6437642?v=4)](https://github.com/trakos "trakos (2 commits)")[![szepeviktor](https://avatars.githubusercontent.com/u/952007?v=4)](https://github.com/szepeviktor "szepeviktor (2 commits)")[![davereid-pfg](https://avatars.githubusercontent.com/u/68073680?v=4)](https://github.com/davereid-pfg "davereid-pfg (1 commits)")[![indykoning](https://avatars.githubusercontent.com/u/15870933?v=4)](https://github.com/indykoning "indykoning (1 commits)")

---

Tags

composercomposer-diffcomposer-plugindiffgithublockmarkdownpackagespackagistphppullrequestcomposerdiffmarkdowngithubpackagespackagistcomposer.lockPullRequest

### Embed Badge

![Health badge](/badges/ion-bazan-composer-diff/health.svg)

```
[![Health](https://phpackages.com/badges/ion-bazan-composer-diff/health.svg)](https://phpackages.com/packages/ion-bazan-composer-diff)
```

###  Alternatives

[league/commonmark

Highly-extensible PHP Markdown parser which fully supports the CommonMark spec and GitHub-Flavored Markdown (GFM)

3.0k450.4M1.2k](/packages/league-commonmark)[drupal/core-composer-scaffold

A flexible Composer project scaffold builder.

5346.5M600](/packages/drupal-core-composer-scaffold)[automattic/jetpack-autoloader

Creates a custom autoloader for a plugin or theme.

566.3M167](/packages/automattic-jetpack-autoloader)[jbzoo/composer-diff

See what has changed after a composer update.

55919.3k1](/packages/jbzoo-composer-diff)[jeroen/mediawiki-github

Simple MediaWiki extension for embedding GitHub hosted content in wiki pages. Supports markdown rendering and syntax highlighting.

334.4k](/packages/jeroen-mediawiki-github)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)