Moonmile Solutions Blog

リファクタリングとは言え、いきなりデータベースを変えてしまうのではなくて、database-Model の関係を利用して、「管理のしやすいテーブル名」を、「意味のわかりやすいテーブル名」に変えましょう、という方法です。

# ASP.NET MVC で使う LINQ to Entities や LINQ to SQL なんかは、テーブル名＝クラス名が固定(だと思う)なので、この技が使えないのです。

例えば、既存のテーブルが次の 3 つで校正されています。

• T100 雑誌テーブル
• T200 出版社テーブル
• T300 読者テーブル

ああ、なんて【管理しやすい】テーブルなんでしょうかッ!!! おそらく、将来的に雑誌に関係するテーブル名は、「T101」とか「T102」になる、ってことが容易に想像できます。

…が、決して分かり易いテーブル≒プログラミングしやすいテーブルではないですよね。
# こういう管理の仕方は嫌いではないのですが、避けておいたほうがいいというかなんというか。
# ただし、テーブル数が数百を超えると、こんな風に管理せざるを得ない時もありますよね。名前がだぶらないようにとか、名前が長くなりすぎないようにとか、制限があるので。

さて、これをプログラムで扱うときには、次のようにしたいわけです。

• Magazine 雑誌テーブル
• Publisher 出版社テーブル
• User 読者テーブル

ちなみに、CakePHP の命名規則に従えば、

• magazines 雑誌テーブル
• publishers 出版社テーブル
• users 読者テーブル

のように、小文字かつ複数形にするのが良いのですが、あらかじめデータベースができていたり、社内的な命名規則があったりすると、この限りではないのです。

テーブルを次のように作ります。

-- 雑誌テーブル
create table T100 (
 id int,
 name varchar(50),
 T100id int, -- 出版社ID
 price int
);
-- 出版社テーブル
create table T200 (
 id int,
 name varchar(50)
 );
-- 読者テーブル
create table T300 (
 id int,
 name varchar(50),
 age int
 );

な風に、(極悪)テーブル名を付けておいても、Model で書き換えれば OK。

<!-- models/magzine.php -->
<?php
class Magazine extends AppModel
{
	var $name = 'Magazine';
	var $useTable = 'T100';
}
?>

<!-- models/publisher.php -->
<?php
class Publisher extends AppModel
{
	var $name = 'Publisher ';
	var $useTable = 'T200';
}
?>

<!-- models/user.php -->
<?php
class User extends AppModel
{
	var $name = 'User';
	var $useTable = 'T300';
}
?>

これでコントローラーで使うときは、Magazine、Publisher、User が使えるようになります。

<?php
class MagazinesController extends AppController {
	var $name = 'Magazines';
	var $uses = array('Magazine','Publisher');
	function index() {
		$this->set('Magazines',$this->Magazine->find('all'));
		$this->set('Publishers',$this->Publisher->find('all'));
	}
}
?>

まぁ、対応表を作ってちまちま見るよりはいいか、とは思いますけど、結局は「T100」は「magazine」だったしと、言葉の置き換えは必要になるわけですが。

ただし、これでも問題があって、T100.T200id っていう出版社テーブルへのリンクはモロにビューに出てしまうのですよね。

<!-- views/magazines/index.ctp -->
<h2>雑誌一覧</h2>
<table>
	<tr>
		<td>id</td>
		<td>name</td>
		<td>publisher_id</td>
	</tr>
<?php foreach($Magazines as $item) : ?>
	<tr>
		<td><?php echo $item['Magazine']['id'] ?></td>
		<td><?php echo $item['Magazine']['name'] ?></td>
		<td><?php echo $item['Magazine']['T200id'] ?></td>
	</tr>
<?php endforeach ; ?>
</table>
<h2>出版社一覧</h2>
<table>
	<tr>
		<td>id</td>
		<td>name</td>
	</tr>
<?php foreach($Publishers as $item) : ?>
	<tr>
		<td><?php echo $item['Publisher']['id'] ?></td>
		<td><?php echo $item['Publisher']['name'] ?></td>
	</tr>
<?php endforeach ; ?>
</table>

こういうヘンテコな名前「$item[‘Magazine’][‘T200id’]」が残ってしまうので、完全にリファクタリングって訳でもなさそうですなぁ。ま、テーブル名ぐらいは変えられるってことで。

と、思ったらですね。

virtualFields :: Model の属性 :: モデル :: CakePHPによる開発 :: マニュアル :: 1.3コレクション :: The Cookbook
http://book.cakephp.org/ja/view/1588/virtualFields

を見ると CakePHP 1.3 から モデルに仮の名前を付けられるそうです。
テーブル自体を更新できないので、CRUD 全体には使えませんが、ビューで表示するときには便利かと。

<!-- models/magazine.php -->
<?php
class Magazine extends AppModel
{
	var $name = 'Magazine';
	var $useTable = 'T100';
	var $virtualFields = array(
		'publisher_id'=>'T200id' );
}
?>

こんな風に別名を定義しておくと、

