公告: 旧版文档请移步 -> http://v2.laravel-filament.cn/docs

Languages

Version

Theme

通知生成器

Upgrading from v2.x

如果你发现本指南中有任何遗落,请发起 PR 到官方仓库!

新要求

  • Laravel v10.0+
  • Livewire v3.0+

请在将 Livewire 升级到 v3 前先升级 Filament。如何升级 Livewire 请查看此处

自动升级

升级应用的最简单方式是,运行自动升级脚本。该脚本会自动升级应用到 Filament 的最新版本,并修改你的代码,处理大多数破坏性更新。

composer require filament/upgrade:"^3.2" -W --dev
vendor/bin/filament-v3

请确保仔细按照说明进行操作,并查看脚本所做的更改。之后,你可能需要对代码进行一些手动更改,但脚本应该已经为你处理了大部分重复工作。

最后,必须运行 php artisan filament:install 来完成 Filament v3 的安装。所有新的 Filament 项目都必须运行此命令。

然后,你可以运行 composer remove filament/upgrade,因为你不再需要它了。

你所使用的部分插件可能还没有适配 v3。你可以暂时将其移除出 composer.json 文件中,替换成另一个兼容 v3 的类似插件。或者等到插件更新再升级应用,甚至可以发起 PR 帮助作者升级插件。

手动升级

通过 Composer 升级完依赖后,你应该执行 php artisan filament:upgrade 命令,以清理 Laravel 缓存并发布新的前端资源。

高影响更新

配置文件重命名并与其他 Filament 包合并

现在所有的 Filament 包共有一个配置文件。大部分配置已经转移到代码库的其他位置,只留下了少数。在替换修改过的配置选项时,应该使用 v3 文档作为参考。要发布新配置文件并删除旧配置文件,请运行:

php artisan vendor:publish --tag=filament-config --force
rm config/notifications.php

新增 @filamentScripts@filamentStyles Blade 模板指令

@filamentScripts@filamentStyles 模板指令必须添加到 Blade 布局文件中。由于 Livewire 3 不再使用类似的指令,你可以将 @livewireScripts 替换为 @filamentScripts,将 @livewireStyles 替换为 @filamentStyles

JavaScript 文件移除

你不再需要在 JavaScript 文件中引入 NotificationsAlpinePlugin。Alpine 插件现在由 @filamentScripts 自动加载。

Heroicons 已经升级到 v2

Heroicons 库已经升级到了 v2。也就是说你应用中使用的任何图标都已经改名了。你可以点击此处查看更新列表。

中等影响更新

Secondary 颜色

Filament v2 的 secondary 在许多组件中是灰色。所有 secondary 的引用都应该替换成 gray,以保持相同的外观。这一更新释放了 secondary 使之可以注册成你需要的自定义颜色。

通知 JS 对象

Notification JavaScript 对象现在被重命名为 FilamentNotification,以避免和本机浏览器的 Notification 对象产生冲突。同样,NotificationAction 改名为 FilamentNotificationActionNotificationActionGroup 改名为 FilamentNotificationActionGroup 以保存一致性。

Edit on GitHub

Still need help? Join our Discord community or open a GitHub discussion

上一页
测试