Filament 3 upgrade problems

[LemonPie22]

Could someone please advise me on how to upgrade from Filament v2 to v3? I'm sure it's something obvious to developers familiar with composer.

My current package versions from about:

  Laravel Version ........................................................................................................................... 9.48.0
  PHP Version ................................................................................................................................ 8.2.5
  Composer Version ........................................................................................................................... 2.5.5

  Filament .........................................................................................................................................
  Packages ......................................................................................... filament, forms, notifications, support, tables
  Version ................................................................................................................................. v2.16.65
  Views ........................................................................................................................ PUBLISHED: filament

My composer.json:

{
    "name": "laravel/laravel",
    "type": "project",
    "description": "The Laravel Framework.",
    "keywords": ["framework", "laravel"],
    "license": "MIT",
    "require": {
        "php": "^8.0.2",
        "filament/filament": "^2.0",
        "guzzlehttp/guzzle": "^7.2",
        "laravel/framework": "^9.19",
        "laravel/sanctum": "^3.0",
        "laravel/tinker": "^2.7",
        "livewire/livewire": "^2.10",
        "owen-it/laravel-auditing": "^13.5",
        "spatie/laravel-permission": "^5.10"
    },
    "require-dev": {
        "doctrine/dbal": "^3.5",
        "fakerphp/faker": "^1.9.1",
        "laravel/pint": "^1.0",
        "laravel/sail": "^1.0.1",
        "mockery/mockery": "^1.4.4",
        "nunomaduro/collision": "^6.1",
        "phpunit/phpunit": "^9.5.10",
        "spatie/laravel-ignition": "^1.0",
        "squizlabs/php_codesniffer": "^3.7"
    },
    "autoload": {
        "psr-4": {
            "App\\": "app/",
            "Database\\Factories\\": "database/factories/",
            "Database\\Seeders\\": "database/seeders/"
        }
    },
    "autoload-dev": {
        "psr-4": {
            "Tests\\": "tests/"
        }
    },
    "scripts": {
        "check-style": "phpcs -p --standard=PSR2 --runtime-set ignore_errors_on_exit 1 --runtime-set ignore_warnings_on_exit 1 app",
        "fix-style": "phpcbf -p --standard=PSR2 --runtime-set ignore_errors_on_exit 1 --runtime-set ignore_warnings_on_exit 1 app",
        "post-autoload-dump": [
            "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",
            "@php artisan package:discover --ansi"
        ],
        "post-update-cmd": [
            "@php artisan vendor:publish --tag=laravel-assets --ansi --force",
            "@php artisan filament:upgrade"
        ],
        "post-root-package-install": [
            "@php -r \"file_exists('.env') || copy('.env.example', '.env');\""
        ],
        "post-create-project-cmd": [
            "@php artisan key:generate --ansi"
        ]
    },
    "extra": {
        "laravel": {
            "dont-discover": []
        }
    },
    "config": {
        "optimize-autoloader": true,
        "preferred-install": "dist",
        "sort-packages": true,
        "allow-plugins": {
            "pestphp/pest-plugin": true
        }
    },
    "minimum-stability": "dev",
    "prefer-stable": true
}

From https://filamentphp.com/docs/3.x/panels/upgrade-guide:

Please upgrade Filament before upgrading to Livewire v3

Okay so I won't upgrade Livewire yet.

Also:

Since Livewire v3 is still in beta, make sure that the minimum-stability in your composer.json is set to dev

Done.

Result of running composer require filament/upgrade:"^3.0-stable" -W --dev:

./composer.json has been updated
Running composer update filament/upgrade --with-all-dependencies
Loading composer repositories with package information
Updating dependencies
Lock file operations: 3 installs, 7 updates, 0 removals
  - Locking filament/upgrade (v3.0.8)
  - Upgrading nunomaduro/termwind (v1.15.0 => v1.15.1)
  - Locking phpstan/phpstan (1.10.27)
  - Locking rector/rector (0.17.10)
  - Upgrading symfony/console (v6.2.3 => v6.3.2)
  - Upgrading symfony/deprecation-contracts (v3.2.0 => v3.3.0)
  - Upgrading symfony/event-dispatcher-contracts (v3.2.0 => v3.3.0)
  - Upgrading symfony/service-contracts (v3.2.0 => v3.3.0)
  - Upgrading symfony/string (v6.2.2 => v6.3.2)
  - Upgrading symfony/translation-contracts (v3.2.0 => v3.3.0)
