从 v2.x 升级
如果你发现本指南中有任何遗落,请发起 PR 到官方仓库!
新的要求
- Laravel v10.0+
- Livewire v3.0+
请在将 Livewire 升级到 v3 前先升级 Filament。如何升级 Livewire 请查看此处。
Livewire v3 最近发布了!
Livewire 团队在使其稳定方面做得很好,不过它是完全重写 Livewire v2。你可能会碰到问题,因此,我们建议在将 Filament v3 使用到生产环境之前对应用进行全面的测试 。
自动升级
升级应用的最简单方式是,运行自动升级脚本。该脚本会自动升级应用到 Filament 的最新版本,并修改你的代码,处理大多数破坏性更新。
composer require filament/upgrade:"^3.2" -W --dev
vendor/bin/filament-v3
请确保仔细按照说明进行操作,并查看脚本所做的更改。之后,你可能需要对代码进行一些手动更改,但脚本应该已经为你处理了大部分重复工作。
此时,创建了一个新文件 app/Providers/Filament/*PanelProvider.php
,旧的 config/filament.php
配置文件中的配置项复制过去。由于新配置文件是 Laravel 服务提供者,需要将其注册到 config/app.php
中。Filament 回尝试为你进行注册,不过如果你访问面板出错了,那么可能这一个过程失败了。你可以将其添加到 providers
数组手动注册。
最后,你必须运行 php artisan filament:install
来完成 Filament v3 的安装。所有新的 Filament 项目都必须运行此命令。
然后,你可以运行 composer remove filament/upgrade
,因为你不再需要它了。
你所使用的部分插件可能还没有适配 v3。你可以暂时将其移除出
composer.json
文件中,替换成另一个兼容 v3 的类似插件。或者等到插件更新再升级应用,甚至可以发起 PR 帮助作者升级插件。
手动升级
通过 Composer 升级依赖后,你应该执行 php artisan filament:upgrade
命令,以清理 Laravel 缓存并发布新的前端资源。