初めてCakePHPで開発するときに気をつけたいMVC〜


CakePHP3のMVCの話をするので、フレームワークによっては少し違う部分があるかもしれません。

MVCの流れと開発時の作成手順

まずはMVCの処理の流れを確認しましょう。
ブラウザからリクエストが発生し、ブラウザに返すまでの動きが以下の図で表せます。

  1. ブラウザからコントローラーとアクションを指名され、アクションが実行される。
  2. アクション内でモデルが指定されていればモデルが実行される。
  3. アクションの処理が終了したら、Templateフォルダ¥コントローラーと同名のフォルダ¥アクション名と同名のctpファイルを表示対象として生成する。
  4. ブラウザに返す。

この流れを踏まえると、以下の順で作成を進めることをお勧めします。

  1. Controllerとaction(とりあえずアクションの枠だけ)
  2. View(Template)
  3. Controllerのaction内の処理
  4. 必要になったときにModel内各種

ところでMVCとは?

M

ModelのMです。
主に、CRUD(Create/Read/Update/Delete)処理を行ったり、入力チェックを行ったりします。

CakePHPでは、Modelフォルダ内の構成は以下のようになっています。

Model
|-Entity
|-Table 
|-Validation //自分で作る

Entity

Table内のソースを動かすために必要なもの。
まだ使ったことないけど、投げれば計算とか、Selectしてきた結果のフラグを日本語に変えたりしてくれるようになる。

参考記事:CakePHP3を触ってみました 〜tableとentityはどう使い分けたらええねん〜

Table

CRUD処理はもちろん、入力チェックもここで実装できる。

CakePHPは(デフォルトでやろうとすると)1テーブル1ヴァリデーターになる。
もちろん、デフォルトでやろうとしないでヴァリデーターかけることはできる。(めんどくさかった)

Tableを動かすためにはEntityが必要です。
TableのinitializeでどのEntityを使用するか定義します。
initializeではEntity以外に、使用するDB名とテーブル名の定義、主キーの定義をします。

Validation

自分でValidationをカスタマイズしようと思った場合はここにソースを配置しま
す。

参考記事:CakePHP3のバリデーションをまとめてみた

V

一番馴染みやすいところだと思います。
拡張子が「ctp」でなんだ?と思いますが、中身はHTML with PHPです。
もちろん、JavaScript/CSSも記述可能です。普通にHTMLファイルだと思って編集すればいいと思います。
ここでは画面に生成されるHTMLファイルのソースです。

つまりViewのVです。
しかし実際にファイルを置く場所はTemplateフォルダ内です。
Viewフォルダもいるけど、MVCのVとして使うわけではないです、CakePHP3では。
ちょっと名前がややこしいな。

Templateフォルダ内の構成は以下のようになっています。

Template
|-Element
|-Error
|-Layout
//他は省略

Element

めっちゃ便利。HTMLファイルをパーツごとに書き出すことができる。
ここで書き出したパーツを各Templateから呼び出せば同じパーツが使いまわせます。

たとえば、グローバルナビゲーション(全画面共通メニュー)とかテーブル上下に配置するページャーの< << >> >こういうやつとか。

全ての画面に表示したいわけじゃないけど、たくさんの画面に表示したい共通項目があれば、Element使ってみてください。

画面用の共通クラスみたいに使えます。

Error

エラーの時に表示する画面はここに置いておきます。

参考記事:【CakePHP3】エラー画面のカスタマイズ方法を徹底解説!

Layout

ASP.NETをやったことある人にはマスターと言えば通じやすいかも。

全画面共通で表示したいことをdefault.ctpで設定します。
もちろん個別でdefault.ctpを適応させない、とすることも可能です。

default.ctpの話になりますが、ここに画面上のヘッダーやフッターを書いたり、
JavaScriptやCSSの呼び出しをしたりすると、個別のTemplateで設定する必要がなくなるので、楽です。

C

ControllerのCです。
よく使います。
Model呼んだり、Viewに値渡したり、大活躍です。
普通に処理書くところです。
普通にPHP書くところなので、馴染みやすいです。

MVCと名前

CakePHPは命名規則が厳しいです。
あれ、動かないなあ?と思ったらまずは名前を疑ってみてください。
MとCは大文字からファイル名が始まります。
Vは全て小文字になります。

Mの名前

TableとEntityにはDBの名前を使用します。
CakePHPが推奨するテーブル名は複数形であることとされていますが、単数形でも動作上の問題はないです。
単数形の場合はTableのinitializeで定義してください。

たとえば、CakePHP推奨のテーブル名はemployeesですが、m_employeeのテーブルを使用することは可能です。

TableはXxxTable.phpという名前でなければいけません。
最初は大文字で以降は小文字、Tも大文字です。

たとえばEmployeesTable.php

XxxTable.phpファイル内のクラス名はファイル名同様にXxxTableとなります。
しかし、ControllerでTableを呼ぶときはXxxとだけ呼びます。

たとえばTableRegistry::get('Employees');
ひっかかるう〜。

ちなみにTable内のメソッド名はxxxXxxxのキャメル式です。

こんなかんじ

class EmoloyeesTable extends Table
{

    public function initialize(array $config)
    {

    }

    public function getEmployeeDataByDepart()
    {

    }
}

EntityはEmployee.phpになります。単数形です。
多分、Tableのinitializeで定義しておけばどんな名前でも良さそうです。
わかりやすいほうがいいから、Tableと名前を揃えておくといい。

ちなみにValidationの名前は自由につけられるようです。

Vの名前

すべて小文字から始めます。
index.ctpとかlist.ctpとか
ちなみにshowListというアクションで同名のViewを表示する場合は、show_list.ctpという名前になります。
大文字の文字の前にアンダーが入って全て小文字になります。
ここで突然アクション名について話が出ましたが詳細については次章で。

Cの名前

Controller名は大文字から始めてXxxController.phpになります。

一方Action名はキャメル式です。xxxXxxxです。
たとえばshowList

Controllerと合わせるとこんな感じ。

class ComparativeController extends Controller
{

    public function index()
    {

    }

    private function setHandlingData()
    {

    }
}

CとVの関係

CakePHPのCとVの関係で難しいところが、ファイルの配置場所です。

Controllerフォルダ内にControllerファイルを設置します。
Templateフォルダ内にController単位でフォルダを作成し、その中にctpファイルを設置します。

たとえばこんなコードがあったとします。

class EmployeeController extends Controller
{

    public function index()
    {

    }

    public function list()
    {

    }

    private function beforeUpdate()
    {

    }
}

この場合のTemplateフォルダは以下のようになります。

Template
 |-Employee
    |-index.ctp
    |-list.ctp

before_update.ctpがないのはbeforeUpdateがプライベートだからです。

さて、CakePHPではテンプレート無指定の場合は、自分のController名と同じフォルダにある自分のAction名と同じctpファイルを出力使用とします。
なので、アクション単位でctpファイルが必要になります。

もちろん、全アクションに必要なわけではないです。必要になるのはブラウザからリクエストされたときのActionに必要になります。
そのため、プライベートファンクションであるbeforeUpdateはctpファイルがありません。

また、ctpファイル名を指定することも可能です。

CとMの関係

CとVほどこれといったことがない。
MでできることはCでもできるということぐらい。