<!-- views/magazines/index.ctp -->
<h2>雑誌一覧</h2>
<table>
	<tr>
		<td>id</td>
		<td>name</td>
		<td>publisher_id</td>
		<td>publisher_id</td>
	</tr>
<?php foreach($Magazines as $item) : ?>
	<tr>
		<td><?php echo $item['Magazine']['id'] ?></td>
		<td><?php echo $item['Magazine']['name'] ?></td>
		<td><?php echo $item['Magazine']['T200id'] ?></td>
		<td><?php echo $item['Magazine']['publisher_id'] ?></td>
	</tr>
<?php endforeach ; ?>

のように、再定義した publisher_id で値を取得できます。

すべてのカラムを再定義するのは問題ありでしょうが、こんな風に一時的に変な名前が付いているカラムには適用して良いかと思います。特に *.ctp で表示するときには、「T200id」よりも「publisher_id」のほうが間違いが少なそうですよね。

覚書きとして。

CakePHP の View-Controller-Model-DataBase の名前の関係がどうなっているかというと。

こんな風になっている。

どういう手順でアプリケーションを作成するのか、ってことですね。

CakePHPブログチュートリアル :: 開発例 :: マニュアル :: 1.2コレクション :: The Cookbook
http://book.cakephp.org/ja/view/219/CakePHPブログチュートリアル

最初はチュートリアルに手を付けるわけですが、さて、サイトを作る時はどこから作り始めるのか、というと、CakePHP は面白いことにブラウザに URL を入力するところから始めます。

ひとまず、ここまでデータベースを設定した後で、ユーザーがブラウザで入力するアドレスを入れます。

http://cake.moonmile.net/Products

すると、エラーがでます。当たり前ですが、このエラーを元に書き進めるわけです。

• ProductsController クラスが無いよ。
• app/controllers/products_controller.php のファイルに置けばいい。
• ひとまず、下記を貼りつければ OK。

<?php
class ProductsController extends AppController {

	var $name = 'Products';
}
?>

という訳で、コントローラーを作ります。

再び http://cake.moonmile.net/Products のアドレスに接続すると、エラーが変わります。

• モデルの Product のための products というテーブルが無いよ。

ってな感じです。

※ ただし、IIS+PHP+MySQL の環境では、ここで 500 のサーバーエラーが出ます。ちょっと、これは不便。何故、500 エラーなのかは不明ですが、Linux 上で PHP+MySQL の組み合わせでは、この通りに動きます。

※ 暫定ですが、/cake/libs/error.php の254 行目ぐらいにある missingTable 関数内の $this->controller->header(“HTTP/1.0 500 Internal Server Error”) の行をコメントアウトすると、テーブルが無いときの 500 エラーを回避できます。

そういう訳で、phpMysqlAdmin などを使って products テーブルを作ります。

create table products (
  id int not null,
  name varchar(50) not null,
  price int not null
)

データも適当に入れておきます。

insert into products values ( 1, 'product 1st', 1000 );
insert into products values ( 2, 'product 2nd', 1000 );
insert into products values ( 3, 'product 3rd', 1000 );

再び http://cake.moonmile.net/Products のアドレスに接続します。

今度は、

• ProductsController コントローラーに index というメソッドが無い。
• まあ、だいたいこんな風に書く。

<?php
class ProductsController extends AppController {

	var $name = 'Products';

	function index() {

	}

}
?>

という訳で、index メソッドの中身を作ります。

再び、ブラウザをリロードすると、またエラーが変わります。

今度は ProductsController::index() に対応するビューが無いそうです。
ビューは、app/views/products/index.ctp に作りなさい、ということになっていますね。

ここでビューを適当に作ります。

<p>これは products テーブルのためのビューです。</p>
<?php

?>

再び、ブラウザをリロードすると、

めでたくエラーがなくなります。

…って、テーブルが表示されていないので、コントローラーとビューを直します。

<?php
class ProductsController extends AppController {

	var $name = 'Products';

	function index() {
		$this->set('Products', $this->Product->find('all'));
	}
}
?>

Product モデルから検索して、ビューに Products という名前で引き渡します。

これに合わせて、ビューも変えていきます。

<p>これは products テーブルのためのビューです。</p>

<table>
	<tr>
		<th>id</th>
		<th>name</th>
		<th>price</th>
	</tr>
<?php foreach($Products as $item) : ?>
	<tr>
		<td><?php echo $item['Product']['id'] ?></td>
		<td><?php echo $item['Product']['name'] ?></td>
		<td><?php echo $item['Product']['price'] ?></td>
	</tr>
<?php endforeach ; ?>
</table>

ここまできたら、きちんと表示ができます。

こういう風にひな型を作るって感じでしょうね。

よくできているというか感心するのが、足りない部分を単純なコンパイルエラーの表示ではなくて、足りないファイル、足りないメソッドの内容までを表示しているところです。 ASP.NET MVC の場合は、こんな風にはできていなくて、コンパイルエラーにならないように、どうしても、モデル→コントローラー→ビューの順序で作る必要があります(エラーを見ながらやってもいいんでしょうけど)。

このあたりは、PHP がスクリプト言語である利点を有効に活用しているのかなと。