Scaffolding¶

アプリケーションのスキャフォールディング (scaffolding) は開発者がオブジェクトの作成、 取得、更新、削除といった基本的なアプリケーションを定義、作成するためのテクニックです。 CakePHP のスキャフォールディングはオブジェクト同士が互いにどのように関連しているかを定義し、 その接続の作成と削除ができます。

足場 (scaffold) を作成するにはモデルとコントローラが必要です。 コントローラに $scaffold 変数を設定するだけで動作します。

CakePHP のスキャフォールディングはとても素晴らしいです。基本的な CRUD アプリケーションを 数分で作って動かすことができます。あまりに素晴らしいのでプロダクション環境で使いたいと 思うかもしれません。本当に素晴らしいのですが、スキャフォールディングはあくまで単なる 足場にすぎないということを心に留めて置いてください。足場はプロジェクトの初期段階でとにかく 早く動かすために粗いつくりになっています。柔軟性があるというよりも、とにかく動かすための 一時的な方法だと言えるでしょう。もしロジックやビューを自分でカスタマイズしたいと思い始めたら、 コードを書くために足場を使うのをやめるタイミングだと言えます。次の章で説明する CakePHP の Bake コンソール は、すばらしい次の一歩で、現在の足場と 同じ結果になるコードを生成します。

スキャフォールディングはウェブアプリケーションの開発初期に必要なコードを得るためのすばらしい方法です。 設計の初期段階におけるデータベーススキーマの変更はよくあることです。しかし、このことは、 ウェブ開発者が実際の使われ方がわからないフォームの作成を嫌がるというマイナス面を生じます。 開発者の負担を軽減させるために CakePHP はスキャフォールディング機能を提供しています。 スキャフォールディングはデータベーステーブルを分析して、追加、削除、編集ボタンがついている標準的な一覧、 編集のための標準的なフォーム、データベースの1レコードを見るための標準的なビューを作成します。

スキャフォールディングを追加するために、コントローラの中で、 $scaffold 変数を追加して下さい。

class CategoriesController extends AppController {
    public $scaffold;
}

(app/Model/Category.php に) 基本的な Category モデルクラスを既に作成していたとすると、 準備は以上となります。 新しい足場を見るために http://example.com/categories へアクセスしてみて下さい。

スキャフォールディングはモデル間のつながりについての知識を与えてくれます。 もし Category モデルが User に従属 (belongsTo) していた場合、 Category 一覧に関連している User の ID が表示されているでしょう。 スキャフォールディングはモデル間のつながりについて"知って"いますが、 手動でモデルのつながりを示すコードを追加するまでは足場のビューの中には関連したレコードが表示されません。 例えば、もし Group が複数の User を持っていて (hasMany) 、 User が Group に 従属 (belongsTo) している場合、以下のコードを User と Group モデルに 手動で追加しなければなりません。このコードを追加する前だと、 User 追加フォームに Group のための select ボックスが空のまま表示されます。

// In Group.php
public $hasMany = 'User';
// In User.php
public $belongsTo = 'Group';

もし ID 以外の別なもの (例えばユーザの名前など) を表示したい場合、 $displayField 変数を モデルで設定して下さい。それでは、スキャフォールディングの中で ID ではなく名前によってカテゴリに 関連したユーザが示されるように User クラスに $displayField を設定してみましょう。

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

public $scaffold = 'admin';

http://example.com/admin/controller/index
http://example.com/admin/controller/view
http://example.com/admin/controller/edit
http://example.com/admin/controller/add
http://example.com/admin/controller/delete

public function admin_view($id = null) {
  // custom code here
}

app/View/Posts/scaffold.index.ctp
app/View/Posts/scaffold.form.ctp
app/View/Posts/scaffold.view.ctp

app/View/Scaffolds/index.ctp
app/View/Scaffolds/form.ctp
app/View/Scaffolds/view.ctp