README

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

Inspired by npm-check-updates.

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

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

composer global require beardcoder/composer-check-updates

Usage

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 all packages to latest versions
composer ccu -u

# Then install the new versions
composer update

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

# 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

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

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

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

composer ccu --json

Specify Working Directory

composer ccu -d /path/to/project

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

Color Legend

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

License

MIT