PHPackages                             anil/uplift - 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. [Database &amp; ORM](/categories/database)
4. /
5. anil/uplift

ActiveLibrary[Database &amp; ORM](/categories/database)

anil/uplift
===========

Uplift — a free, open-source Laravel upgrader and dependency updater. Steps a Laravel app up to the latest version one release at a time (Rector-powered, one clean git commit per step), and checks any Composer project's dependencies for newer releases, rewriting the constraints on demand.

v0.1.1(1mo ago)031MITPHPPHP &gt;=8.2CI passing

Since Jul 14Pushed 1mo agoCompare

[ Source](https://github.com/anilkumarthakur60/uplift)[ Packagist](https://packagist.org/packages/anil/uplift)[ Docs](https://github.com/anilkumarthakur60/uplift)[ RSS](/packages/anil-uplift/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (2)Dependencies (14)Versions (3)Used By (0)

Uplift
======

[](#uplift)

[![CI](https://github.com/anilkumarthakur60/uplift/actions/workflows/ci.yml/badge.svg)](https://github.com/anilkumarthakur60/uplift/actions/workflows/ci.yml)[![Latest Stable Version](https://camo.githubusercontent.com/b03c0c3035b220f3ab116806679c31022951825047bc414b130683705124010a/68747470733a2f2f706f7365722e707567782e6f72672f616e696c2f75706c6966742f76)](https://packagist.org/packages/anil/uplift)[![License](https://camo.githubusercontent.com/6efacb8dd03cdc6405c7050d7deb60ae35e2e880d0c485cb39d2397eda3184d5/68747470733a2f2f706f7365722e707567782e6f72672f616e696c2f75706c6966742f6c6963656e7365)](https://packagist.org/packages/anil/uplift)

Two upgrade tools in one small CLI:

1. **`uplift upgrade`** — a free, open-source Laravel upgrader. Steps your app up to the latest version one release at a time, with automated code changes and a clean, reviewable commit per step.
2. **`uplift deps`** — a dependency updater for **any** PHP project. Checks every dependency for releases newer than your constraints allow, and rewrites `composer.json` when you ask it to.

> Repo: `github.com/anilkumarthakur60/uplift` · Packagist: `anil/uplift`

`uplift upgrade` — the Laravel upgrader
---------------------------------------

[](#uplift-upgrade--the-laravel-upgrader)

It steps a Laravel application up to the latest version **one release at a time**, and for each hop it:

1. **Bumps the right Composer constraints** — `laravel/framework` plus the first-party packages you actually use (Sanctum, Passport, Horizon, Telescope, Scout, Pint, Pest, …), and removes packages that have been folded into the framework.
2. **Runs `composer update`** to resolve the new dependency tree.
3. **Applies automated code changes** via [Rector](https://getrector.com/) + the community [rector-laravel](https://github.com/driftingly/rector-laravel) upgrade sets.
4. **Prints a manual checklist** pulled **live** from the official `https://laravel.com/docs/{version}.x/upgrade` guide, plus curated notes for the things automation can't safely do.
5. **Commits the result** — one clean, reviewable commit per version (e.g. `Upgrade Laravel 9.x to 10.x`).

So a 9 → 13 upgrade lands as four separate, reviewable commits on a dedicated branch.

> ⚠️ **It does what can be automated — not everything.** No tool can fully upgrade an arbitrary app. Always review each commit, work through the printed checklist, and run your test suite before merging.

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

[](#installation)

Install it globally so you can point it at any project:

```
composer global require anil/uplift
```

Make sure your global Composer `bin` directory is on your `PATH` (e.g. `~/.composer/vendor/bin` or `~/.config/composer/vendor/bin`).

Or run it from source:

```
git clone https://github.com/anilkumarthakur60/uplift.git
cd uplift
composer install
./bin/uplift --help
```

Usage
-----

[](#usage)

From inside your Laravel project (or by passing its path):

```
# See what would happen — detects your version and prints the plan
uplift diagnose

# Preview the changes without touching anything
uplift upgrade --dry-run

# Do the upgrade, all the way to the latest known version
uplift upgrade

# Upgrade only as far as a specific version
uplift upgrade --to=11

# Point at a project elsewhere
uplift upgrade /path/to/app
```

### Useful options

[](#useful-options)

OptionWhat it does`--to=N`Stop at major version `N` (default: latest known)`--dry-run`Show the plan and run Rector in preview mode; write nothing`--no-git`Don't branch or commit; leave changes in the working tree`--branch=NAME`Name of the branch to create (default: `uplift/-to-`)`--allow-dirty`Proceed even with uncommitted changes`--skip-composer`Edit `composer.json` but don't run `composer update``--skip-rector`Skip the automated code transformations`-y, --yes`Don't ask for confirmation`uplift deps` — the dependency updater
--------------------------------------

[](#uplift-deps--the-dependency-updater)

`composer outdated` tells you what's stale, but leaves your constraints alone. `uplift deps` goes the rest of the way — it finds the newest release of every dependency **beyond** what your current constraints allow, shows you the jump, and rewrites `composer.json` when you pass `-u`. It works on any Composer project, Laravel or not.

```
cd your-project

# Report what could move (writes nothing)
uplift deps

 require
   laravel/framework          ^10.0   →  ^12.63   major · latest v13.19.0 needs php ^8.3
   spatie/laravel-permission  ^5.5    →  ^6.25    major
   inertiajs/inertia-laravel  ^0.6.3  →  ^3.1.1   major
 require-dev
   phpunit/phpunit            ^9.5    →  ^11.5    major
   laravel/pint               1.13.0  →  1.29.3   minor

 ⚠ swiftmailer/swiftmailer is abandoned — consider symfony/mailer instead.

# Write the new constraints, then install them
uplift deps -u
composer update
```

What it gets right:

- **Constraint style is preserved** — `^1.2` becomes `^2.4`, `~1.2.3` becomes `~2.4.1`, `1.2.*` becomes `2.4.*`, exact pins stay exact pins, `v`-prefixes and `@stability` flags survive. OR-ranges, hyphen ranges and `dev-*` branches are never guessed at; they're listed as skipped instead.
- **PHP-aware** — it only proposes releases your platform PHP can actually install (respecting `config.platform.php`), and tells you when something newer is held back by its PHP requirement. `--ignore-platform-reqs` turns this off.
- **Stable releases only** — alphas, betas and RCs are ignored.
- **Abandoned packages are flagged**, with Packagist's suggested replacement — even when the version itself is "up to date".
- **Fast** — all Packagist lookups run concurrently.

OptionWhat it does`-u, --upgrade`Rewrite `composer.json` (default: just report)`-t, --target=latest|minor|patch`How far to move: newest overall, newest on the current major, or newest on the current minor`-f, --filter=GLOB`Only check matching packages (e.g. `-f 'symfony/*'`, repeatable)`-x, --reject=GLOB`Never touch matching packages`--dep=all|prod|dev`Limit to `require` / `require-dev``--ignore-platform-reqs`Propose releases even if they need a newer PHP`--json`Print only the proposed constraints, as JSON`--fail-on-outdated`Exit 1 when updates exist — a one-line CI freshness gateHow the Laravel upgrader works
------------------------------

[](#how-the-laravel-upgrader-works)

The upgrade knowledge lives as plain data in [`src/Laravel/VersionRegistry.php`](src/Laravel/VersionRegistry.php) — one `UpgradeStep` per release hop describing the PHP requirement, the package constraints to set, packages to remove, and which Rector sets to run. This makes it easy to keep current with new Laravel releases: add a step, ship a release.

The tool runs against a **clean git working tree** and creates a dedicated branch, so the upgrade is always easy to review or throw away.

Requirements
------------

[](#requirements)

- PHP 8.2+ (to run the tool itself — your target app can be older)
- Composer 2 on your `PATH`
- Git (only used by `uplift upgrade`, and skippable with `--no-git`)

Contributing
------------

[](#contributing)

The most valuable contributions are keeping the version registry accurate and extending the Rector coverage. PRs welcome.

License
-------

[](#license)

MIT.

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance90

Actively maintained with recent releases

Popularity10

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

 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

47d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/16583802?v=4)[Er. Anil Kumar Thakur](/maintainers/anilkumarthakur60)[@anilkumarthakur60](https://github.com/anilkumarthakur60)

---

Top Contributors

[![anilkumarthakur60](https://avatars.githubusercontent.com/u/16583802?v=4)](https://github.com/anilkumarthakur60 "anilkumarthakur60 (16 commits)")

---

Tags

composerclilaravelmigrationupgradedependenciesrectoroutdatedcheck-updates

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/anil-uplift/health.svg)

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

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.7M3.5k](/packages/craftcms-cms)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

605.9M716](/packages/shopware-core)[shopware/platform

The Shopware e-commerce core

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

Core framework that implements the functionality of the Sulu content management system

1.4k1.4M241](/packages/sulu-sulu)[composer/composer

Composer helps you declare, manage and install dependencies of PHP projects. It ensures you have the right stack everywhere.

29.6k203.2M3.5k](/packages/composer-composer)[contao/core-bundle

Contao Open Source CMS

1231.7M3.2k](/packages/contao-core-bundle)

PHPackages © 2026

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