跳到内容

实验性功能

编辑此页

所有 Symfony 功能都受益于我们的 向下兼容性承诺,让开发者有信心安全且更频繁地升级到新版本。

但有时,一项新功能存在争议,或者您找不到令人信服的 API。在这种情况下,我们更倾向于收集来自真实世界使用的反馈,调整 API,或者完全删除它。对于不破坏向下兼容性的方法,这样做是不可能的。

为了避免受限于我们的向下兼容性承诺,这些功能可以标记为实验性,并且它们的类和方法必须使用 @experimental 标签进行标记。

一项功能只能在一个次要版本中标记为实验性,并且永远不能在 LTS 版本 中引入。核心团队可以根据具体情况决定将实验期延长到另一个次要版本。

为了方便升级使用实验性功能的项目,变更日志必须解释不向下兼容的更改,并解释如何升级代码。

本作品,包括代码示例,根据 Creative Commons BY-SA 3.0 许可协议获得许可。
目录
    版本