CakePHPの規約¶

ファイルとクラス名の規約¶

通常、ファイル名はアンダースコア記法（underscored）を使い、クラス名にはキャメル記法（CamelCased）を使います。すなわち、 Cake において MyNiftyClass というクラスを用いるには、ファイル名を my_nifty_class.php というようにします。次の例で、 CakePHP アプリケーションで典型的に利用する異なるタイプのクラスを、それぞれどのように命名するのか示します。

• KissesAndHugsController というコントローラのクラスは、 kisses_and_hugs_controller.php というファイル名にします(「_controller」がファイル名に含まれることに注意してください)。

• MyHandyComponent というコンポーネントのクラスは、 my_handy.php というファイル名にします。

• OptionValue というモデルのクラスは、 option_value.php というファイル名にします。

• EspeciallyFunkableBehavior というビヘイビアのクラスは、 especially_funkable.php というファイル名にします。

• SuperSimpleView というビューのクラスは、 super_simple.php というファイル名にします。

• BestEverHelper というヘルパーのクラスは、 best_ever.php というファイル名にします。

各ファイルは、 app フォルダ内のそれぞれ適切なフォルダの中かその下(サブフォルダも可)に設置します。

モデルとデータベースの規約¶

モデルのクラス名は単数形でキャメル記法です。Person、BigPerson、ReallyBigPerson などは規約に合ったモデル名です。

CakePHP のモデルに対応するテーブル名は、複数形でアンダースコア記法です。上記の例で言えば、テーブル名はそれぞれ、people、big_people、really_big_peopleになります。

ユーティリティライブラリの「Inflector」を使って、単語の単数形・複数形を判定することができます。更なる情報は、Inflectorのドキュメントを読んでください。

二個以上の単語で構成されるフィールドの名前は、 first_name のようにアンダースコア記法になります。

hasMany, blongsTo, hasOne 中の外部キーは、デフォルトで関連するモデルの(単数形の)名前に _id を付けたものとして認識されます。ケーキ職人(Backer)がケーキ(Cake)を複数持っている(hasMany)としたら、cakes テーブルは、baker_id を外部キーとして bakers テーブルのデータを参照します。categoly_types のような複数の単語のテーブルでは、外部キーは categoty_type_id のようになるでしょう。 For a multiple worded table like category_types, the foreign key would be category_type_id.

モデル間の hasAndBelongsToMany (HABTM) の関係で使用される join テーブルは、join するテーブルに合わせて、アルファベット順に（zebras_apples ではなく、apples_zebras）並べた名前にしてください。

CakePHP モデルの相互に作用する全てのテーブル(join テーブルは除く)は、それぞれの列を一意に識別する単一フィールドのプライマリーキーが必要です。もし、単数形のプライマリーキーではないテーブルのモデルをお望みなら、テーブルに単一フィールドのプライマリーキーを追加することが CakePHP の規約です。このようなテーブルのモデルを使いたい場合は、単一フィールドのプライマリーキーを追加する必要があります。

CakePHP は複合主キーをサポートしません。 join テーブルのデータを直接操作したい場合は、直接 query を呼び出すか、通常のモデルのように振舞えるよう主キーを追加してください。例は次のようになります。

CREATE TABLE posts_tags (
id INT(10) NOT NULL AUTO_INCREMENT,
post_id INT(10) NOT NULL,
tag_id INT(10) NOT NULL,
PRIMARY KEY(id));

また、主キーをオートインクリメントとしてではなく、char(36)として使用しても構いません。そうすると、Model::save メソッドを使って新規レコードを保存するとき、Cakeはユニークな36文字のuuid (String::uuid) を用いようとします。

コントローラの規約¶

コントローラのクラス名は複数形でキャメル記法です。最後にControllerが付きます。PeopleController、BigPeopleController、ReallyBigPeopleControllerなどは規約に合ったコントローラ名です。

コントローラに最初に書くメソッドは、おそらくindex()メソッドでしょう。リクエストによってコントローラは指定されたがアクションは指定されなかったという場合、CakePHP のデフォルト動作では、そのコントローラのindex()メソッドを実行することになっています。例えば、http://www.example.com/apples/ はApplesControllerのindex()メソッドを呼ぶようにマップされ、http://www.example.com/apples/view は、ApplesControllerのview()メソッドにマップされます。

コントローラ関数名の先頭にアンダースコア（_）を付けることで、CakePHP のコントローラメソッドを隠蔽することが可能です。アンダースコアが付けられたコントローラメソッドは web 上では見えないように設定されます。内部での利用のみ可能になります。例えば：

<?php
class NewsController extends AppController {

    function latest() {
        $this->_findNewArticles();
    }

    function _findNewArticles() {
        //最新のニュース記事を取得するロジック
    }
}

?>

http://www.example.com/news/latest/ のページにユーザーがアクセス可能であっても、http://www.example.com/news/_findNewArticles/ を取得しようとするとエラーになるでしょう。なぜなら、メソッドの先頭にアンダースコアが付いているからです。

ビューの規約¶

ビューのテンプレートファイルは、それを表示するコントローラの関数に合わせた、アンダースコア記法で名前が付きます。PeopleControllerクラスのgetReady()関数は、ビューテンプレートとして、/app/views/people/get_ready.ctpを探すことになります。

基本パターンは、 /app/views/コントローラ名/アンダースコア記法_関数名.ctpです。

各部分をCakePHPの規約に合わせて命名しておくことで、混乱を招く面倒な設定をしなくても機能的に動作するようになります。規約に合った命名の最後の例を示します。

• データベースのテーブル： "people"

• モデルクラス： "Person"、 場所は /app/models/person.php

• コントローラクラス： "PeopleController"、 場所は /app/controllers/people_controller.php

• ビューのテンプレート、場所は /app/views/people/index.ctp

これらの規約により、CakePHPは、http://example.com/people/ へのリクエストを、PeopleControllerのindex()関数にマップします。そして、Personモデルが自動的に使える（データベースの'people'テーブルに自動的に接続される）ようになり、表示されることになります。必要なクラスとファイルを作成しただけでこれらの関係が設定されています。

さて、CakePHPの基本について一通り理解できたので、CakePHPブログチュートリアルを試すのも良いでしょう。