发行说明
版本方案
Waplar 及其第一方包遵循 语义化版本 控制。主要版本每年发布一次(约第一季度),次要版本每月发布一次(1号至5号之间),补丁版本每周发布一次(根据 Issue
和实际情 况决定),次要版本和补丁版本不会存在 重大更改 (无法向下兼容的情况)。
从应用程序或包中引入 Waplar 或组件时,应始终使用版本约束(例如)^1.0.0-alpha
或是 ^1.x
,因为 Waplar 的主要版本确实包含重大更改。但是,我们始终努力确保您可以第一时间内更新到 最新的主要版本。
命名参数
命名参数 不在 Waplar 的向后兼容性指南的范围内。我们可能会在必要时选择重命名函数参数,以改进 Waplar 代码库。因此,在调用 Waplar 方法时使用命名参数应该谨慎进行,并了解参数名称将来可能会更改。
实验性
在次要版本及补丁版本中我们会加入一些实验性功能并在文档中标记,当三性(可用性、可靠性、可维护性 )符合时会正式纳入主要版本,如果在当前版本生命周期内无法保证三性将会考虑在下一个主要版本移除。
弃用 & 改进 & 向下兼容
在每个主要版本的生命周期末的最后一个季度会公示下一个主要版本选择弃用的功能,并在下一个主要版本彻底移除。如果仅是对该功能的改进,则会在次要版本中使用全新的命名以兼容原有的功能,改进后的功能会被标记为实验性,并在下一个主要版本加入。
支持策略
对于所有 Waplar 版本,bug
修复提供 12 个月,安全修复提供 18 个月。Waplar 及其第一方包只有最新版本会承诺 bug
修复,此外,请注意 Laravel 能够支持的数据库版本。
版本 | PHP(^) | Laravel(~) | 发布 | 错误修复截止日期 | 安全修复截止日期 |
---|---|---|---|---|---|
alpha | 8.2.x | 11.x | - | - | - |
(^) 支持的 PHP 版本, (~) 支持的 Laravel 版本