DOCS
DOCS

Languages

Version

Theme

升级指南

NOTE

如果你发现该指南中有任何缺失，可以发送 PR 到 Filament 仓库。

新要求

  • Laravel v11.28+
  • Livewire v4.0+
  • Tailwind CSS v4.0+

运行自动升级脚本

NOTE

有些插件可能还不支持 v5。你可以将这些插件暂时移除 composer.json 文件，等到它们升级完成再重新装上，或者替换成兼容 v5 的其他同类插件。甚至可以发送 PR 帮助作者完成升级。

首先是运行自动升级脚本。该脚本将自动将你的应用升级到最新版的 Filament 应用，并修改你的代码、处理大部分破坏性更新：

composer require filament/upgrade:"^5.0" -W --dev

vendor/bin/filament-v5

# Run the commands output by the upgrade script, they are unique to your app
composer require filament/filament:"^5.0" -W --no-update
composer update

NOTE

当使用 Windows PowerShell 来安装 Filament 时，你可能需要运行如下命令，由于它在版本约束中忽视了 ^ 字符：

composer require filament/upgrade:"~5.0" -W --dev

vendor/bin/filament-v5

# Run the commands output by the upgrade script, they are unique to your app
composer require filament/filament:"~5.0" -W --no-update
composer update

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

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

升级 Livewire

Filament v5 使用 Livewire v4.0+。请遵循 Livewire 升级指南升级你的 Livewire 代码

Edit on GitHub

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

Your logo here? 💖