3.5 移行ガイド¶

非推奨の複合 get / set メソッド¶

過去には、CakePHP は get / set モードの両方を提供する 'モーダル' メソッドを 利用していました。これらのメソッドにより、IDE の自動補完や、 将来的に厳格な戻り値の型を追加する機能が複雑になります。 これらの理由から、複合 get / set メソッドは、個別の get および set メソッドに分割されています。

推奨されなくなり、 getX() と setX() メソッドに置き換えられた メソッドのリストを次に示します。

Cake\Cache\Cache

• config()

• registry()

Cake\Console\Shell

• io()

Cake\Console\ConsoleIo

• outputAs()

Cake\Console\ConsoleOutput

• outputAs()

Cake\Database\Connection

• logger()

Cake\Database\TypedResultInterface

• returnType()

Cake\Database\TypedResultTrait

• returnType()

Cake\Database\Log\LoggingStatement

• logger()

Cake\Datasource\ModelAwareTrait

• modelType()

Cake\Database\Query

• valueBinder() の getter 部分 (今は getValueBinder())

Cake\Database\Schema\TableSchema

• columnType()

Cake\Datasource\QueryTrait

• eagerLoaded() の getter 部分 (今は isEagerLoaded())

Cake\Event\EventDispatcherInterface

• eventManager()

Cake\Event\EventDispatcherTrait

• eventManager()

Cake\Error\Debugger

• outputAs() (今は getOutputFormat() / setOutputFormat())

Cake\Http\ServerRequest

• env() (今は getEnv() / withEnv())

• charset() (今は getCharset() / withCharset())

Cake\I18n\I18n

• locale()

• translator()

• defaultLocale()

• defaultFormatter()

Cake\ORM\Association\BelongsToMany

• sort()

Cake\ORM\LocatorAwareTrait

• tableLocator()

Cake\ORM\EntityTrait

• invalid() (今は getInvalid(), setInvalid(), setInvalidField(), そして getInvalidField())

Cake\ORM\Table

• validator()

Cake\Routing\RouteBuilder

• extensions()

• routeClass()

Cake\Routing\RouteCollection

• extensions()

Cake\TestSuite\TestFixture

• schema()

Cake\Utility\Security

• salt()

Cake\View\View

• template()

• layout()

• theme()

• templatePath()

• layoutPath()

• autoLayout() (今は isAutoLayoutEnabled() / enableAutoLayout())

スコープ付きミドルウェア¶

特定のURLスコープのルートに条件付きでミドルウェアを適用できるようになりました。 これにより、ミドルウェア内部でURLチェックコードを記述せずに、 アプリケーションのさまざまな部分に対応するミドルウェア層を構築できます。 詳しくは、 スコープ付きミドルウェアの接続 をご覧ください。

新しいコンソールランナー¶

3.5.0 では Cake\Console\CommandRunner が追加されました。このクラスは Cake\Console\CommandCollection とともに、CLI環境と新しい Application クラスを統合します。 Application クラスは console() フックを実装できるようになりました。これは、どのCLIコマンドが 公開されているか、それらがどのように命名されているか、シェルが どのように依存関係を取得するかを完全に制御できます。この新しいクラスを採用するには bin/cake.php のファイルの内容を こちら の ファイルに置き換える必要があります。

キャッシュエンジンフォールバック¶

キャッシュエンジンは、 fallback キーを用いて定義できるようになりました。 このキーは処理エンジンが誤って設定されている場合(または使用できない場合)に フォールバックを使用する構成を定義するものです。 詳しくは キャッシュフォールバックの設定 のフォールバックの設定をご覧ください。

アプリケーションのスケルトンに dotenv のサポートを追加¶

アプリケーションのスケルトンに、「dotenv」の統合機能が追加されました。 これは、あなたのアプリケーションを環境変数を使用して構成することを容易にします。 詳しくは 環境変数 の章をご覧ください。

コンソールの結合テスト¶

Cake\TestSuite\ConsoleIntegrationTestCase クラスが追加され、 コンソールアプリケーションの結合テストがより簡単になりました。 詳しくは、 コマンドのテスト をご覧ください。 このテストクラスは、現在の Cake\Console\ShellDispatcher および 新たに追加された Cake\Console\CommandRunner と完全に互換性があります。

コレクション¶

• Cake\Collection\Collection::avg() が追加されました。

• Cake\Collection\Collection::median() が追加されました。

コア¶

• Cake\Core\Configure::read() は、要求されたキーが存在しない場合に用いる デフォルト値をサポートするようになりました。

• Cake\Core\ObjectRegistry に、 Countable および IteratorAggregate インターフェースが実装されました。

コンソール¶

• Cake\Console\ConsoleOptionParser::setHelpAlias() が追加されました。 このメソッドを使用することで、ヘルプ出力を生成するときに使用される コマンド名を設定できます。デフォルトは cake です。

