モデル

モデルはアプリケーションのビジネスレイヤーを担当するクラスです。すなわち、業務ドメインにおけるデータやその妥当性、トランザクションや情報ワークフローの過程で発生する全てのことがらを管理する役割を負うということです。

モデルクラスは通常はデータを表すもので、 CakePHP のアプリケーションではデータアクセスに使われます。具体的に言うと、モデルはデータベースのテーブルを表しますが、それに限らずファイルや外部ウェブサービス、iCal のイベントや CSV ファイルの行など、データを扱うあらゆるものに使われます。

ひとつのモデルを他のモデルと関連づけることができます。例えば Recipe はそのレシビの Author と関連づけられたり、レシピの Ingredient と関連づけられたりします。

このセクションでは、モデルでどのような機能を自動化することができるか、それらをどうやってオーバーライドするか、そしてモデルがどのようなメソッドやプロパティを持っているかについて説明します。データを関連づける様々な方法も説明します。データの検索、保存、削除の仕方も説明します。最後にデータソースについて触れます。

モデルを理解する

Model はデータモデルを表します。オブジェクト指向プログラミングにおいて、データモデルは自動車や人、家といった「もの」を表現するオブジェクトです。例えばブログには複数の記事があり、それぞれの記事には複数のコメントがあります。 Blog、Post、Comment はすべてモデルの例で、それぞれが互いに関連づけられます。

以下は CakePHP におけるモデル定義の簡単な例です。

// src/Model/Ingredient.php
class Ingredient extends AppModel
{
    public $name = 'Ingredient';
}

このシンプルな宣言をするだけで、Ingredient モデルにはデータの保存や削除に関するクエリを発行するのに必要な機能が備わります。これらの魔法のメソッドは CakePHP の Model クラスから継承されます。 Ingredient モデルはアプリケーション用のモデルである AppModel を extend しており、 AppModel は CakePHP 内部の Model クラスを extend しています。つまり Ingredient クラスに上記の機能を与えているのはコアの Model クラスです。

composer.json で src/ を classmap に指定していれば (pieceofcake2/app スケルトンの設定です)、 AppModel は Composer によって自動的に読み込まれます。 classmap を使わない場合は、ファイルの先頭に App::uses('AppModel', 'Model'); を書いて、必要なときにクラスが読み込まれるようにしてください。

中間クラスの AppModel はアプリケーションの src/Model/AppModel.php にあり、最初は空のクラスです。CakePHP のコアには AppModel が含まれていないため、アプリケーション側で用意する必要があります。アプリケーションスケルトンには最初から含まれています。 AppModel にメソッドを追加することで、アプリケーション内の全てのモデルで利用可能な機能を定義することができます。

複数のモデルに同様のロジックを適用する方法に関しては Behaviors も参照してください。

Ingredient モデルの話に戻りましょう。これを動作させるには、 src/Model/ ディレクトリに PHP のファイルを作成します。レガシーレイアウトでは app/Model/ です (CakePHP のフォルダ構造を参照してください)。クラス名と同じファイル名をつけることになっています。この例の場合は Ingredient.php です。 Composer の classmap を使っている場合は、新しいクラスファイルを追加したら composer dump-autoload を実行してください。

NOTE

CakePHP は対応するファイルが src/Model/ に見つからない場合、動的にモデルオブジェクトを生成します。モデルのファイルに正しい名前をつけなければ (つまり ingredient.php や Ingredients.php などとしたら) CakePHP にとって見当たらないそのファイルではなく、 AppModel のインスタンスが使われることになります。モデル内に自身で定義したメソッドやモデルに追加したビヘイビアを使おうとして、呼び出し中のメソッドの名前で SQL エラーが発生する場合は CakePHP がそのモデルを見つけられないというサインであり、ファイル名かアプリケーションキャッシュ、またはその両方をチェックする必要があります。

NOTE

モデル名には使えない名前があります。例えば "File" という名前は使えません。 "File" は CakePHP のコアに既に存在するクラスだからです。

モデルを定義すると Controller からアクセスできるようになります。モデル名がコントローラ名と対応する名前を持つ場合、 CakePHP はそのモデルを自動的に呼び出し可能にします。例えば IngredientsController という名前のコントローラは自動で Ingredient モデルを初期化して、コントローラの $this->Ingredient に割り当てます。

class IngredientsController extends AppController
{
    public function index()
    {
        //全ての ingredients を取得してビューに渡す
        $ingredients = $this->Ingredient->find('all');
        $this->set('ingredients', $ingredients);
    }
}

関連モデルはメインのモデルを通じて利用できます。以下の例は、Recipe が Ingredient モデルと関連づけられている場合です。

class Recipe extends AppModel
{
    public function steakRecipes()
    {
        $ingredient = $this->Ingredient->findByName('Steak');

        return $this->findAllByMainIngredient($ingredient['Ingredient']['id']);
    }
}

上記は関連するモデルを利用する方法を示しています。関連を定義する方法を確認するには Associations section を参照してください。

モデル ​

モデルを理解する ​

More on models ​

モデル

モデルを理解する

More on models