Friction River Software - CakePHP5入門【CakePHP5応用編②】データベース設計

Ｂ美

んじゃ、なにはともあれ「データベース」が必要だから、そこから設計していきましょう

Ａ子

詳細設計まで一気に進めちゃうの？

Ｂ美

ええ
「CakePHP」を利用するなら、それが一番効率的ね

Ｃ菜

掲示板への投稿を格納するためのテーブルと、アクセスログを記録するためのテーブルの二つがあれば良いんですよね～？

Ａ子

…と思うけどね（チラッ）

Ｂ美

私をチラ見すんなや（苦笑）

問題があったら適当に口をはさむから、あなたたちの思ったようにやりなさい

Ｃ菜

それじゃあ、まずは名前を決めましょう～

「データベース名」と二つの「テーブル名」ですね～

Ａ子

うーん、掲示板は英語で「BBS」だから、データベース名は「bbsdb」にしよう

投稿を格納するテーブルの名前は「toukou」、アクセスログのテーブル名は「log」で良いんじゃない？

Ｃ菜

え～
ローマ字はダサいですぅ～

英語にしましょうよ～
投稿用のテーブル名は「post」でどうですか～？

Ａ子

ダサいのか…
ま、まぁそれでも良いでしょう

んじゃ、名前はそれで決まりね

Ｂ美

ちょっと口を出させてもらうわよ

データベース名はそれで問題ないけど、テーブル名のほうは「複数形」にしてね
つまり、「posts」と「logs」ね

Ａ子

え？
なんでよ

Ｂ美

「CakePHP」における単なる「命名規則」ってこと

あ、複数の単語を組み合わせる場合は「スネークケース」でお願いね
（例えば「access_logs」って感じで…）

Ｃ菜

分かりました～

次は、テーブル設計ですね～

Ａ子

以前（開発環境構築編④）作った下記を参考にして、書き換えよう

create database testdb;

use testdb;

create table counters (
　id int auto_increment primary key,
　remarks varchar(255),
　counter int not null,
　created datetime,
　modified datetime
) charset=utf8mb4;

insert into counters values (1,'top',0,now(),now());

Ｃ菜

えっと～

create database bbsdb;

use bbsdb;

create table posts (
　・・・
　（ここに項目を記述）
　・・・
) charset=utf8mb4;

create table logs (
　・・・
　（ここに項目を記述）
　・・・
) charset=utf8mb4;

…で良いでしょうか～？

Ｂ美

良い感じなんだけど、各テーブルの先頭に「id」、末尾に「created」と「modified」を必ず記述してね
（もともとのやつのコピペで良いから…）

Ａ子

…ってことは

create database bbsdb;

use bbsdb;

create table posts (
　id int auto_increment primary key,
　・・・
　（ここに項目を記述）
　・・・
　created datetime,
　modified datetime
) charset=utf8mb4;

create table logs (
　id int auto_increment primary key,
　・・・
　（ここに項目を記述）
　・・・
　created datetime,
　modified datetime
) charset=utf8mb4;

こういうこと？

Ｃ菜

これも「CakePHP」の約束事ってことですか～？

Ｂ美

その通り

難しく考えずに、「そういうものだ」と思っておけば良いからね

Ａ子

よし、それじゃテーブルの項目を決めていこう

まずは「posts」からね

Ｃ菜

投稿の「タイトル」と「本文」は必須ですね～

あと、アップロードしたファイルの「保存場所」、それと「削除フラグ」ですかね～

Ａ子

えーっと、多分「int」が整数で、「varchar(255)」が文字列だと思うから

create table posts (
　id int auto_increment primary key,
　title varchar(255),
　body varchar(255),
　filepath varchar(255),
　delete_flag int,
　created datetime,
　modified datetime
) charset=utf8mb4;

…で良いのかな？

Ｂ美

惜しい点が二つあります

