PHPackages                             beardcoder/composer-check-updates - 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. beardcoder/composer-check-updates

ActiveComposer-plugin

beardcoder/composer-check-updates
=================================

Upgrade your composer.json dependencies to the latest versions, ignoring specified versions (inspired by npm-check-updates)

v1.0.0(2mo ago)01MITPHPPHP ^8.1

Since Feb 23Pushed 2mo agoCompare

[ Source](https://github.com/beardcoder/composer-check-updates)[ Packagist](https://packagist.org/packages/beardcoder/composer-check-updates)[ Docs](https://github.com/beardcoder/composer-check-updates)[ RSS](/packages/beardcoder-composer-check-updates/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

Composer Check Updates
======================

[](#composer-check-updates)

[![Latest Version](https://camo.githubusercontent.com/144289607b5af19ee1e524e09c227a9e13a029c1d63851bcb30e134a94c2093a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6265617264636f6465722f636f6d706f7365722d636865636b2d757064617465732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/beardcoder/composer-check-updates)[![PHP Version](https://camo.githubusercontent.com/095ee4db70515ba50654e0ea05762cf6ca273d5c8e7a93998a2b745a457639da/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6265617264636f6465722f636f6d706f7365722d636865636b2d757064617465732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/beardcoder/composer-check-updates)[![License](https://camo.githubusercontent.com/edddae912011c907ed6f3d426d1043fde0a800fefbdb733382716e89413d2096/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6265617264636f6465722f636f6d706f7365722d636865636b2d757064617465732e7376673f7374796c653d666c61742d737175617265)](LICENSE)

Upgrade your `composer.json` dependencies to the **latest** versions, ignoring specified version constraints.

Inspired by [npm-check-updates](https://github.com/raineorshine/npm-check-updates).

Features
--------

[](#features)

- 🔍 Check for updates beyond your version constraints
- 🎨 Color-coded output (red=major, cyan=minor, green=patch)
- 🖱️ Interactive mode to select which packages to update
- 🎯 Filter packages by name pattern
- 📦 Supports both `require` and `require-dev` dependencies

Installation
------------

[](#installation)

Install globally to use `composer check-updates` or `composer ccu` from any project:

```
composer global require beardcoder/composer-check-updates
```

Usage
-----

[](#usage)

### Check for updates

[](#check-for-updates)

```
# In any project directory with composer.json
composer check-updates

# Or use the alias
composer ccu
```

Example output:

```
Checking 15 packages...

Major Upgrades
  symfony/console              ^5.4    →  ^7.0
  doctrine/orm                 ^2.14   →  ^3.0

Minor Upgrades
  monolog/monolog              ^3.4    →  ^3.5

Patch Updates
  guzzlehttp/guzzle            ^7.8.0  →  ^7.8.1

Run composer ccu -u to upgrade composer.json
Run composer ccu -i for interactive mode

```

### Update composer.json

[](#update-composerjson)

```
# Update all packages to latest versions
composer ccu -u

# Then install the new versions
composer update
```

### Interactive Mode

[](#interactive-mode)

Choose which packages to update interactively:

```
composer ccu -i
```

Use arrow keys to navigate, Space to toggle selection, Enter to confirm.

### Filter Packages

[](#filter-packages)

```
# Only check symfony packages
composer ccu --filter "symfony/*"

# Check multiple patterns
composer ccu --filter "symfony/*" --filter "doctrine/*"

# Exclude packages
composer ccu --reject "phpunit/*"

# Only dev dependencies
composer ccu --dev-only

# Only production dependencies
composer ccu --prod-only
```

### Limit Update Types

[](#limit-update-types)

```
# Only show minor and patch updates (skip major)
composer ccu --minor-only

# Only show patch updates
composer ccu --patch-only
```

### Target Version

[](#target-version)

Control which version to upgrade to:

```
# Upgrade to latest version (default)
composer ccu --target latest

# Only upgrade to latest minor version (no major upgrades)
composer ccu --target minor

# Only upgrade to latest patch version (no minor/major upgrades)
composer ccu --target patch

# Short form
composer ccu -t minor
```

### JSON Output

[](#json-output)

```
composer ccu --json
```

### Specify Working Directory

[](#specify-working-directory)

```
composer ccu -d /path/to/project
```

### Recursive Mode

[](#recursive-mode)

Check all `composer.json` files in subdirectories (skips `vendor/`, `node_modules/`, `.git/`):

```
# Scan all subdirectories
composer ccu --recursive

# Limit scan depth
composer ccu -r --depth 2

# Combine with other options
composer ccu -r --minor-only --json
```

Options
-------

[](#options)

OptionAliasDescription`--upgrade``-u`Update composer.json with new versions`--interactive``-i`Interactive mode to select packages`--filter``-f`Filter packages by name (supports wildcards)`--reject``-x`Exclude packages by name (supports wildcards)`--target``-t`Target version: latest, minor, patch (default: latest)`--dev-only`Only check dev dependencies`--prod-only`Only check production dependencies`--minor-only`Only show minor and patch updates`--patch-only`Only show patch updates`--json`Output results as JSON`--recursive``-r`Recursively check all composer.json in subdirectories`--depth`Max directory depth for --recursive`--working-dir``-d`Use the given directory as working directoryColor Legend
------------

[](#color-legend)

- **Red**: Major upgrade (breaking changes possible)
- **Cyan**: Minor upgrade (new features, backwards compatible)
- **Green**: Patch update (bug fixes)

License
-------

[](#license)

MIT

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance83

Actively maintained with recent releases

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

85d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7cdefd7af5296ba6c9b9dfbc172d808a587a8535c6ced4ad8dc962a3cc8df97f?d=identicon)[beardcoder](/maintainers/beardcoder)

---

Top Contributors

[![BreathCodeFlow](https://avatars.githubusercontent.com/u/164152302?v=4)](https://github.com/BreathCodeFlow "BreathCodeFlow (8 commits)")

---

Tags

plugincomposerupgradepackagesdependenciesupdateoutdatedcheck-updates

### Embed Badge

![Health badge](/badges/beardcoder-composer-check-updates/health.svg)

```
[![Health](https://phpackages.com/badges/beardcoder-composer-check-updates/health.svg)](https://phpackages.com/packages/beardcoder-composer-check-updates)
```

###  Alternatives

[pyrech/composer-changelogs

Display changelogs after each composer update

5904.0M25](/packages/pyrech-composer-changelogs)[dealerdirect/phpcodesniffer-composer-installer

PHP\_CodeSniffer Standards Composer Installer Plugin

598161.9M1.9k](/packages/dealerdirect-phpcodesniffer-composer-installer)[ergebnis/composer-normalize

Provides a composer plugin for normalizing composer.json.

1.1k37.3M2.1k](/packages/ergebnis-composer-normalize)[sllh/composer-versions-check

Checks if packages are up to date to last major versions after update

2352.4M16](/packages/sllh-composer-versions-check)[mwguerra/interactive-upgrader

A CLI tool that handles both Composer and npm dependencies for Laravel projects.

1913.7k](/packages/mwguerra-interactive-upgrader)

PHPackages © 2026

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