PHPackages                             magicoli/php-bump-library - 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. magicoli/php-bump-library

ActiveLibrary[Utility & Helpers](/categories/utility)

magicoli/php-bump-library
=========================

PHP Library for Project Version Management

v1.0.2(2y ago)01242AGPL-3.0-or-laterPHP

Since Jul 21Pushed 2y ago1 watchersCompare

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

READMEChangelogDependencies (1)Versions (3)Used By (2)

PHP Library for Project Version Management
==========================================

[](#php-library-for-project-version-management)

[![Version](https://camo.githubusercontent.com/070fc7f3c18c50a1e5ff20c54ecbc96804957d50db4eaf742327ffe13c88438d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f56657273696f6e2d312e302e322d626c75652e737667)](#) [![Stable](https://camo.githubusercontent.com/03755684a31c657e1396b8fc257633b26fc3e564f77f220f71ea52e636821dfd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f537461626c652d312e302e322d677265656e2e737667)](#) [![License](https://camo.githubusercontent.com/532d3a592c24cb5ee21d5b278312b82f01e0fdb23bfe5a5c31213170140712e7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4147504c76332d707572706c652e737667)](#)

This library provides tasks for automating versioning of your PHP projects.

It allows you to increment the version based on different levels (major, minor, patch, dev, beta, rc), and update version references in various files such as PHP files, README.md, package.json, and readme.txt.

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

[](#installation)

Run the following command in your project directory:

```
composer require --dev magicoli/php-bump-library
```

And add the following script to your `composer.json` file:

```
 "scripts": {
    "bump-version": "robo --load-from=vendor/magicoli/php-bump-library/RoboFile.php bump:version"
  }
```

Usage
-----

[](#usage)

```
composer bump-version [level]
```

Replace `[level]` with the desired level of version increment, such as `major`, `minor`, `patch`, `rc`, `beta`, or `dev`. If you ommit it, the default level is `patch`.

Alternatively, you can run the script directly with the following command:

```
robo bump:version
# or
robo --load-from=path/to/RoboFile.php bump:version
```

Make sure to adjust RoboFile.php to the actual path of the file in your project.

About Versioning
----------------

[](#about-versioning)

Semantic Versioning follows a specific order of version increments:

Development stages (M.m.p-stage):

- Dev: development versions that are not yet stable or released.
- Beta: pre-release versions that are closer to the stable release but may still have minor issues.
- RC: release candidates, which are close to the final release but may require additional testing.

Releases (M.m.p):

- Patch: backward-compatible bug fixes.
- Minor: added functionality, still backward-compatible manner.
- Major: big bada boom.

Note that `dev`, `beta`, and `rc` versions are considered inferior to the normal versions and are typically used in pre-release stages or development cycles: `1.0-dev` < `1.0-beta` < `1.0-rc` < `1.0`.

For example, if your version is `1.0.0` and you bump it on the `dev` level, new version will be `1.0.1-dev` (note the pach increment). If you bump the `dev` to `beta`, it will keep its main version and become `1.0.1-beta`. And if you bump `1.0.1-beta` without arguments, the new version will be `1.0.1`.

License
-------

[](#license)

This library is licensed under the AGPL-v3 License.

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity45

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 ~0 days

Total

2

Last Release

1033d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/483a1b76001365f5fc14e42fda28cde69af374ac7d341ed3999664218bc16072?d=identicon)[magicoli](/maintainers/magicoli)

---

Top Contributors

[![magicoli](https://avatars.githubusercontent.com/u/1338897?v=4)](https://github.com/magicoli "magicoli (9 commits)")

### Embed Badge

![Health badge](/badges/magicoli-php-bump-library/health.svg)

```
[![Health](https://phpackages.com/badges/magicoli-php-bump-library/health.svg)](https://phpackages.com/packages/magicoli-php-bump-library)
```

###  Alternatives

[ec-europa/toolkit

Toolkit packaged for Drupal projects based on Robo.

38244.6k16](/packages/ec-europa-toolkit)[globalis/robo-task

Robo task common collection

1225.4k2](/packages/globalis-robo-task)

PHPackages © 2026

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