一つは「本文」を格納する項目（「body」という名の項目）のデータ型よ
（「varchar(255)」の「255」って最大文字数なの）

もう一つはファイルの「保存場所」だけじゃなく、（オリジナルの）「ファイル名」も格納しておきたいのよ

いや、アップロードしたファイルが日本語のファイル名だった場合、そのままでは画像ファイルへのリンクを張れないからね
（ファイル保存の際、ファイル名を半角英数字に変えて格納するから、元々のファイル名も残しておきたい…ってわけ）

Ａ子

うーん、なんだかよく分からないけど、「ファイル名」については了解…
（項目を一つ増やせば良いだけよね）

んで、「本文」のほうは「body」のデータ型を「varchar(100000)」とかにすれば良いの？

Ｂ美

違う違う

データベースには、大量の文字列を格納するためのデータ型がちゃんと用意されているのよ
（上限設定なしで…）

それが「text」型よ

Ｃ菜

ということは～

create table posts (
　id int auto_increment primary key,
　title varchar(255),
　body text,
　filename varchar(255),
　filepath varchar(255),
　delete_flag int,
　created datetime,
　modified datetime
) charset=utf8mb4;

…ってことでしょうか～？

Ｂ美

良い感じね

あ、余談だけど「delete_flag」は「int」型（整数型）じゃなくて「boolean」型（論理型）にしてもOKよ
（まぁ、将来の拡張性を考えた場合、「int」型のほうが良いと思うけどね…てか、私ならそうする）

Ａ子

あ、「not null」って必要なの？

Ｂ美

その項目を「必須入力」項目にしたければ付けたほうが良いかな

うっかり何も入れずに（NULL値のまま）レコード挿入した場合、エラーを出してくれるからね
（ただし「id」「created」「modified」には付けなくても良いわ）

Ｃ菜

だったら「title」と「body」、あと「delete_flag」には必要かも～

Ａ子

ふむ、それじゃこんな感じで…

create table posts (
　id int auto_increment primary key,
　title varchar(255) not null,
　body text not null,
　filename varchar(255),
　filepath varchar(255),
　delete_flag int not null,
　created datetime,
　modified datetime
) charset=utf8mb4;

Ｂ美

良いじゃない

次は「logs」テーブルね

Ｃ菜

アクセス元の「IPアドレス」と投稿したときの「番号」（「posts」テーブルの「id」の値）があれば良いんですよね～？

create table logs (
　id int auto_increment primary key,
　ip_address varchar(15),
　post_id int not null,
　created datetime,
　modified datetime
) charset=utf8mb4;

…って感じでしょうか～？

「IPアドレス」って「xxx.xxx.xxx.xxx」という形式なので、最大でも15文字ですから～

Ｂ美

ギリギリを攻めるのは止めておいたほうが良いわよ（苦笑）

少しは余裕を持たせないと…

Ａ子

それじゃ「ip_address」という項目のデータ型は「varchar(50)」にしよう
（キリの良いところで…）

えーっと、あとは何かあるかな？

Ｂ美

テーブルを作った後からでも、項目の「追加」や「削除」は可能だからね

とりあえずは、それでやってみましょう

Ａ子

それじゃ、まとめるよ

create database bbsdb;

use bbsdb;

create table posts (
   id int auto_increment primary key,
   title varchar(255) not null,
   body text not null,
   filename varchar(255),
   filepath varchar(255),
   delete_flag int not null,
   created datetime,
   modified datetime
) charset=utf8mb4;

create table logs (
   id int auto_increment primary key,
   ip_address varchar(50),
   post_id int not null,
   created datetime,
   modified datetime
) charset=utf8mb4;

…ってことになるね

Ｃ菜

これをＡ子社長と二人で作ったなんて、なんだかすごいですぅ～
（Ｂ美部長の助言があったとはいえ…）

Ａ子

確かにね

あとは、これを「bbsdb.sql」というファイル名で保存して、「mysql」コマンドを実行すれば良いのよね？