实验性功能
所有 Symfony 功能都受益于我们的 向下兼容性承诺,让开发者有信心安全且更频繁地升级到新版本。
但有时,一项新功能存在争议,或者您找不到令人信服的 API。在这种情况下,我们更倾向于收集来自真实世界使用的反馈,调整 API,或者完全删除它。对于不破坏向下兼容性的方法,这样做是不可能的。
为了避免受限于我们的向下兼容性承诺,这些功能可以标记为实验性,并且它们的类和方法必须使用 @experimental
标签进行标记。
一项功能只能在一个次要版本中标记为实验性,并且永远不能在 LTS 版本 中引入。核心团队可以根据具体情况决定将实验期延长到另一个次要版本。
为了方便升级使用实验性功能的项目,变更日志必须解释不向下兼容的更改,并解释如何升级代码。
本作品,包括代码示例,根据 Creative Commons BY-SA 3.0 许可协议获得许可。