向后兼容性指南¶

迁移指南¶

对于每个主要版本和次要版本，CakePHP 团队都会提供迁移指南。这些指南解释了每个版本中的新功能和任何破坏性更改。它们可以在手册的附录部分找到。

使用 CakePHP¶

如果您使用 CakePHP 构建应用程序，以下指南解释了您可以预期的稳定性。

参与 CakePHP 开发¶

如果您正在帮助改进 CakePHP，请在添加/更改功能时牢记以下准则

在次要版本中，您可以

弃用¶

在每个次要版本中，都可能会弃用功能。如果弃用了功能，将添加 API 文档和运行时警告。运行时错误可以帮助您定位需要在出现错误之前更新的代码。如果您想禁用运行时警告，可以使用Error.errorLevel配置值

// in config/app.php
// ...
'Error' => [
    'errorLevel' => E_ALL ^ E_USER_DEPRECATED,
]
// ...

将禁用运行时弃用警告。

实验性功能¶

实验性功能不包括在上述向后兼容性承诺中。实验性功能可能会在次要版本中进行重大更改，只要它们仍然处于实验阶段。实验性功能可以通过手册中的警告和 API 文档中@experimental的使用来识别。

实验性功能旨在帮助收集有关功能如何工作的反馈，然后再使其稳定。一旦接口和行为已在社区中得到验证，将移除实验性标志。