• Cake\Console\ShellDispatcher の代わりに Cake\Console\CommandRunnner が 追加されました。

• アプリケーションが提供するコマンドラインツールを定義するための インターフェイスとして Cake\Console\CommandCollection が追加されました。

データベース¶

• SQLiteドライバーに mask オプションが追加されました。このオプションは SQLiteデータベースファイルが作成されたときのアクセス権限の設定を可能にします。

データソース¶

• Cake\Datasource\SchemaInterface オプションが追加されました。

• smallinteger と tinyinteger に新しい抽象型が追加されました。 既存の SMALLINT 型と TINYINT 型がこれらの新しい抽象型として 反映されるようになりました。 TINYINT(1) 型は、引き続きMySQLで boolean型として扱われます。

• Cake\Datasource\PaginatorInterface が追加されました。 PaginatorComponent は、このインターフェイスを通してページネーションを 取り扱うようになりました。これにより、他のORMと似た実装で コンポーネントによってページネーションをできるようになりました。

• Cake\Datasource\Paginator は ORM/Database のクエリーインスタンスを ページ制御するために追加されました。

イベント¶

• Cake\Event\EventManager::on() と off() はチェーン実装可能になり、 複数のイベントを一度に設定することが容易になりました。

Http¶

• 新たに Cookie と CookieCollection クラスが追加されました。 これらのクラスを使用するとオブジェクト指向でクッキーを扱うことができます。 また、これらは Cake\Http\ServerRequest 、 Cake\Http\Response 、 Cake\Http\Client\Response で利用できます。 詳しくは、 クッキー と クッキーの設定 をご覧ください。

• セキュリティヘッダーの適用が容易になる新しいミドルウエアが追加されました。 詳しくは、 セキュリティヘッダーの追加 をご覧ください。

• クッキーデータを透過的に暗号化する新しいミドルウェアが追加されました。 詳しくは、 クッキー暗号化ミドルウェア をご覧ください。

• CSRFに対する保護を容易にする、新しいミドルウェアが追加されました。 詳しくは、 クロスサイトリクエストフォージェリー (CSRF) ミドルウェア をご覧ください。

• Cake\Http\Client::addCookie() が追加されました。 これはクライアントインスタンスへのクッキー追加を容易にします。

インスタンス設定トレイト¶

• InstanceConfigTrait::getConfig() は $default という 第二引数を取るようになりました。もし特定の key に使用できる値がない場合、 その $default の値が返却されます。

ORM¶

• Cake\ORM\Query::contain() は一つのアソシエーションが入る場合、 ラッピング配列なしで呼び出すことができるようになり。つまり、 contain('Comments', function (){ ... }); で動作するようになります。 この変更で leftJoinWith() や matching() のような、他の イーガーローディング関連のメソッドと contain() の一貫性を与えています。

ルーティング¶

• Cake\Routing\Router::reverseToArray() が追加されました。 このメソッドを使用することで、リクエストオブジェクトをURL文字列の生成に 使用できる配列に変換できます。

• Cake\Routing\RouteBuilder::resources() に path オプションが追加されました。 このオプションを使用するとコントローラー名に一致しないリソースパスを 作ることができます。

• Cake\Routing\RouteBuilder に、特定のHTTPメソッドのルートを作成するメソッドが 追加されました。例えば get() や post() が追加されています。

• Cake\Routing\RouteBuilder::loadPlugin() が追加されました。

• Cake\Routing\Route のオプション定義メソッドは 流れるようなインターフェイスになりました。

TestSuite¶

• TestCase::loadFixtures() は引数が与えられていないとき、 すべてのフィクスチャーをロードするようになりました。

• IntegrationTestCase::head() が追加されました。

• IntegrationTestCase::options() が追加されました。

• IntegrationTestCase::disableErrorHandlerMiddleware() が追加されました。 結合テストのデバッグがより簡単になりました。

バリデーション¶

• Cake\Validation\Validator::scalar() は、フィールドが非スカラー型データを 取得しないことを保証するために追加されました。

• Cake\Validation\Validator::regex() が追加されました。 正規表現パターンでのデータ検証を今までより便利にします。

• Cake\Validation\Validator::addDefaultProvider() が追加されました。 このメソッドでアプリケーションで作成されたすべてのバリデーターに バリデーションプロバイダーを挿入できます。

• Cake\Validation\ValidatorAwareInterface が追加されました。 これは、 Cake\Validation\ValidatorAwareTrait によって実装されるメソッドを 定義します。

View¶

• Cake\View\Helper\PaginatorHelper::limitControl() が追加されました。 このメソッドを使用すると、ページネートされた結果セットのlimit値を 更新するセレクトボックスのフォームを作ることができます。