後方互換性ガイド¶

移行ガイド¶

メジャー・マイナーの各リリースについて、CakePHP チームは移行ガイドを提供します。 このガイドはそれぞれのリリースの新機能と非互換な変更を説明します。 これは Cookbook の 付録 セクションで見ることができます。

CakePHP の使用¶

CakePHP を用いてアプリケーションを構築している場合、次のガイドラインで示す堅牢性 (stability) が期待できます。

CakePHP での作業¶

CakePHP をより良くする手助けをしようという場合、機能の追加・変更時に以下の ガイドラインに沿うように頭にとどめておいてください。

マイナーリリースでは次のことができます。

非推奨¶

各マイナーリリースでは、機能が非推奨になる可能性があります。 機能が非推奨になると、API ドキュメントや実行時の警告が追加されます。 実行時エラーは、コードが壊れる前に更新する必要があるコードを見つけるのに役立ちます。 実行時の警告を無効にするには、 Error.errorLevel 設定値を使用します。

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

これで、実行時の非推奨警告を無効にします。

Experimental Features¶

Experimental features are not included in the above backwards compatibility promises. Experimental features can have breaking changes made in minor releases as long as they remain experimental. Experiemental features can be identified by the warning in the book and the usage of @experimental in the API documentation.

Experimental features are intended to help gather feedback on how a feature works before it becomes stable. Once the interfaces and behavior has been vetted with the community the experimental flags will be removed.