Writing lock file
Installing dependencies from lock file (including require-dev)
Nothing to install, update or remove
Package league/uri-parser is abandoned, you should avoid using it. No replacement was suggested.
Package tgalopin/html-sanitizer is abandoned, you should avoid using it. Use symfony/html-sanitizer instead.
Generating optimized autoload files
> Illuminate\Foundation\ComposerScripts::postAutoloadDump
> @php artisan package:discover --ansi

   INFO  Discovering packages.

  akaunting/laravel-money ..................................................................................................................... DONE
  blade-ui-kit/blade-heroicons ................................................................................................................ DONE
  blade-ui-kit/blade-icons .................................................................................................................... DONE
  filament/filament ........................................................................................................................... DONE
  filament/forms .............................................................................................................................. DONE
  filament/notifications ...................................................................................................................... DONE
  filament/support ............................................................................................................................ DONE
  filament/tables ............................................................................................................................. DONE
  laravel/sail ................................................................................................................................ DONE
  laravel/sanctum ............................................................................................................................. DONE
  laravel/tinker .............................................................................................................................. DONE
  livewire/livewire ........................................................................................................................... DONE
  nesbot/carbon ............................................................................................................................... DONE
  nunomaduro/collision ........................................................................................................................ DONE
  nunomaduro/termwind ......................................................................................................................... DONE
  owen-it/laravel-auditing .................................................................................................................... DONE
  ryangjchandler/blade-capture-directive ...................................................................................................... DONE
  spatie/laravel-ignition ..................................................................................................................... DONE
  spatie/laravel-permission ................................................................................................................... DONE

94 packages you are using are looking for funding.
Use the `composer fund` command to find out more!
> @php artisan vendor:publish --tag=laravel-assets --ansi --force

   INFO  No publishable resources for tag [laravel-assets].

> @php artisan filament:upgrade

   INFO  Configuration cache cleared successfully.

Livewire auto-discovery manifest rebuilt!
   INFO  Route cache cleared successfully.

   INFO  Compiled views cleared successfully.

Successfully upgraded!
Found 2 security vulnerability advisories affecting 2 packages.
Run composer audit for a full list of advisories.

Looks good so far.

Running vendor/bin/filament-v3:

   Filament v3 Upgrade


Welcome to the Filament v3 upgrade process!
This script will attempt to handle most of the breaking changes for you.
If you have any questions, please reach out to us on Discord or GitHub.

To begin, please ensure that you are using a version control system such as Git.
We will make changes directly to your files, and you will need to be able to revert them if something goes wrong.
Please commit any changes you have made to your project before continuing.

Are you ready to continue? y/n y

Starting upgrade...


Created a panel provider.


Start processing /app to fix code affected by breaking changes.

 211/211 [▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓] 100%

Finished processing /app.

Now you're ready to update your Composer dependencies!

First require new versions of Filament packages:
composer require filament/filament:"^3.0-stable" -W --no-update

If you have any 3rd party plugins that need to be upgraded, you should bump those dependencies as well.

And then run:
composer update

If you have any questions, please reach out to us on Discord or GitHub.

So I did composer require filament/filament:"^3.0-stable" -W --no-update and got ./composer.json has been updated.

Then I did composer update and got:

