CakePHP3のチュートリアルの前半から学んだこと

## CakePHP3のチュートリアル

チュートリアルと例 - 3.6

コードを書き写して動かしてみて面白かった。全然コード書いてないのに色々動いててびびる。

## コード

github.com

docker-composeにmysqlの設定と初期化SQLを入れといたから、たぶん、docker-compose upしてcomposer installしてlocalhost:8000にアクセスしたら動くんちゃうかな。

以下、学んだことのメモ。

## Articlesまわり

### Model

Modelの中にTableとEntityがあって、役割の違いは何だろう？と思ったら、こういうことみたい。

• Table: DBのテーブルにアクセスするためのもの
• Entity: DBのレコードを表すもの

### ArticlesTable

• Tableを継承
• 名前でDBテーブルと紐付けられる
• 初期化時にBehaviorを追加することでテーブルの操作に対する振る舞いを追加できる
  • https://book.cakephp.org/3.0/ja/orm/table-objects.html#id7

### (Entity) Article

• Entityを継承
• 名前でテーブルと紐付けられてる
• 一括代入用の設定をしてる
  • https://book.cakephp.org/3.0/ja/orm/entities.html#mass-assignment

### ArticlesController

• AppControllerを継承
• loadComponentでロードしたコンポーネントが$this->Paginatorみたいにして利用できるようになるみたい
  • https://book.cakephp.org/3.0/ja/controllers/components.html#id5
• Tableクラスには$this->Articles->find()みたいにアクセスしてるけど、デフォルトでArticles(Table)と紐付けられてるってことなんだろうな
• $this->set()でViewにデータを渡してる
• compact()は何だろう？と思って見てみた。なるほどー。

へー！

CakePHP compact使おうぜ - Code Life https://t.co/nvkKx5PZfj @__notoさんから

— Mitsuyuki Shiiba (@bufferings) 2018年9月23日

### (Template) index.ctp

• テンプレートファイルは、名前の規約でコントローラーのクラス名とメソッド名から引っ張ってくる
• slugってどういう意味なんだろう？と思って見てみた。なるほどー。

へー / “ソフトウェアの世界での slug / スラグ / スラッグの意味 - valid,invalid” https://t.co/NLSYvrLNJP

— Mitsuyuki Shiiba (@bufferings) 2018年9月22日

• テンプレートにはHelperがあって便利メソッドを提供
• Htmlヘルパーのlink生成
  • https://book.cakephp.org/3.0/ja/views/helpers/html.html#id5
• DATE_RFC850はdefineされてたdefine ('DATE_RFC850', "l, d-M-y H:i:s T");

### ArticlesControllerのviewアクション

• findBySlugは動的ファインダーか
  • https://book.cakephp.org/3.0/ja/orm/retrieving-data-and-resultsets.html#dynamic-finders
• パスパラメーターが引数で渡されてる
• Flashは一旦セッションに保存されて利用されると消えるやつか
  • https://book.cakephp.org/3.0/ja/views/helpers/flash.html
• __()はi18n対応したメッセージ表示用の関数
  • https://book.cakephp.org/3.0/ja/core-libraries/global-constants-and-functions.html#__
• h()はXSS対策用のエスケープ
  • https://book.cakephp.org/3.0/ja/core-libraries/global-constants-and-functions.html#h
• Formヘルパーでフォーム周りを生成。バリデーションが設定されてる場合はそれも反映されるっぽい
  • https://book.cakephp.org/3.0/ja/views/helpers/form.html#automagic-form-elements
• そのバリデーションはこんなの
  • https://book.cakephp.org/3.0/ja/orm/validation.html#id3
• TableのbeforeSaveで保存前に実行したい処理を書ける
  • https://book.cakephp.org/3.0/ja/orm/table-objects.html#beforesave
• へー。slugを生成するためのユーティリティがあるんだ
  • https://book.cakephp.org/3.0/ja/core-libraries/text.html#url
• FormヘルパーのPostLink生成。JS使ってPostするっぽい
  • https://book.cakephp.org/3.0/ja/views/helpers/form.html#id43

## 前半のメモはこれくらい

感想は

• 規約
  • 規約に従ってやってたら色々裏側でいい感じにしてくれるので便利
  • なんだけど、裏側で何をしてるのかを把握しとかなきゃ想定外の穴があきそうで怖い
• PhpStorm
  • 思ったよりサクサク書ける。Javaほどじゃないけど
  • 名前の規約を元にジャンプできるプラグインがあるといいなぁ
  • PHPCSとPHPMDの設定はちょっと考えたほうが良さそう。不要なのが出る
• ドキュメント
  • を読むためのとっかかりのインデックスが自分の中にできてきたので良かった

後半は、また気が向いたら書こう。

• CMS チュートリアル - タグとユーザー
• CMS チュートリアル - 認証

## （おまけ）IDEAのショートカット

コピペじゃなくて実際に見ながら書いてた理由は、PhpStormで書く感触を知りたかったからで。1個覚えた。

• 「あとは分かるやろ」って思ったときにCtrl + Shift + Enterを叩くといい感じにしてくれる

あとは、IdeaVimを入れてできるだけ矢印キーを使わずに頑張ってみた。まだ慣れない。