维护

编辑该页面

警告:你浏览的文档欧宝体育电话欧宝娱乐app下载地址Symfony 2.3,不再维护。

这个页面的更新版本Symf欧宝娱乐app下载地址ony 6.2(当前的稳定版本)。

维护

一生中一个小版本,新版本(补丁版本)每月发表。本文档描述了可接受的边界变化。

错误修复被接受在下列条件:

  • 这种变化不会破坏有效的单元测试;
  • 新的单元测试覆盖错误修正;
  • 当前车的行为并没有受到广泛用作“特性”。

请注意

当文档(或欧宝体育电话phpdoc)不同步的代码,代码的行为应该被认为是正确的。

除了bug修复,其他一些小变化可以接受在一个补丁版本:

  • 性能改进:性能改进应该只接受如果更改本地(位于一个类),只有算法问题(任何这样的补丁必须要有数字显示真实的代码)的一个重大进步;
  • 新版本的PHP / HHVM:修复添加支持新版本的PHP或HHVM是可以接受的,如果他们不打破单元测试套件;
  • 流行的操作系统的新版本:修复添加对新版本的支持流行的操作系统(Linux, MacOS和Windows)是可以接受的,如果他们不把单元测试套件;
  • 翻译:翻译更新和添加接受;
  • 外部数据:更新外部数据包含在Symfony可以更新(例如像ICU);欧宝娱乐app下载地址
  • 版本更新为作曲家依赖关系:改变最小版本的依赖是可能的,撞到一个主要或增加PHP版本不是最小;
  • 编码标准和重构:编码标准修复或代码重构不推荐,但可以接受与现有代码库的一致性,如果他们不是太入侵,如果合并他们的主人将不会导致复杂的分支合并;
  • 测试:增加可以添加代码覆盖率的测试。

上面列出的任何没有明确应该做的相反(又名或大或小的下一个版本分支)。例如,从未接受过以下修改补丁版本:

  • 新功能;
  • 向后兼容性休息:注意,向后兼容性可以解决安全问题,如果它不可能解决否则;
  • 支持外部平台:添加支持新的平台(如Google App Engine)不能完成补丁版本;
  • 异常消息:异常消息不能改变一些自动化系统可能会依靠他们(即使这不是推荐);
  • 添加新的作曲家依赖关系;
  • 支持新的主要版本的作曲家依赖关系:考虑支持现有的较新版本的依赖是不可接受的。
  • 网页设计:改变内置的网页设计页面像例外,工具栏或分析器是不允许的。

请注意

这一政策的目的是使一个连续的升级路径,允许一个推进最新Symfony版本以最安全的方式。欧宝娱乐app下载地址一个应该能够将PHP版本,操作系统或Symfony版本几乎独立。欧宝娱乐app下载地址这就是为什么支持最新的PHP版本或操作系统特性被认为是错误修正。

这项工作,包括代码示例,许可下Creative Commons冲锋队3.0许可证。