Loading composer repositories with package information
Updating dependencies
Your requirements could not be resolved to an installable set of packages.

  Problem 1
    - filament/filament 3.x-dev requires filament/support 3.x-dev -> satisfiable by filament/support[3.x-dev].
    - filament/filament v3.0.0 requires filament/support v3.0.0 -> satisfiable by filament/support[v3.0.0].
    - filament/filament v3.0.1 requires filament/support v3.0.1 -> satisfiable by filament/support[v3.0.1].
    - filament/filament v3.0.2 requires filament/support v3.0.2 -> satisfiable by filament/support[v3.0.2].
    - filament/filament v3.0.3 requires filament/support v3.0.3 -> satisfiable by filament/support[v3.0.3].
    - filament/filament v3.0.4 requires filament/support v3.0.4 -> satisfiable by filament/support[v3.0.4].
    - filament/filament v3.0.5 requires filament/support v3.0.5 -> satisfiable by filament/support[v3.0.5].
    - filament/filament v3.0.6 requires filament/support v3.0.6 -> satisfiable by filament/support[v3.0.6].
    - filament/filament v3.0.7 requires filament/support v3.0.7 -> satisfiable by filament/support[v3.0.7].
    - filament/filament v3.0.8 requires filament/support v3.0.8 -> satisfiable by filament/support[v3.0.8].
    - filament/support[v3.0.0, ..., 3.x-dev] require livewire/livewire ^3.0 -> found livewire/livewire[v3.0.0-beta.1, ..., v3.0.0-beta.7] but it conflicts with your root composer.json require (^2.10).
    - Root composer.json requires filament/filament ^3.0-stable -> satisfiable by filament/filament[v3.0.0, ..., 3.x-dev].

Use the option --with-all-dependencies (-W) to allow upgrades, downgrades and removals for packages currently locked to specific versions.

Presumably this is because I haven't upgraded Livewire yet.

Trying composer require livewire/livewire "^3.0@beta":

./composer.json has been updated
Running composer update livewire/livewire
Loading composer repositories with package information
Updating dependencies
Your requirements could not be resolved to an installable set of packages.

  Problem 1
    - Root composer.json requires filament/filament ^3.0-stable, found filament/filament[v3.0.0, ..., 3.x-dev] but the package is fixed to v2.16.65 (lock file version) by a partial update and that version does not match. Make sure you list it as an argument for the update command.
  Problem 2
    - Root composer.json requires livewire/livewire ^3.0@beta, found livewire/livewire[v3.0.0-beta.1, ..., v3.0.0-beta.7] but these were not loaded, likely because it conflicts with another require.

Use the option --with-all-dependencies (-W) to allow upgrades, downgrades and removals for packages currently locked to specific versions.

Installation failed, reverting ./composer.json and ./composer.lock to their original content.

I tried with -W but got the same result.

My composer.json:

