向后兼容性指南

注解

CakePHP 从2.0.0开始遵循语义版本控制。这些规则不适用于1.x。

为了澄清在每个版本层次可以预期到哪些变化，我们为使用 CakePHP 的开发人员以及开发CakePHP 的开发人员准备了更详细的信息，以便于建立预期在次要版本中能做什么。主要版本根据需要可以有任意多个打破兼容性的变化。

如果你使用 CakePHP 来构建应用程序，下面的指南说明了你可以预期的稳定性。

除了主要版本，CakePHP 提供的接口的任何现有的方法 不 会改变，现有的接口不会增加新的方法。

类

CakePHP 提供的类可以实例化，并且它们的公共方法和属性，可以被应用代码使用，除了主要版本，(其他的版本)可以保证向后兼容性。

一些 CakePHP 的类标有 API 文档标签(API doc tag)。这些类不 稳定，不能保证向后兼容性。

在次要版本中，类可以添加新方法，已有的方法可以添加新的参数。任何新参数必须有缺省值，但如果你用不同的签名重载方法，你可能会遇到致命错误(fatal errors)。添加了新参数的方法，会在那个版本的升级指南中说明。

下面的表格列出一些用例，以及你从 CakePHP 可以期望得到的兼容性：

在次要版本中，你可以：