後方互換性ガイド¶

移行ガイド¶

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

CakePHP の使用¶

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

CakePHP での作業¶

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

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

1(1,2,3,4,5)

マイナーリリースでコードが破壊される 恐れが あります。 詳細は移行ガイドをチェックしてください。

2(1,2)

古いクラス名・メソッド名を利用可能なようの残すことで名前の変更ができます。 通常、名前の変更は重要な利点を持っていない限り避けられます。

3(1,2)

出来る限り避けましょう。削除したことは移行ガイドに掲載する必要があります。

非推奨¶

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

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

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