{
    "name": "laravel/laravel",
    "type": "project",
    "description": "The Laravel Framework.",
    "keywords": ["framework", "laravel"],
    "license": "MIT",
    "require": {
        "php": "^8.0.2",
        "filament/filament": "^3.0-stable",
        "guzzlehttp/guzzle": "^7.2",
        "laravel/framework": "^9.19",
        "laravel/sanctum": "^3.0",
        "laravel/tinker": "^2.7",
        "livewire/livewire": "^2.10",
        "owen-it/laravel-auditing": "^13.5",
        "spatie/laravel-permission": "^5.10"
    },
    "require-dev": {
        "doctrine/dbal": "^3.5",
        "fakerphp/faker": "^1.9.1",
        "filament/upgrade": "^3.0-stable",
        "laravel/pint": "^1.0",
        "laravel/sail": "^1.0.1",
        "mockery/mockery": "^1.4.4",
        "nunomaduro/collision": "^6.1",
        "phpunit/phpunit": "^9.5.10",
        "spatie/laravel-ignition": "^1.0",
        "squizlabs/php_codesniffer": "^3.7"
    },
    "autoload": {
        "psr-4": {
            "App\\": "app/",
            "Database\\Factories\\": "database/factories/",
            "Database\\Seeders\\": "database/seeders/"
        }
    },
    "autoload-dev": {
        "psr-4": {
            "Tests\\": "tests/"
        }
    },
    "scripts": {
        "check-style": "phpcs -p --standard=PSR2 --runtime-set ignore_errors_on_exit 1 --runtime-set ignore_warnings_on_exit 1 app",
        "fix-style": "phpcbf -p --standard=PSR2 --runtime-set ignore_errors_on_exit 1 --runtime-set ignore_warnings_on_exit 1 app",
        "post-autoload-dump": [
            "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",
            "@php artisan package:discover --ansi"
        ],
        "post-update-cmd": [
            "@php artisan vendor:publish --tag=laravel-assets --ansi --force",
            "@php artisan filament:upgrade"
        ],
        "post-root-package-install": [
            "@php -r \"file_exists('.env') || copy('.env.example', '.env');\""
        ],
        "post-create-project-cmd": [
            "@php artisan key:generate --ansi"
        ]
    },
    "extra": {
        "laravel": {
            "dont-discover": []
        }
    },
    "config": {
        "optimize-autoloader": true,
        "preferred-install": "dist",
        "sort-packages": true,
        "allow-plugins": {
            "pestphp/pest-plugin": true
        }
    },
    "minimum-stability": "dev",
    "prefer-stable": true

My composer.lock file contains the following:

        {
            "name": "filament/filament",
            "version": "v2.16.65",
            "source": {
                "type": "git",
                "url": "https://github.com/filamentphp/app.git",
                "reference": "33ec5ec9e0de985ede18f575663077fc6f214b23"
            },
            "dist": {
                "type": "zip",
                "url": "https://api.github.com/repos/filamentphp/app/zipball/33ec5ec9e0de985ede18f575663077fc6f214b23",
                "reference": "33ec5ec9e0de985ede18f575663077fc6f214b23",
                "shasum": ""
            },
            "require": {
                "danharrin/livewire-rate-limiting": "^0.3|^1.0",
                "filament/forms": "self.version",
                "filament/notifications": "self.version",
                "filament/support": "self.version",
                "filament/tables": "self.version",
                "illuminate/auth": "^8.6|^9.0",
                "illuminate/console": "^8.6|^9.0",
                "illuminate/contracts": "^8.6|^9.0",
                "illuminate/cookie": "^8.6|^9.0",
                "illuminate/database": "^8.6|^9.0",
                "illuminate/http": "^8.6|^9.0",
                "illuminate/routing": "^8.6|^9.0",
                "illuminate/session": "^8.6|^9.0",
                "illuminate/support": "^8.6|^9.0",
                "illuminate/view": "^8.6|^9.0",
                "livewire/livewire": "^2.10.7",
                "php": "^8.0",
                "ryangjchandler/blade-capture-directive": "^0.2",
                "spatie/laravel-package-tools": "^1.9"
            },

[danharrin]

Remove Livewire as a dependency, Filament installs it for you. Then update Filament. You can require it again after if you want.

[LemonPie22]

Thank you @danharrin. That fixed it.

[awantahir]

Hi, I am getting kind of same error. Where did you remove the dependency?

[sc-hero]

@LemonPie22 , Let me know how you upgrade about above issue?

[LemonPie22]

It's been a while since I did this but, from what I remember, try removing the last line below from composer.json:

"require": {
    "php": "^8.0.2",
    "filament/filament": "^2.0",
    "guzzlehttp/guzzle": "^7.2",
    "laravel/framework": "^9.19",
    "laravel/sanctum": "^3.0",
    "laravel/tinker": "^2.7",
    "livewire/livewire": "^2.10",

[jonnott]

@danharrin When I upgrade from v2 to v3, I have public/css/filament and public/js/filament dirs which I didn't have before, with quite a few files in each. Do I .gitignore these, or commit them into my project repo? Upgrade docs mention nothing about this, I don't think..

[danharrin]

You can do either. If you don't want to commit them, you don't have to, they get published each time you Composer install.

[jonnott]

Would they get created on installation of Filament v3 in a fresh project then?

Also, what would cause me to want to change from ignoring them to tracking them - creating a custom component or adding third-party components with customisations?

[danharrin]

Third parties registering assets hook into the same publishing system so it should work flawlessly. It's just personal preference