Upgrade to Pro — share decks privately, control downloads, hide ads and more …

楽をするためのPHPDocと配列型の落とし穴 / PHPDoc and pitfalls of array

takaram
August 24, 2020

楽をするためのPHPDocと配列型の落とし穴 / PHPDoc and pitfalls of array

takaram

August 24, 2020
Tweet

More Decks by takaram

Other Decks in Programming

Transcript

  1. 自己紹介 • 名前 ◦ 荒巻 拓哉 • 所属 ◦ 株式会社ラクス

    ▪ 配配メール というサービスの開発をしてます
  2. その他の配列型の書き方 @return array<int> @return array<string, int> @return array{id: int, name:

    string} 上記3つはPhpStorm 2020.2では未対応
 (ただのarray扱いになる)

  3. まとめ • PHPDocを書くと楽できる ◦ 自動でドキュメントを作ってくれる ◦ IDEで補完できる ◦ 静的解析ができる •

    配列は要素の型も書く ◦ int[]形式 ◦ 連想配列はarray<string, int> か array{id: int}形式 ▪ ただしPhpStormは未対応 • PHPDocはしっかり書きましょう!!!
  4. 参考資料 • 2018年のPHPDoc事情とPSR-5 - Qiita https://qiita.com/tadsan/items/72b02339d12120ca37d7 • array shapes記法(Object-like arrays)と旧PSR-5記法で型をつける

    - Qiita https://qiita.com/tadsan/items/bfa9465166c351da37e5 • PSR-19: PHPDoc tagsを予習してみよう - BASE開発チームブログ https://devblog.thebase.in/entry/2019/12/14/110000