Welcome to the Cookbook

アプリケーションのスキャフォールディングは、開発者がオブジェクトを生成・取り出し・更新・削除することができる基本的なアプリケーションを定義し作成するという技術です。CakePHP のスキャフォールディングを使用すると、開発者はオブジェクトがお互いにどのように関連するかを定義し、そのリンクを作成したり壊したりすることができます。

スキャフォールドを作成するために必要なことは、モデルとそのコントローラです。$scaffold 変数をコントローラ内に設定すると、動作します。

CakePHP のスキャフォールディングはかなりクールです。これを使用すると、基本的な CRUD アプリケーションが出来上がり、数分で使用できます。あまりにクールなため、製品版のアプリケーションで使用したくなるほどです。それもクールだと思いますが、スキャフォールディングはあくまでスキャフォールディングであると認識しておいてください。開始するにあたって、プロジェクトの初期段階で実際に素早く構築できるというルーズな構造です。完璧に柔軟であるというわけではありません。起動し実行するための一時的な方法ということです。実際にロジックやビューをカスタマイズしたい場合、なんらかのコードを記述するためにスキャフォールディングを持ってくる時です。CakePHP の Bake コンソールは、次の章で述べますが、すばらしい次のステップです: たいていの現在のスキャフォールドと同じ結果を生成するあらゆるコードを生成します。

スキャフォールディングはウェブアプリケーションを開発し始めに初期段階の部分を構築する素晴らしい方法です。初期のデータベースのスキーマは変更されやすく、設計プロセスの初期段階ではあたりまえのことです。これは次のようなことがあります: ウェブ開発者はフォームを作成するのを嫌い、実際に使用しているところをみないでしょう。開発者のストレスを減らすために、スキャフォールディングが CakePHP には含まれています。スキャフォールディングはデータベーステーブルを解析し、追加・削除・編集ボタンをもった標準のリストを生成し、編集用の標準フォームやデータベース内の単一の項目を検索する標準ビューを生成します。

アプリケーションにスキャフォールディングを追加するには、コントローラ内に $scaffold 変数を追加します:

<?php

class CategoriesController extends AppController {
    var $scaffold;
}

?>

1. <?php
2. class CategoriesController extends AppController {
3. var $scaffold;
4. }
5. ?>

最も基本的な Category モデルクラスファイル(/app/models/category.php 内)を生成すると仮定します。新しいスキャフォールドを見るために http://example.com/categories を見てください。

スキャフォールドしたコントローラ内でメソッドを作成すると、予期しない結果を引き起こします。たとえば、スキャフォールドしたコントローラ内で index() メソッドを作成すると、index メソッドはスキャフォールドした機能ではないものを描画します。

スキャフォールディングはモデルの関連を意識しますので、Category モデルが User に属している場合、Category リスト内に関連する User の ID があるでしょう。ID （ユーザのファーストネームのように）の近くになにかある場合、モデルで $displayField 変数を設定することができます。

では、User クラス内の $displayField 変数を設定しましょう。そうするとユーザの関連するカテゴリがスキャフォールディングの ID ではなくファーストネームを表示されるでしょう。この特徴のおかげでスキャフォールディングは多くのインスタンスで読み込み可能になるでしょう。

<?php

class User extends AppModel {
    var $name = 'User';
    var $displayField = 'first_name';
}

?>

1. <?php
2. class User extends AppModel {
3. var $name = 'User';
4. var $displayField = 'first_name';
5. }
6. ?>