PHPackages                             eliashaeussler/version-bumper - 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 & Helpers](/categories/utility)
4. /
5. eliashaeussler/version-bumper

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

eliashaeussler/version-bumper
=============================

Composer plugin to bump project versions during release preparations

4.0.3(4w ago)6507.4k↑132.7%1[3 issues](https://github.com/eliashaeussler/version-bumper/issues)[2 PRs](https://github.com/eliashaeussler/version-bumper/pulls)20GPL-3.0-or-laterPHPPHP ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0CI passing

Since Sep 23Pushed 2w ago1 watchersCompare

[ Source](https://github.com/eliashaeussler/version-bumper)[ Packagist](https://packagist.org/packages/eliashaeussler/version-bumper)[ RSS](/packages/eliashaeussler-version-bumper/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (10)Dependencies (102)Versions (41)Used By (20)

Version Bumper
==============

[](#version-bumper)

[![Coverage](https://camo.githubusercontent.com/694ae73be235e5ce7f603f2466b82a9bc3a58ac152dc751ade4050545c01bf3b/68747470733a2f2f696d672e736869656c64732e696f2f636f766572616c6c73436f7665726167652f6769746875622f656c6961736861657573736c65722f76657273696f6e2d62756d7065723f6c6f676f3d636f766572616c6c73)](https://coveralls.io/github/eliashaeussler/version-bumper)[![CI](https://camo.githubusercontent.com/812ff9e4c42a5827425130f2c5a10888a3504cee010662a55f5bda95dd1106b7/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f656c6961736861657573736c65722f76657273696f6e2d62756d7065722f63692e79616d6c3f6c6162656c3d4349266c6f676f3d676974687562)](https://github.com/eliashaeussler/version-bumper/actions/workflows/ci.yaml)[![Supported PHP Versions](https://camo.githubusercontent.com/696c2ad53a3d8d5b3e6c13f670ffdb36579eb02203fd5b6cef8644b8bbad671e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f656c6961736861657573736c65722f76657273696f6e2d62756d7065722f7068703f6c6f676f3d706870)](https://packagist.org/packages/eliashaeussler/version-bumper)

A Composer plugin to bump project versions during release preparations. Provides a Composer command `bump-version` and offers an easy-to-use PHP API for integration in other frameworks.

🔥 Installation
--------------

[](#-installation)

[![Packagist](https://camo.githubusercontent.com/694f9e01c955feb9cf566b833df13d6f35eac531857c5cd009b5108bf15ecc28/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f656c6961736861657573736c65722f76657273696f6e2d62756d7065723f6c6162656c3d76657273696f6e266c6f676f3d7061636b6167697374)](https://packagist.org/packages/eliashaeussler/version-bumper)[![Packagist Downloads](https://camo.githubusercontent.com/2cb140a1e38b68c474ec87cb9fbe4ca6ace7b3d9578a933d0ca9d6b2beecc352/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f656c6961736861657573736c65722f76657273696f6e2d62756d7065723f636f6c6f723d627269676874677265656e)](https://packagist.org/packages/eliashaeussler/version-bumper)

```
composer require --dev eliashaeussler/version-bumper
```

⚡ Quickstart
------------

[](#-quickstart)

Add a `version-bumper.yaml` config file:

```
# version-bumper.yaml

presets:
  - composer-package

releaseOptions:
  commitMessage: '[RELEASE] Release of my-fancy-library {%version%}'
```

Bump next major/minor/patch version:

```
composer bump-version [major|minor|patch] --release
```

📝 Documentation
---------------

[](#-documentation)

- Usage
    - [Console command](docs/cli.md)
    - [PHP API](docs/api.md)
    - [Version range](docs/version-range.md)
- Configuration
    - [Config file](docs/config-file.md)
    - [Presets](docs/presets.md)
    - [Actions](docs/actions.md)
    - [Schema](docs/schema.md)

🧑‍💻 Contributing
----------------

[](#‍-contributing)

Please have a look at [`CONTRIBUTING.md`](CONTRIBUTING.md).

⭐ License
---------

[](#-license)

This project is licensed under [GNU General Public License 3.0 (or later)](LICENSE).

###  Health Score

59

—

FairBetter than 98% of packages

Maintenance85

Actively maintained with recent releases

Popularity43

Moderate usage in the ecosystem

Community28

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 64.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 ~24 days

Recently: every ~5 days

Total

26

Last Release

29d ago

Major Versions

1.3.1 → 2.0.02025-01-12

2.4.0 → 3.0.02025-06-28

3.3.0 → 4.0.02026-05-23

PHP version history (4 changes)1.0.0PHP ~8.1.0 || ~8.2.0 || ~8.3.0

1.3.1PHP ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.0

3.0.0PHP ~8.2.0 || ~8.3.0 || ~8.4.0

3.1.0PHP ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/16313625?v=4)[Elias Häußler](/maintainers/eliashaeussler)[@eliashaeussler](https://github.com/eliashaeussler)

---

Top Contributors

[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (324 commits)")[![eliashaeussler](https://avatars.githubusercontent.com/u/16313625?v=4)](https://github.com/eliashaeussler "eliashaeussler (177 commits)")[![konradmichalik](https://avatars.githubusercontent.com/u/4558190?v=4)](https://github.com/konradmichalik "konradmichalik (1 commits)")[![mteu](https://avatars.githubusercontent.com/u/2636487?v=4)](https://github.com/mteu "mteu (1 commits)")

---

Tags

bumpcomposer-pluginreleasesemverversion

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/eliashaeussler-version-bumper/health.svg)

```
[![Health](https://phpackages.com/badges/eliashaeussler-version-bumper/health.svg)](https://phpackages.com/packages/eliashaeussler-version-bumper)
```

###  Alternatives

[phpro/grumphp

A composer plugin that enables source code quality checks.

4.3k16.7M1.0k](/packages/phpro-grumphp)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M574](/packages/shopware-core)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k5.9M738](/packages/sylius-sylius)[oro/platform

Business Application Platform (BAP)

645143.5k115](/packages/oro-platform)[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

103519.9k53](/packages/friendsoftypo3-content-blocks)[open-dxp/opendxp

Content & Product Management Framework (CMS/PIM)

9421.6k61](/packages/open-dxp-opendxp)

PHPackages © 2026

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