PHPackages                             vildanbina/composer-upgrader - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. vildanbina/composer-upgrader

ActiveComposer-plugin[Utility &amp; Helpers](/categories/utility)

vildanbina/composer-upgrader
============================

Effortlessly upgrade all Composer dependencies to their latest versions with a single command.

1.2.0(4mo ago)364.7k—3.1%31MITPHPPHP ^8.0CI passing

Since Mar 2Pushed 4mo ago4 watchersCompare

[ Source](https://github.com/vildanbina/composer-upgrader)[ Packagist](https://packagist.org/packages/vildanbina/composer-upgrader)[ Fund](https://www.buymeacoffee.com/vildanbina)[ GitHub Sponsors](https://github.com/vildanbina)[ RSS](/packages/vildanbina-composer-upgrader/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (4)Dependencies (3)Versions (5)Used By (1)

Composer Upgrader
=================

[](#composer-upgrader)

[![GitHub Workflow Status (main)](https://camo.githubusercontent.com/3d7830785278555173b1dce5a9c1129cb0b2e8c0034ea5e3a261f8d103e2ad70/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f76696c64616e62696e612f636f6d706f7365722d75706772616465722f74657374732e796d6c3f6c6162656c3d5465737473)](https://github.com/vildanbina/composer-upgrader/actions) [![Total Downloads](https://camo.githubusercontent.com/cf3b285a16f6a6f673334c6377a9c0c13c5cc73bb28c77066fab8b7298ea16f0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f76696c64616e62696e612f636f6d706f7365722d7570677261646572)](https://packagist.org/packages/vildanbina/composer-upgrader) [![Latest Version](https://camo.githubusercontent.com/8bccc1454f7e0ffbebd21f8fed8531e716ce12d419a31a1411cb5034b4ba7125/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f76696c64616e62696e612f636f6d706f7365722d7570677261646572)](https://packagist.org/packages/vildanbina/composer-upgrader) [![License](https://camo.githubusercontent.com/34daba7ed3ba1f37e60e10dad1d426dcf0a44994ef2f0034034771e7be850688/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f76696c64616e62696e612f636f6d706f7365722d7570677261646572)](https://packagist.org/packages/vildanbina/composer-upgrader)

---

Introduction
------------

[](#introduction)

**Composer Upgrader** is a sleek and powerful Composer plugin designed to simplify dependency management in PHP projects. With a single command, upgrade all your dependencies to their latest versions effortlessly. Whether you're maintaining a small library or a large application, this tool offers:

- **Flexible Upgrades**: Choose major, minor, or patch-level updates.
- **Targeted Updates**: Focus on specific packages with precision.
- **Stability Control**: Set your preferred stability level for peace of mind.
- **Safe Previews**: Test changes before applying them.

It updates your `composer.json` and prompts you to run `composer update`, keeping you in full control of your project!

---

Requirements
------------

[](#requirements)

- **PHP**: `^8.0+` (Optimized for modern PHP versions)
- **Composer**: `2.x`

---

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

[](#installation)

You can install Composer Upgrader either **locally** in your project or **globally** on your system:

### Local Installation

[](#local-installation)

Add it to your project:

```
composer require vildanbina/composer-upgrader
```

### Global Installation

[](#global-installation)

Install it globally for use across all projects:

```
composer global require vildanbina/composer-upgrader
```

> **Note**: Ensure your global Composer bin directory (e.g., `~/.composer/vendor/bin` or `~/.config/composer/vendor/bin`) is in your PATH to run `composer upgrade-all` from anywhere. Check with `echo $PATH` and update if needed (e.g., `export PATH="$HOME/.composer/vendor/bin:$PATH"`).

No additional setup required—ready to use either way!

---

Configuration
-------------

[](#configuration)

No configuration files needed! Customize your upgrade experience directly through command-line options for a lightweight, hassle-free setup.

---

Commands
--------

[](#commands)

### `upgrade-all`

[](#upgrade-all)

Upgrade your project dependencies with ease. This command scans your `composer.json`, updates it with the latest compatible versions, and advises you to run `composer update` to apply the changes.

**Usage:**

```
composer upgrade-all [options]
```

#### Options:

[](#options)

- **`--major`**: Upgrade to the latest major versions (e.g., `1.0.0` → `2.0.0`). Enabled by default.
- **`--minor`**: Upgrade to the latest minor versions (e.g., `1.0.0` → `1.1.0`). Enabled by default.
- **`--patch`**: Upgrade to the latest patch versions (e.g., `1.0.0` → `1.0.1`). Enabled by default.
- **`--dry-run`**: Preview upgrades without modifying files—ideal for testing.
- **`--stability `**: Set minimum stability (`stable`, `beta`, `alpha`, `dev`). Defaults to `stable`.
- **`--only `**: Upgrade specific packages (e.g., `vendor/package1,vendor/package2,vendor/*`).

#### Examples:

[](#examples)

- **Patch-Only Upgrade:**

    ```
    composer upgrade-all --patch
    ```

    **Output:**

    ```
    Fetching latest package versions...
    Found vendor/package: ^1.0.0 -> 1.0.1
    Composer.json has been updated. Please run "composer update" to apply changes.

    ```
- **Preview Major Upgrades:**

    ```
    composer upgrade-all --major --dry-run
    ```

    **Output:**

    ```
    Fetching latest package versions...
    Found vendor/package: ^1.0.0 -> 2.0.0
    Dry run complete. No changes applied.

    ```
- **Specific Packages:**

    ```
    composer upgrade-all --only vendor/package1 --patch
    ```

    **Output:**

    ```
    Fetching latest package versions...
    Found vendor/package1: ^1.0.0 -> 1.0.1
    Composer.json has been updated. Please run "composer update" to apply changes.

    ```
- **Specific Packages With Prefix:**

    ```
    composer upgrade-all --only vendor/* --patch
    ```

    **Output:**

    ```
    Fetching latest package versions...
    Found vendor/package1: ^1.0.0 -> 1.0.1
    Found vendor/package2: ^2.0.1 -> 2.0.2
    Composer.json has been updated. Please run "composer update" to apply changes.

    ```

After running, finalize the updates with:

```
composer update
```

---

Features
--------

[](#features)

- **Precision Upgrades**: Tailor updates to major, minor, or patch levels with ease.
- **Selective Targeting**: Use `--only` to upgrade just the packages you need.
- **Stability Flexibility**: Match your project’s stability needs (`stable`, `beta`, etc.).
- **Safe Previews**: Test changes with `--dry-run` before committing.
- **Verbose Logs**: Add `-v` for detailed insights into the upgrade process.

---

Contributing
------------

[](#contributing)

Want to make this tool even better? Contributions are welcome! Check out our [CONTRIBUTING](.github/CONTRIBUTING.md) guide for details on submitting bug fixes, features, or documentation improvements.

---

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Spot a security issue? Please email  directly instead of using the issue tracker. We’ll address it swiftly!

---

Credits
-------

[](#credits)

- **[Vildan Bina](https://github.com/vildanbina)** – Creator &amp; Lead Developer
- **All Contributors** – A huge thanks for your support! ([See contributors](../../contributors))

---

License
-------

[](#license)

Licensed under the MIT License (MIT). See the [License File](LICENSE.md) for more information.

Upgrade smarter, not harder, with **Composer Upgrader**! 🎉

###  Health Score

46

—

FairBetter than 93% of packages

Maintenance76

Regular maintenance activity

Popularity35

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 89.3% 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 ~103 days

Total

4

Last Release

132d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5cd0156aac23b34c36c7e291fa0d655a6bd0ceecef941ba458e56f66854536e0?d=identicon)[vildanbina](/maintainers/vildanbina)

---

Top Contributors

[![vildanbina](https://avatars.githubusercontent.com/u/51203303?v=4)](https://github.com/vildanbina "vildanbina (25 commits)")[![mwolff-fn](https://avatars.githubusercontent.com/u/47522519?v=4)](https://github.com/mwolff-fn "mwolff-fn (2 commits)")[![medmahmoudhdaya](https://avatars.githubusercontent.com/u/192469611?v=4)](https://github.com/medmahmoudhdaya "medmahmoudhdaya (1 commits)")

---

Tags

composercomposer-upgraderdependencydependency-upgraderlatestphpupgrade

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/vildanbina-composer-upgrader/health.svg)

```
[![Health](https://phpackages.com/badges/vildanbina-composer-upgrader/health.svg)](https://phpackages.com/packages/vildanbina-composer-upgrader)
```

###  Alternatives

[vaimo/composer-patches

Applies a patch from a local or remote file to any package that is part of a given composer project. Patches can be defined both on project and on package level. Optional support for patch versioning, sequencing, custom patch applier configuration and patch command for testing/troubleshooting added patches.

2994.3M16](/packages/vaimo-composer-patches)[mglaman/composer-drupal-lenient

1317.4M15](/packages/mglaman-composer-drupal-lenient)[drupal/core-composer-scaffold

A flexible Composer project scaffold builder.

5341.9M446](/packages/drupal-core-composer-scaffold)[drupal/core-project-message

Adds a message after Composer installation.

2122.6M172](/packages/drupal-core-project-message)[olvlvl/composer-attribute-collector

A convenient and near zero-cost way to retrieve targets of PHP 8 attributes

184108.8k8](/packages/olvlvl-composer-attribute-collector)[lullabot/drainpipe

An automated build tool to allow projects to have a set standardized operations scripts.

41716.4k2](/packages/lullabot-drainpipe)

PHPackages © 2026

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