Welcome to The Cookbook

beforeFind(mixed $queryData)

find 関連の操作の前に呼び出されます。このコールバックに渡される $queryData は現在のクエリーについての情報を持っています: conditions, fields などです

find 操作を開始したくない場合（おそらく $queryData オプションに関連した決定に基づきます）、false を返します。もしそうでない場合は、変更した $queryData を返すか、find に渡したいものやそれ相応のものを返します。

ユーザのルールに基づいて find 操作を制限するためにこのコールバックを使用したり、現在の読み込みに基づいて決定をキャッシュしたりするかもしれません。

afterFind(array $results, bool $primary)

find 操作から返された結果を変更するため、あるいは他の find 後にロジックを実行するためにこのコールバックを使用します。このコールバックに渡された $results パラメータはモデルの find 操作から返された結果を含みます。たとえば次のようなものです:

$results = array(
  0 => array(
    'ModelName' => array(
      'field1' => 'value1',
      'field2' => 'value2',
    ),
  ),
);

1. $results = array(
2. 0 => array(
3. 'ModelName' => array(
4. 'field1' => 'value1',
5. 'field2' => 'value2',
6. ),
7. ),
8. );

このコールバックの返り値はこのコールバックを呼び出した find 操作の（おそらくは変更された）結果です。

$primary が false の場合、$results のフォーマットは期待しているものとは少し違っています。通常の find 操作の結果の代わりに次のようになります:

$results = array(
  'field_1' => 'value',
  'field_2' => 'value2'
);

1. $results = array(
2. 'field_1' => 'value',
3. 'field_2' => 'value2'
4. );

再帰的に find を使用した場合、$primary が true であると期待しているコードは "Cannot use string offset as an array" という fatal エラーになるでしょう。

beforeValidate()

バリデートされる前にモデルのデータを変更するためにこのコールバックを使用します。Model::invalidate() を使用して追加でより複雑なバリデーションルールを追加するために使用できます。このコンテキストでは、モデルのデータは $this->data を通してアクセスできます。この関数は true を返さなければなりません。そうでない場合、現在の save() 実行がアボートします。

beforeSave()

この関数に保存前のロジックを置きます。この関数はモデルのデータがバリデートに成功した後、データが保存される前に実行されます。save 操作を継続するには、この関数は true を返す必要がありますす。

このコールバックは、データが保存される前に実行する必要のあるデータメッセージングロジックに特に便利です。ストレージエンジンが特別な形式の日付を必要とする場合、$this->data でアクセスし、変更します。

afterSave(boolean $created)

各 save 操作の後に実行する必要のあるロジックがある場合、このコールバックメソッドに置きます。

新しいオブジェクトが（更新ではなく）生成された場合、$created は true になります。

beforeDelete()

この関数に 削除前ロジックを置きます。削除を継続したい場合は、この関数は true を返す必要があります。アボートしたい場合は false を返します。

afterDelete()

このコールバックメソッドに、削除の後に実行したいロジックを置きます。

onError()

問題が起こった場合に呼び出されます。