モデル¶

モデルを理解する¶

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

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

App::uses('AppModel', 'Model');
class Ingredient extends AppModel {
    public $name = 'Ingredient';
}

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

中間クラスの AppModel は独自に作成しない限りは空のクラスであり、 CakePHP のコアフォルダから取り込まれます。 AppModel をオーバーライドすることで、アプリケーション内の全てのモデルで利用可能な 機能を定義することができます。この場合、独自の AppModel.php ファイルを 他の全てのモデルと同様に Model フォルダに置きます。 Bake を使用してプロジェクトを作成すると、自動的にこのファイルが生成されます。

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

Ingredient モデルの話に戻りましょう。これを動作させるには、 /app/Model/ ディレクトリに PHP のファイルを作成します。 クラス名と同じファイル名をつけることになっています。 この例の場合は Ingredient.php です。

モデルを定義すると 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¶