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(2mo ago)6546.2k↑150.4%1[1 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 2w 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

61

—

FairBetter than 99% of packages

Maintenance89

Actively maintained with recent releases

Popularity43

Moderate usage in the ecosystem

Community29

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 66.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

74d 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] (363 commits)")[![eliashaeussler](https://avatars.githubusercontent.com/u/16313625?v=4)](https://github.com/eliashaeussler "eliashaeussler (182 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.3k17.0M1.1k](/packages/phpro-grumphp)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.8M672](/packages/shopware-core)[sylius/sylius

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

8.5k6.0M777](/packages/sylius-sylius)[pimcore/pimcore

Content & Product Management Framework (CMS/PIM/E-Commerce)

3.8k3.9M535](/packages/pimcore-pimcore)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[typo3/cms

TYPO3 CMS is a free open source Content Management Framework initially created by Kasper Skaarhoj and licensed under GNU/GPL.

1.2k1.9M122](/packages/typo3-cms)

PHPackages © 2026

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