#!/usr/bin/env php
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.

HTML); $isReady = strtolower(trim(ask(<< Are you ready to continue? y/n HTML))) === 'y'; if (! $isReady) { render(<< Aborting upgrade process.

HTML); return; } render(<< Starting upgrade...

HTML); if (file_exists('config/filament-support.php')) { unlink('config/filament-support.php'); render(<< Removed config/filament-support.php. All config files have been merged into config/filament.php.

HTML); } if (file_exists('config/forms.php')) { unlink('config/forms.php'); render(<< Removed config/forms.php. All config files have been merged into config/filament.php.

HTML); } if (file_exists('config/notifications.php')) { unlink('config/notifications.php'); render(<< Removed config/notifications.php. All config files have been merged into config/filament.php.

HTML); } if (file_exists('config/tables.php')) { unlink('config/tables.php'); render(<< Removed config/tables.php. All config files have been merged into config/filament.php.

HTML); } if (InstalledVersions::isInstalled('filament/filament')) { require 'create-filament-v3-panel-provider.php'; render(<< Created a panel provider.

HTML); } $hasIndividualFilamentPackagesInstalled = false; foreach ([ ...glob('resources/css/*.css'), ...glob('resources/css/**/*.css'), ] as $file) { $fileContents = file_get_contents($file); if (str_contains($fileContents, 'filament/forms/dist/module.esm.css')) { $hasIndividualFilamentPackagesInstalled = true; $fileContents = preg_replace('/.*filament\/forms\/dist\/module\.esm\.css.*\n/', '', $fileContents); render(<< Removed path to the form builder CSS file in {$file}.

HTML); } file_put_contents($file, $fileContents); } foreach ([ ...glob('resources/js/*.js'), ...glob('resources/js/**/*.js'), ] as $file) { $fileContents = file_get_contents($file); if ( str_contains($fileContents, 'FormsAlpinePlugin') || str_contains($fileContents, 'NotificationsAlpinePlugin') ) { $hasIndividualFilamentPackagesInstalled = true; render(<< Removed Filament Alpine.js plugins from {$file}.

HTML); } $fileContents = preg_replace('/.*FormsAlpinePlugin.*\n/', '', $fileContents); $fileContents = preg_replace('/.*NotificationsAlpinePlugin.*\n/', '', $fileContents); file_put_contents($file, $fileContents); } if (file_exists('tailwind.config.js')) { $config = file_get_contents('tailwind.config.js'); if (! str_contains($config, 'darkMode')) { $config = str_replace('module.exports = {', "module.exports = {\n darkMode: 'class',", $config); file_put_contents('tailwind.config.js', $config); render(<< Enabled class-based dark mode in tailwind.config.js to prevent potential design inconsistencies.

HTML); } } foreach ([ ...glob('resources/views/*.blade.php'), ...glob('resources/views/**/*.blade.php'), ] as $file) { $fileContents = file_get_contents($file); if (str_contains($fileContents, 'x-filament::page')) { $fileContents = str_replace('x-filament::page', 'x-filament-panels::page', $fileContents); render(<< Replaced with in {$file}.

HTML); } if (str_contains($fileContents, 'x-filament::widget')) { $fileContents = str_replace('x-filament::widget', 'x-filament-widgets::widget', $fileContents); render(<< Replaced with in {$file}.

HTML); } if ($hasIndividualFilamentPackagesInstalled) { if ( str_contains($fileContents, '@livewireScripts') && (! str_contains($fileContents, '@filamentScripts')) ) { $fileContents = str_replace('@livewireScripts', "@filamentScripts", $fileContents); render(<< Replaced @livewireScripts with @filamentScripts in {$file}.

HTML); } if ( str_contains($fileContents, '@livewireStyles') && (! str_contains($fileContents, '@filamentStyles')) ) { $fileContents = str_replace('@livewireStyles', "@filamentStyles", $fileContents); render(<< Replaced @livewireStyles with @filamentStyles in {$file}.

HTML); } } file_put_contents($file, $fileContents); } $getEnvValue = function (string $env, string $variable): ?string { preg_match("/^{$variable}=(.*)$/m", $env, $matches); $value = $matches[1] ?? null; if ($value === null) { return null; } $value = trim($value); if ($value === '') { return null; } return $value; }; $hasEnvVariable = function (string $env, string $variable): bool { return preg_match("/^{$variable}=(.*)$/m", $env) === 1; }; $removeEnvVariable = function (string &$env, string $variable): string { return $env = preg_replace("/^{$variable}=(.*)$/m", '', $env); }; $renameEnvVariable = function (string &$env, string $oldVariable, string $newVariable): string { return $env = preg_replace("/^{$oldVariable}=(.*)$/m", "{$newVariable}=$1", $env); }; $setEnvVariable = function (string &$env, string $variable, string $value): string { return $env = preg_replace("/^{$variable}=(.*)$/m", "{$variable}={$value}", $env); }; foreach (['.env', '.env.ci', '.env.example', '.env.testing'] as $envFile) { if (file_exists($envFile)) { $env = file_get_contents($envFile); $env = (function (string $env) use ($envFile, $getEnvValue, $hasEnvVariable, $removeEnvVariable, $renameEnvVariable, $setEnvVariable) { $disk = $getEnvValue($env, 'FILAMENT_FILESYSTEM_DRIVER') ?? $getEnvValue($env, 'FORMS_FILESYSTEM_DRIVER') ?? $getEnvValue($env, 'TABLES_FILESYSTEM_DRIVER'); if ($disk === null) { $removeEnvVariable($env, 'FILAMENT_FILESYSTEM_DRIVER'); $removeEnvVariable($env, 'FORMS_FILESYSTEM_DRIVER'); $removeEnvVariable($env, 'TABLES_FILESYSTEM_DRIVER'); return $env; } render(<< Replacing Filament FILESYSTEM_DRIVER .env variables with a single FILAMENT_FILESYSTEM_DISK in {$envFile}.

HTML); if ($hasEnvVariable($env, 'FILAMENT_FILESYSTEM_DRIVER')) { $renameEnvVariable($env, 'FILAMENT_FILESYSTEM_DRIVER', 'FILAMENT_FILESYSTEM_DISK'); $setEnvVariable($env, 'FILAMENT_FILESYSTEM_DISK', $disk); $removeEnvVariable($env, 'FORMS_FILESYSTEM_DRIVER'); $removeEnvVariable($env, 'TABLES_FILESYSTEM_DRIVER'); return $env; } if ($hasEnvVariable($env, 'FORMS_FILESYSTEM_DRIVER')) { $renameEnvVariable($env, 'FORMS_FILESYSTEM_DRIVER', 'FILAMENT_FILESYSTEM_DISK'); $setEnvVariable($env, 'FILAMENT_FILESYSTEM_DISK', $disk); $removeEnvVariable($env, 'TABLES_FILESYSTEM_DRIVER'); return $env; } if ($hasEnvVariable($env, 'TABLES_FILESYSTEM_DRIVER')) { $renameEnvVariable($env, 'TABLES_FILESYSTEM_DRIVER', 'FILAMENT_FILESYSTEM_DISK'); $setEnvVariable($env, 'FILAMENT_FILESYSTEM_DISK', $disk); return $env; } return $env; })($env); file_put_contents($envFile, $env); } } if (file_exists('resources/views/vendor/filament/brand.blade.php')) { rename( 'resources/views/vendor/filament/brand.blade.php', 'resources/views/vendor/filament-panels/logo.blade.php', ); render(<< Renamed brand.blade.php to logo.blade.php.

HTML); } $appDirectory = $argv[1] ?? 'app'; render(<< Start processing /{$appDirectory} to fix code affected by breaking changes.

HTML); $rectorScriptPath = implode(DIRECTORY_SEPARATOR, ['vendor', 'bin', 'rector']); exec("{$rectorScriptPath} process {$appDirectory} --config vendor/filament/upgrade/src/rector.php --clear-cache"); render(<< Finished processing /{$appDirectory}.

HTML); $requireCommands = []; foreach (json_decode(file_get_contents('composer.json'), true)['require'] as $package => $version) { if ($package === 'filament/upgrade') { continue; } if (! str_starts_with($package, 'filament/')) { continue; } $requireCommands[] = "composer require {$package}:\"^3.2\" -W --no-update"; } $requireCommands = implode("
", $requireCommands); render(<< Now you're ready to update your Composer dependencies!

First require new versions of Filament packages:
{$requireCommands}

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. HTML);