CakePHP5入門【WebAPI編②】要件定義＆DB設計
Ｂ美
まずは要件定義からね
Ａ子
（あくまでも基本形であって、あとで変更するかもしれないけど…）
まずはExcelデータを取り込んだりするための管理画面が必要だね
Ｃ菜
（usersテーブルや認証機構を作るのは面倒です～）
Ａ子
トップページには各種WebAPIの説明文を表示して、右下くらいの位置に管理画面へのリンクを張ろう
Ｃ菜
Ａ子
当然、要るんじゃない？
Ｂ美
なので、できれば自動でデータを取得していく仕組みを作りたいところなんだけど、それってかなり難しいのよ（苦笑）
Ａ子
Ｂ美だったら、やり方を知ってるんでしょ？
Ｂ美
でも私もあまりやりたくはないかな
（だって難しいんだもん）
Ｃ菜
あ、とりあえずはExcelファイルのほうを更新（データ追加）して、それを随時読み込ませるようにしたらどうでしょう～？
インポート時に「すでにデータベースに存在するデータについては無視する」ようにすれば良いと思うんですよね～
（要するに、追加した分だけを読み込んでいくってことです～）
Ｂ美
それでいきましょう
Ａ子
WebAPIの仕様書って、どうすんの？
Ｂ美
URLと戻り値であるJSON形式の二つが分かれば良いわ
ただし、それについては「基本設計」の段階でやるべきことかな
Ａ子
「適切なURLを指定すれば、それに応じて適切なJSONデータを返す」
Ｃ菜
【要件定義】
|
・トップ画面にはWebAPIの説明文と管理画面（BASIC認証を行う）へのリンクを設ける
・管理画面ではExcelファイルのインポート処理のみを行う ・管理画面にはCRUD機能を実装しない ・適切なURLを指定すれば、それに応じて適切なJSONデータを返す ・WebAPIは基本的にナンバーズ3及び4の当選番号等の基礎情報を返すが、各種統計情報については別途追加していく |
こんな感じでいかがでしょうか～？
Ｂ美
では、次にデータベース設計ね
今回、そこまでやっておきましょう
Ａ子
|
create table numbers (
id int auto_increment primary key, lottery_time int not null, lottery_date datetime not null, num3 varchar(3) not null, num4 varchar(4) not null, created datetime, modified datetime ) charset=utf8mb4; |
「lottery_time」が実施回、「lottery_date」が抽選日で、「num3」がナンバーズ3の当選番号、「num4」がナンバーズ4の当選番号ね
Ｃ菜
Ｂ美
（○○年○月○日から××年×月×日の間…って感じの検索は、datetime型のほうがやりやすいからね）
まぁ、両方を持っておくというのも一つの方法だけど…
あと、曜日についてもあらかじめ算出しておいて、データベースに格納しておくってのが良いと思うわよ
Ａ子
|
create table numbers (
id int auto_increment primary key, #主キー lottery_time int not null, #実施回 lottery_date_dt datetime not null, #抽選日（日付型）→2026-02-27 lottery_date_str varchar(20) not null, #抽選日（文字列型）→2026年2月27日 lottery_week_int int not null, #抽選日の曜日（整数型）→0…日曜日,1…月曜日,2…火曜日,3…水曜日,4…木曜日,5…金曜日,6…土曜日 lottery_week_str1 varchar(10) not null, #抽選日の曜日1（文字列型）→日曜日,月曜日,火曜日,水曜日,木曜日,金曜日,土曜日 lottery_week_str2 varchar(5) not null, #抽選日の曜日2（文字列型）→日,月,火,水,木,金,土 num3 varchar(3) not null, #ナンバーズ3の当選番号 num4 varchar(4) not null, #ナンバーズ4の当選番号 created datetime, modified datetime ) charset=utf8mb4; |
それぞれの項目の意味はコメントに書いている通りね
Ｂ美
SQL文におけるコメントの書き方なんて教えてないのに…
Ｃ菜
Ｂ美
ほかにも「#」の代わりに「--」を使う方法もあるけどね
あ、ただしMySQLでは「--コメント」はエラーになるの
（「-- コメント」という書き方ならOK）
Ａ子
「--」の後ろに半角スペースを入れないとダメだってさ
Ｃ菜
（「年」と「月」と「日」の項目です～）
そのほうが検索しやすいんじゃないでしょうか～？
Ａ子
ついでに当選番号についても整数型項目を追加して、さらに各桁ごとの数値を整数型で持っておこうか
|
create table numbers (
id int auto_increment primary key, #主キー lottery_time int not null, #実施回 lottery_date_dt datetime not null, #抽選日（日付型）→2026-02-27 lottery_date_str varchar(20) not null, #抽選日（文字列型）→2026年2月27日 lottery_date_year int not null, #抽選日の年 lottery_date_month int not null, #抽選日の月 lottery_date_day int not null, #抽選日の日 lottery_week_int int not null, #抽選日の曜日（整数型）→0…日曜日,1…月曜日,2…火曜日,3…水曜日,4…木曜日,5…金曜日,6…土曜日 lottery_week_str1 varchar(10) not null, #抽選日の曜日1（文字列型）→日曜日,月曜日,火曜日,水曜日,木曜日,金曜日,土曜日 lottery_week_str2 varchar(5) not null, #抽選日の曜日2（文字列型）→日,月,火,水,木,金,土 num3_str varchar(3) not null, #ナンバーズ3の当選番号（文字列型） num3_int int not null, #ナンバーズ3の当選番号（整数型） num3_place1 int not null, #ナンバーズ3の当選番号の一の位 num3_place10 int not null, #ナンバーズ3の当選番号の十の位 num3_place100 int not null, #ナンバーズ3の当選番号の百の位 num4_str varchar(4) not null, #ナンバーズ4の当選番号（文字列型） num4_int int not null, #ナンバーズ4の当選番号（整数型） num4_place1 int not null, #ナンバーズ4の当選番号の一の位 num4_place10 int not null, #ナンバーズ4の当選番号の十の位 num4_place100 int not null, #ナンバーズ4の当選番号の百の位 num4_place1000 int not null, #ナンバーズ4の当選番号の千の位 created datetime, modified datetime ) charset=utf8mb4; |
これでどうよ（ドヤ顔）
Ｃ菜
簡単に調べられるのかどうかは分かりませんけど～
Ｂ美
PHPには便利なライブラリがあるから、簡単に求められるわよ
（ただし、そのライブラリって、今回は利用できないんだけどね（苦笑））
Ａ子
（整数型と文字列型の両方で）
|
create table numbers (
id int auto_increment primary key, #主キー lottery_time int not null, #実施回 lottery_date_dt datetime not null, #抽選日（日付型）→2026-02-27 lottery_date_str varchar(20) not null, #抽選日（文字列型）→2026年2月27日 lottery_date_year int not null, #抽選日の年 lottery_date_month int not null, #抽選日の月 lottery_date_day int not null, #抽選日の日 lottery_week_int int not null, #抽選日の曜日（整数型）→0…日曜日,1…月曜日,2…火曜日,3…水曜日,4…木曜日,5…金曜日,6…土曜日 lottery_week_str1 varchar(10) not null, #抽選日の曜日1（文字列型）→日曜日,月曜日,火曜日,水曜日,木曜日,金曜日,土曜日 lottery_week_str2 varchar(5) not null, #抽選日の曜日2（文字列型）→日,月,火,水,木,金,土 lottery_rokuyo_int int not null, #抽選日の六曜（整数型）→0…大安,1…赤口,2…先勝,3…友引,4…先負,5…仏滅 lottery_rokuyo_str varchar(10) not null, #抽選日の六曜（文字列型）→大安,赤口,先勝,友引,先負,仏滅 num3_str varchar(3) not null, #ナンバーズ3の当選番号（文字列型） num3_int int not null, #ナンバーズ3の当選番号（整数型） num3_place1 int not null, #ナンバーズ3の当選番号の一の位 num3_place10 int not null, #ナンバーズ3の当選番号の十の位 num3_place100 int not null, #ナンバーズ3の当選番号の百の位 num4_str varchar(4) not null, #ナンバーズ4の当選番号（文字列型） num4_int int not null, #ナンバーズ4の当選番号（整数型） num4_place1 int not null, #ナンバーズ4の当選番号の一の位 num4_place10 int not null, #ナンバーズ4の当選番号の十の位 num4_place100 int not null, #ナンバーズ4の当選番号の百の位 num4_place1000 int not null, #ナンバーズ4の当選番号の千の位 created datetime, modified datetime ) charset=utf8mb4; |
もう無いかな？
Ｃ菜
Ａ子
Google翻訳でも「六曜 → rokuyo」って、出たんだから（苦笑）
Ｂ美
まぁ、「最低限のデータから得た結果をそのつど加工する方法」と、「あらかじめ加工済みのデータを持っておく方法」のどっちが良いかって話なんだけどね
Ｃ菜
Ｂ美
統計情報を集計するときって、最新のデータを含めて計算しないとダメなんだけど、毎回「曜日計算」や「六曜計算」をやってられないってわけ
（一回だけ計算して、その結果を保存しておくほうが合理的だからね）
Ａ子
それじゃ、以下のSQL文を読み込ませるよ
（ファイル名は「numbersdb.sql」にしたからね）
|
create database numbersdb;
use numbersdb; create table numbers ( id int auto_increment primary key, #主キー lottery_time int not null, #実施回 lottery_date_dt datetime not null, #抽選日（日付型）→2026-02-27 lottery_date_str varchar(20) not null, #抽選日（文字列型）→2026年2月27日 lottery_date_year int not null, #抽選日の年 lottery_date_month int not null, #抽選日の月 lottery_date_day int not null, #抽選日の日 lottery_week_int int not null, #抽選日の曜日（整数型）→0…日曜日,1…月曜日,2…火曜日,3…水曜日,4…木曜日,5…金曜日,6…土曜日 lottery_week_str1 varchar(10) not null, #抽選日の曜日1（文字列型）→日曜日,月曜日,火曜日,水曜日,木曜日,金曜日,土曜日 lottery_week_str2 varchar(5) not null, #抽選日の曜日2（文字列型）→日,月,火,水,木,金,土 lottery_rokuyo_int int not null, #抽選日の六曜（整数型）→0…大安,1…赤口,2…先勝,3…友引,4…先負,5…仏滅 lottery_rokuyo_str varchar(10) not null, #抽選日の六曜（文字列型）→大安,赤口,先勝,友引,先負,仏滅 num3_str varchar(3) not null, #ナンバーズ3の当選番号（文字列型） num3_int int not null, #ナンバーズ3の当選番号（整数型） num3_place1 int not null, #ナンバーズ3の当選番号の一の位 num3_place10 int not null, #ナンバーズ3の当選番号の十の位 num3_place100 int not null, #ナンバーズ3の当選番号の百の位 num4_str varchar(4) not null, #ナンバーズ4の当選番号（文字列型） num4_int int not null, #ナンバーズ4の当選番号（整数型） num4_place1 int not null, #ナンバーズ4の当選番号の一の位 num4_place10 int not null, #ナンバーズ4の当選番号の十の位 num4_place100 int not null, #ナンバーズ4の当選番号の百の位 num4_place1000 int not null, #ナンバーズ4の当選番号の千の位 created datetime, modified datetime ) charset=utf8mb4; |
Ｃ菜
| mysql -u root -p < numbersdb.sql[Enter] |
上記のコマンドを「MATE端末」上で実行しますね～
Ａ子
|
mysql -u root -p numbersdb[Enter]
show fields from numbers;[Enter] |
Ｂ美
それじゃ、今回はここまでにしておきましょう
次回はWebアプリケーションを作っていくわよ
Ｃ菜
