Filament 中文文档

主题

全部文档

升级指南 ​

INFO

若发现本指南有遗漏，欢迎向我们的仓库提交 pull request！任何帮助都非常感谢！

新要求 ​

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

运行自动升级脚本 ​

INFO

你使用的部分插件可能尚未提供 v5 版本。可暂时从 composer.json 中移除它们，等升级后再加回；也可换成兼容 v5 的类似插件；或先等插件升级再升级应用；甚至可以写 PR 帮助作者完成升级。

升级 Filament 应用的第一步是运行自动升级脚本。该脚本会将应用升级到最新版 Filament，并对代码进行修改以处理破坏性变更：

bash
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

WARNING

在 Windows PowerShell 中安装 Filament 时，可能需要运行下面的命令，因为它会忽略版本约束中的 ^ 字符：

bash
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 --dev，因为已不再需要它。

升级 Livewire ​

Filament v5 需要 Livewire v4.0+。可按 Livewire 升级指南 升级你的 Livewire 代码。