PHPackages                             elkadrey/version-bump - 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. elkadrey/version-bump

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

elkadrey/version-bump
=====================

A Composer plugin that allows you to manage versioning similar to npm version. It supports patch, minor, major, prepatch, preminor, premajor, and prerelease versioning while integrating with Git for tagging and commits

v1.0.4(1y ago)12232MITPHPPHP &gt;=7.4

Since Feb 27Pushed 1y ago1 watchersCompare

[ Source](https://github.com/elkadrey/version-bump)[ Packagist](https://packagist.org/packages/elkadrey/version-bump)[ RSS](/packages/elkadrey-version-bump/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)Dependencies (3)Versions (5)Used By (0)

Version Bump - Composer Plugin
==============================

[](#version-bump---composer-plugin)

A Composer plugin that allows you to manage versioning similar to `npm version`. It supports `patch`, `minor`, `major`, `prepatch`, `preminor`, `premajor`, and `prerelease` versioning while integrating with Git for tagging and commits.

🚀 Features
----------

[](#-features)

- Easily update version numbers in `composer.json`
- Automatically commit and tag new versions in Git
- Supports **pre-release versions** (`beta`)
- Compatible with **semantic versioning (SemVer)**

---

📥 Installation
--------------

[](#-installation)

Install the plugin globally or in a specific project:

```
composer require elkadrey/version-bump --dev
```

If using locally, require it as a **path repository**:

```
composer config repositories.version-bump '{"type": "path", "url": "../path-to-plugin"}'
composer require elkadrey/version-bump:dev-main
```

---

🔧 Usage
-------

[](#-usage)

Run the following command to manage versioning:

```
composer version
```

Set a specific version manually:

```
composer version
```

This will set the version in `composer.json` to exactly what `` is.

---

🎯 Available Commands
--------------------

[](#-available-commands)

CommandDescription`prerelease`Only increment beta version (`beta.1` → `beta.2`)`patch`Bump patch version (1.0.0 → 1.0.1)`minor`Bump minor version (1.0.0 → 1.1.0)`major`Bump major version (1.0.0 → 2.0.0)`prepatch`Bump pre-release patch (1.0.0 → 1.0.1-beta.1)`preminor`Bump pre-release minor (1.0.0 → 1.1.0-beta.1)`premajor`Bump pre-release major (1.0.0 → 2.0.0-beta.1)``Set version to ```--show`Show the current version`--no-git`Skip Git commit and tagging---

📌 Examples
----------

[](#-examples)

### 🔹 Standard Version Bumps

[](#-standard-version-bumps)

```
composer version patch      # 1.0.0 → 1.0.1
composer version minor      # 1.0.1 → 1.1.0
composer version major      # 1.1.0 → 2.0.0
```

### 🔹 Pre-release Versioning

[](#-pre-release-versioning)

```
composer version prepatch   # 1.0.0 → 1.0.1-beta.1
composer version preminor   # 1.0.0 → 1.1.0-beta.1
composer version premajor   # 1.0.0 → 2.0.0-beta.1
```

### 🔹 Increment Only Beta Version

[](#-increment-only-beta-version)

```
composer version prerelease  # 1.0.0-beta.1 → 1.0.0-beta.2
```

### 🔹 Set a Specific Version

[](#-set-a-specific-version)

```
composer version 2.1.5  # Sets the version to 2.1.5 in composer.json
```

### 🔹 Skipping Git Operations

[](#-skipping-git-operations)

```
composer version patch --no-git  # Updates version without Git commit/tag
```

---

🛠 Development
-------------

[](#-development)

Clone the repository and install dependencies:

```
git clone https://github.com/elkadrey/version-bump.git
cd version-bump
composer install
```

Test locally using a path repository in another project:

```
composer config repositories.local '{"type": "path", "url": "../version-bump"}'
composer require elkadrey/version-bump:dev-main
```

---

📜 License
---------

[](#-license)

This project is licensed under the **MIT License**.

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance44

Moderate activity, may be stable

Popularity16

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity41

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

Every ~1 days

Total

3

Last Release

444d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/60830f0fe22af89caefe0e8281a537ff84766dd939e7a8e7b436f12e85c2ffa3?d=identicon)[elkadrey](/maintainers/elkadrey)

---

Top Contributors

[![elkadrey](https://avatars.githubusercontent.com/u/2741848?v=4)](https://github.com/elkadrey "elkadrey (12 commits)")

### Embed Badge

![Health badge](/badges/elkadrey-version-bump/health.svg)

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

###  Alternatives

[drupal/core-project-message

Adds a message after Composer installation.

2122.6M172](/packages/drupal-core-project-message)[vaimo/composer-changelogs

Provide information about package changes based on changelog files that are bundled with releases; provide tools for generating documentation files from changelog sources

11150.5k10](/packages/vaimo-composer-changelogs)[drupol/composer-packages

Composer Packages is a Composer plugin for getting information about installed packages in your project.

32274.0k1](/packages/drupol-composer-packages)

PHPackages © 2026

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