5.1 移行ガイド¶

_cake_core_ キャッシュ設定キーは _cake_translations_ に変更されました。

Mailer::setMessage() は非推奨となりました。このメソッドは直感的でない動作をし、利用頻度も非常に低いためです。

RedisEngine で Redis への TLS 接続を有効にする tls オプションがサポートされるようになりました。。 ssl_ca、ssl_cert、ssl_key オプションを使用して Redis 用の TLS コンテキストを定義できます。

bin/cake plugin list が追加され、利用可能なすべてのプラグイン、そのロード設定、およびバージョンを一覧表示できるようになりました。

オプションの Command 引数に default 値を指定できるようになりました。

BannerHelper が追加されました。このコマンドヘルパーは、テキストをカラフルな背景と余白付きのバナーとして整形できます。

ConsoleOutput に info.bg、warning.bg、error.bg、success.bg のデフォルトスタイルが追加されました。

Arguments::getBooleanOption() および Arguments::getMultipleOption() が追加されました。

Arguments::getArgument() は、未知の引数名が指定された場合に例外をスローするようになりました。 これにより、オプション名と引数名の混同を防ぐことができます。

コンポーネントでも、コントローラやコマンドと同様に、DIコンテナを使用して依存関係を解決し、コンストラクタの引数として受け取れるようになりました。

PluginConfig が追加されました。このクラスを使用すると、利用可能なすべてのプラグイン、そのロード設定、およびバージョンを取得できます。

toString、 toInt、 toBool 関数が追加されました。これらの関数は、リクエストデータや他の入力値を型安全にキャストし、変換に失敗した場合は null を返します。

pathCombine() が追加され、重複や末尾のスラッシュを気にせずパスを組み立てられるようになりました。

BaseApplication および BasePlugin クラスに新しい events フックが追加されました。 このフックは、アプリケーションのグルーバルイベントリスナーを登録する推奨方法です。詳しくは Registering Listeners を参照してください。

point、 linestring、 polygon、 geometry 型のサポートが追加されました。 これらの型は地理空間やデカルト座標を扱う際に便利です。SQLite のサポートは内部的にテキストカラムを使用しており、 データを地理空間値として操作するための関数はありません。

SelectQuery::__debugInfo() に、クエリがどのコネクションロール用のものかが含まれるようになりました。

SelectQuery::intersect() および SelectQuery::intersectAll() が追加されました。 これらのメソッドにより、 INTERSECT および INTERSECT ALL 結合を使用したクエリを記述できるようになりました。

intersect、 intersect-all、および set-operations-order-by 機能がサポートされるようになりました。

4.x に存在したバッファリングなしでレコードを取得する機能が復活しました。 SelectQuery::enableBufferedResults()、` SelectQuery::disableBufferedResults()`、 SelectQuery::isBufferedResultsEnabled() メソッドが再追加されました。

RulesChecker::remove()、 removeCreate()、 removeUpdate()、および removeDelete() メソッドが追加されました。これらのメソッドにより、ルールを名前で削除できるようになりました。

SecurityHeadersMiddleware::setPermissionsPolicy() が追加されました。このメソッドにより、permissions-policy ヘッダー値を定義できるようになりました。

Client はリクエスト送信時に HttpClient.beforeSend および HttpClient.afterSend イベントを発火するようになりました。 これらのイベントを利用して、ログ記録、キャッシュ、テレメトリ収集などを行うことができます。

Http\Server::terminate() が追加されました。 このメソッドは Server.terminate イベントを発火し、fastcgi 環境ではレスポンス送信後にロジックを実行できます。 その他の環境では Server.terminate イベントはレスポンス送信 前 に実行されます。

Number::formatter() および currency() は、丸め方法を上書きする roundingMode オプションを受け付けるようになりました。

toDate および toDateTime 関数が追加されました。これらの関数は、リクエストデータや他の入力値を型安全にキャストし、変換に失敗した場合は null を返します。

アソシエーションのファインダークエリで preserveKeys オプションを設定できるようになりました。 これにより、 formatResults() と組み合わせて、アソシエーションのファインダー結果を連想配列として返すことができます。

名前に json を含む SQLite カラムを JsonType にマッピングできるようになりました。 この機能は現時点ではオプトインであり、アプリで ORM.mapJsonTypeForSqlite 設定値を true にすることで有効になります。

CakePHP およびアプリのテンプレートは PHPUnit ^10.5.5 || ^11.1.3" を使用するように更新されました。

ConnectionHelper のメソッドがすべて static になりました。このクラスは状態を持たず、メソッドが static に更新されました。

LogTestTrait が追加されました。この新しいトレイトにより、テスト内でログを簡単にキャプチャし、ログメッセージの有無をアサートできるようになりました。

IntegrationTestTrait::replaceRequest() が追加されました。

Hash::insert() および Hash::remove() は、 array データに加えて ArrayAccess オブジェクトも受け付けるようになりました。

Validation::enum() および Validator::enum() が追加されました。これらのバリデーションメソッドにより、Backed Enum 値の検証が簡単になりました。

Validation::enumOnly() および Validation::enumExcept() が追加されました。これらのメソッドにより、特定のケースの検証や、Backed Enum 値のバリデーションをさらに簡単に行うことができます。

View cells は、アクションの前後で Cell.beforeAction および Cell.afterAction イベントを発火するようになりました。

NumberHelper::format() は、丸め方法を上書きする roundingMode オプションを受け付けるようになりました。

TextHelper::autoLinkUrls() に、リンクラベルの表示を改善するためのオプションが追加されました: * stripProtocol: リンク先の先頭から http:// や https:// を取り除きます。デフォルトは無効です。 * maxLength: リンクラベルの最大長を指定します。デフォルトは無効です。 * ellipsis: リンクラベルの末尾に付加する文字列です。デフォルトはUTF8バージョンです。

HtmlHelper::meta() で meta('csrfToken') を使うことで、現在の CSRF トークンを含む meta タグを生成できるようになりました。