PHPackages                             fof/upgrade-advisor - 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. fof/upgrade-advisor

ActiveFlarum-extension[Utility & Helpers](/categories/utility)

fof/upgrade-advisor
===================

Check your forum's readiness for the next Flarum major version

1.x-dev(today)00MITPHPCI passing

Since Jul 1Pushed todayCompare

[ Source](https://github.com/FriendsOfFlarum/upgrade-advisor)[ Packagist](https://packagist.org/packages/fof/upgrade-advisor)[ Fund](https://opencollective.com/fof)[ RSS](/packages/fof-upgrade-advisor/feed)WikiDiscussions 1.x Synced today

READMEChangelog (2)Dependencies (4)Versions (1)Used By (0)

FoF Upgrade Advisor
===================

[](#fof-upgrade-advisor)

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667) [![Latest Stable Version](https://camo.githubusercontent.com/6ffbe87d28ad649aabb4d258da0bec1227101a656f7e2c02a15de4f705e25974/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f666f662f757067726164652d61647669736f722e737667)](https://packagist.org/packages/fof/upgrade-advisor) [![Total Downloads](https://camo.githubusercontent.com/a11b32d451a59307c67453f2792a50c2f24e68f684a88a61700a1d3bfde0bef8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f666f662f757067726164652d61647669736f722e737667)](https://packagist.org/packages/fof/upgrade-advisor)

A [Flarum](https://flarum.org) extension by [FriendsOfFlarum](https://github.com/FriendsOfFlarum). Check your forum's readiness for the next Flarum major version.

Adds an admin page that runs a series of readiness checks for **Flarum 2.0** and shows an overall verdict, so you know what to address before upgrading.

Checks
------

[](#checks)

- **PHP version** — fails below PHP 8.3.
- **Database version** — detects MySQL vs MariaDB and applies two tiers:
    - **Fails** below the version required for JSON column support (MySQL 5.7.8, MariaDB 10.2.7), which Flarum 2.0 relies on.
    - **Warns** below the recommended version (MySQL 8.4, MariaDB 11.8) to encourage staying on a modern, supported release.
- **Extension compatibility** — for every **installed** extension (enabled or disabled — either will block the upgrade), determines whether a Flarum 2.0-compatible release exists. Each extension resolves to one of:
    - **Compatible** — a published release supports `flarum/core ^2.0` (pre-releases count).
    - **Incompatible** — no compatible release yet.
    - **Abandoned** — flagged by Flarum core or its support thread; if a replacement is suggested, its own 2.0 readiness is checked and shown.
    - **Superseded** — functionality is now built into core, or the extension has moved to a different package (curated list).
    - **Could not check** — a premium or private-repository extension that isn't on public Packagist (see below).

Compatibility is determined from **Packagist** and cross-referenced against the extension's official support discussion tags on discuss.flarum.org. For extensions the advisor can't resolve, it surfaces the support thread and author contact links so you can ask the author about their 2.0 plans.

Private & premium repositories
----------------------------------

[](#private--premium-repositories)

Extensions installed from private sources aren't on public Packagist, so the advisor can't check them by default. Under the **Repositories** tab you can add:

- **Floxum** — just paste your access token.
- **Private Packagist / custom Composer repositories** — provide the repository URL, username, and token.

Each repository has a **Test connection** button to verify the credentials before saving. Configured repositories are only queried for extensions that public Packagist can't resolve.

Adding your own checks
----------------------

[](#adding-your-own-checks)

Other extensions can register additional checks via the `Checks` extender in their `extend.php`:

```
use FoF\UpgradeAdvisor\Extend\Checks;

return [
    (new Checks())
        ->add(\Acme\MyExtension\Check\MyCustomCheck::class),
];
```

Each registered class must implement `FoF\UpgradeAdvisor\Check\Check` and is resolved from the container, so it may type-hint any services it needs.

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

[](#installation)

Install with composer:

```
composer require fof/upgrade-advisor:"*"
```

Updating
--------

[](#updating)

```
composer update fof/upgrade-advisor:"*"
php flarum cache:clear
```

Once your forum reports as ready and you've upgraded to Flarum 2.0, this extension has done its job and can be removed.

Links
-----

[](#links)

- [Packagist](https://packagist.org/packages/fof/upgrade-advisor)
- [GitHub](https://github.com/FriendsOfFlarum/upgrade-advisor)
- [Discuss](https://discuss.flarum.org/d/39500)
- [Report an issue](https://github.com/FriendsOfFlarum/upgrade-advisor/issues)

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance100

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity17

Early-stage or recently created project

 Bus Factor1

Top contributor holds 80% 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

Unknown

Total

1

Last Release

0d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/16573496?v=4)[IanM](/maintainers/imorland)[@imorland](https://github.com/imorland)

---

Top Contributors

[![imorland](https://avatars.githubusercontent.com/u/16573496?v=4)](https://github.com/imorland "imorland (4 commits)")[![flarum-bot](https://avatars.githubusercontent.com/u/39334649?v=4)](https://github.com/flarum-bot "flarum-bot (1 commits)")

---

Tags

flarum

### Embed Badge

![Health badge](/badges/fof-upgrade-advisor/health.svg)

```
[![Health](https://phpackages.com/badges/fof-upgrade-advisor/health.svg)](https://phpackages.com/packages/fof-upgrade-advisor)
```

###  Alternatives

[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.7k38.9k](/packages/matomo-matomo)[symfony/asset-mapper

Maps directories of assets & makes them available in a public directory with versioned filenames.

1678.8M229](/packages/symfony-asset-mapper)[flarum-lang/russian

Russian language pack for Flarum.

12128.3k](/packages/flarum-lang-russian)[fof/byobu

Well integrated, advanced private discussions.

59120.6k13](/packages/fof-byobu)[fof/discussion-language

Specify the language a discussion is written in & sort by language

1034.8k4](/packages/fof-discussion-language)[flarum-lang/french

French language pack to localize the Flarum forum software plus its official and third-party extensions.

1938.7k](/packages/flarum-lang-french)

PHPackages © 2026

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