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

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

shalvah/upgrader
================

Create automatic upgrades for your package.

0.6.0(2y ago)1510.9M—5.9%[1 issues](https://github.com/shalvah/upgrader/issues)5MITPHPPHP >=8.0

Since Jul 24Pushed 2y ago1 watchersCompare

[ Source](https://github.com/shalvah/upgrader)[ Packagist](https://packagist.org/packages/shalvah/upgrader)[ Docs](http://github.com/shalvah/upgrader)[ Patreon](https://patreon.com/shalvah)[ RSS](/packages/shalvah-upgrader/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (6)Versions (14)Used By (5)

Upgrader
========

[](#upgrader)

[![Latest Stable Version](https://camo.githubusercontent.com/3fb9321f0f556905116bfb564c91116da976d3a3b95b5c88a4dcf09d20250e92/68747470733a2f2f706f7365722e707567782e6f72672f7368616c7661682f75706772616465722f762f737461626c65)](https://packagist.org/packages/shalvah/upgrader) [![Total Downloads](https://camo.githubusercontent.com/c1d715518b2f0fc940969141c2f934bb37b4fa4bde542fdc026e003c340fa0b4/68747470733a2f2f706f7365722e707567782e6f72672f7368616c7661682f75706772616465722f646f776e6c6f616473)](https://packagist.org/packages/shalvah/upgrader)

Releasing a new version of your PHP library with changes to the config file? Use this tool to offer an automated upgrade process to your users. Used for implementing automated upgrades in [Scribe](https://scribe.knuckles.wtf/laravel/migrating-v4) — just run `php artisan scribe:upgrade`.

Give `Upgrader` a sample of your new config file, and the path to the user's old config file, and it'll figure out what's been added or removed in the new version. You can also tell it to move/rename certain fields or ignore others.

```
// Create a CLI `upgrade` command, where you call Upgrader

// Relative path to the config file in the user's project
$userOldConfigFile = 'config/my_library.php';
// Absolute path to a sample of the new config in your project
$sampleNewConfigFile = __DIR__ . '/../../config/my_library.php';

$upgrader = Upgrader::ofConfigFile($userOldConfigFile, $sampleNewConfigFile)
  ->move('path', 'static.path')
  ->dontTouch('ip_addresses');

   // If this is a dry run, print the expected changes
   if ($this->option('dry-run')) {
     $changes = $upgrader->dryRun();
     if (empty($changes)) {
       $this->info("No changes needed! Looks like you're all set.");
       return;
     }

     $this->info('The following changes will be made to your config file:');

     foreach ($changes as $change) {
       $this->info($change["description"]);
     }

     return;
}

// Otherwise, run the upgrade 🚀
$upgrader->upgrade();
```

Upgrader:

- Comes with "dry run" functionality, so you can review expected changes.
- Will back up the user's old config file to `{$file}.bak` so you can revert if you need to.
- Supports keys as dot notation

Upgrader is still early days (0.x), with more robust features and docs planned. Read how I built it [here](https://blog.shalvah.me/posts/implementing-programmatic-file-transformations-in-php).

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

[](#installation)

PHP 8+ is required.

```
composer require shalvah/upgrader
```

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity53

Moderate usage in the ecosystem

Community16

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 97.6% 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 ~78 days

Recently: every ~132 days

Total

13

Last Release

818d ago

PHP version history (2 changes)0.1.0PHP >=7.4

0.3.0PHP >=8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/ef367e338eb001771b4d439508b7a355d62dc2712ff94017393913e853816abb?d=identicon)[shalvah](/maintainers/shalvah)

---

Top Contributors

[![shalvah](https://avatars.githubusercontent.com/u/14361073?v=4)](https://github.com/shalvah "shalvah (41 commits)")[![negoziator](https://avatars.githubusercontent.com/u/2228675?v=4)](https://github.com/negoziator "negoziator (1 commits)")

---

Tags

upgrade

###  Code Quality

TestsPest

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3274.9M308](/packages/psalm-plugin-laravel)[zidbih/laravel-deadlock

Make temporary Laravel workarounds expire and fail CI when ignored.

961.8k](/packages/zidbih-laravel-deadlock)[sulu/sulu-rector

Rector upgrades rules for Sulu CMS

17334.8k11](/packages/sulu-sulu-rector)[interaction-design-foundation/laravel-geoip

Support for multiple Geographical Location services.

17221.0k3](/packages/interaction-design-foundation-laravel-geoip)[ichhabrecht/core-upgrader

Run upgrade wizards for multiple TYPO3 versions at once

2732.0k](/packages/ichhabrecht-core-upgrader)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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