Flarum 0.1.0-Beta.16升级1.0.0正式版

Flarum 0.1.0-Beta.16升级1.0.0正式版

💡 原文中文,约1900字,阅读约需5分钟。
📝

内容提要

Flarum 发布 1.0 正式版,历经七年、16 个测试版和百余名贡献者,并成立基金会保障开源发展。作者分享从 Beta.16 升级到 1.0 的步骤:卸载不兼容扩展、修改 composer.json、运行 composer update 及迁移缓存命令。新版带来用户 slug、强化标头、可扩展用户列表、新提及系统、性能与无障碍改进等。

🔎

延伸解读

升级前的兼容性检查

文章强调升级前需用 composer why-not flarum/core v1.0.2 查询不兼容扩展,并卸载它们。这提醒读者,扩展生态的兼容性是升级成败的关键,盲目升级可能导致论坛功能异常。建议在操作前备份数据,并逐一确认扩展的兼容状态。

配置文件修改要点

升级步骤包括修改 composer.json:将扩展版本约束从 ^0.1.0 改为 *,将 flarum/core 改为 ^1.0,并删除 minimum-stability 行。这些改动是为了让 Composer 能拉取到 1.0 正式版及其兼容扩展。读者需注意,直接修改版本约束可能引入不兼容的扩展更新,应结合扩展兼容性列表操作。

1.0 版本的主要改进

Flarum 1.0 引入了用户 slug、强化标头、可扩展用户列表、新提及系统、性能与无障碍改进等。这些变化不仅提升用户体验,也影响扩展开发。例如,用户 slug 可能改变 URL 结构,提及系统分离用户名可能影响通知逻辑。升级后需检查相关功能是否正常。

升级后的必要命令

运行 composer update 后,还需执行 php flarum migrate 和 php flarum cache:clear。迁移命令用于更新数据库结构,缓存清理确保新代码生效。文章提到资产发布已分离为 assets:publish,若遇到静态资源问题,可能需要单独运行该命令。

❓

Q&A

Flarum 1.0 正式版是什么时候发布的?

Flarum 1.0 正式版于 2021 年发布,具体日期文章未明确,但作者在 2021 年 6 月 14 日撰写升级文章时提到距离发布已过去半个月。

从 Flarum Beta.16 升级到 1.0 需要哪些步骤?

升级步骤包括:1. 使用 composer why-not flarum/core v1.0.2 查询不兼容扩展并卸载;2. 修改 composer.json,将扩展版本改为 *,flarum/core 改为 ^1.0,删除 minimum-stability 行;3. 删除 composer.lock,运行 composer update --prefer-dist --no-plugins --no-dev -a --with-all-dependencies;4. 执行 php flarum migrate 和 php flarum cache:clear。

Flarum 1.0 有哪些主要新特性?

主要新特性包括:引入用户 ID 的新用户 slug 驱动程序、强化标头、可扩展的用户列表、新的提及系统、规范 URL 生成改进、性能改进、可访问性改进、ICU 格式翻译、推送器扩展支持非公开讨论实时更新、资产发布与 migrate 命令分离、修复搜索讨论标题等。

Flarum 基金会是什么时候成立的?它的作用是什么?

Flarum 基金会成立于 2019 年,旨在保护 Flarum 作为免费和开源产品的未来。

升级 Flarum 时如何检查不兼容的扩展?

可以使用命令 composer why-not flarum/core v1.0.2 查询有哪些扩展不兼容,然后卸载它们。也可以到 Extiverse 查看不兼容的扩展列表。

Flarum 1.0 在性能方面有哪些改进?

Flarum 1.0 对许多核心和捆绑扩展进行了性能改进,包括标签扩展。

🏷️

标签

➡️

继续阅读