Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
PHPDocを活用する
Search
Hiroyuki Mito
February 27, 2023
Programming
0
56
PHPDocを活用する
Hiroyuki Mito
February 27, 2023
Tweet
Share
More Decks by Hiroyuki Mito
See All by Hiroyuki Mito
見直したいテーブル設計
hiroyukimito
0
75
Paiza CloudとVS Codeで快適な環境を作ろう! / Let's create a comfortable development environment with Paiza Cloud and Visual Studio Code !
hiroyukimito
0
430
Ruby以外から始めるエンジニア生活 PHP(Laravel)版 / Let's start an engineer other than Ruby !! PHP ver.
hiroyukimito
0
330
Other Decks in Programming
See All in Programming
設計の知識と技能で駆動するソフトウェア開発
masuda220
PRO
18
11k
生成 AI の中身を覗いてみよう〜基礎から医療現場での応用まで〜
soh9834
2
770
LLMチャットボットのアプリケーション設計Tips
os1ma
4
660
Why 1 + 1 = 2 in Swift?
1plus4
1
250
Swiftの型推論を学ぼう | Let's Learn About Type Inference in Swift
omochi
2
720
WebComponentsで フレームワークを1ページに共存させる
webuilder240
0
150
IntelliJ IDEA を知らなかった 自分に教えたい小ネタ集 / IntelliJ IDEA Hints for My Past Self
mackey0225
3
180
コミュニティに参加したことで起きた変化
ohmori_yusuke
3
130
Enhancing Applications with Accessibility API
kishikawakatsumi
3
1k
MySQL のインデックスの種類をおさらいしよう! / overviewing indexes in MySQL
okashoi
0
170
WasmOS: Wasmを実行する自作Microkernel
riru
0
370
複雑なドメインを扱うプロダクトの探索フェーズではいつどのようにテストをするのか / How to testing during exploratory phase
boykush
2
150
Featured
See All Featured
Designing the Hi-DPI Web
ddemaree
275
33k
Stop Working from a Prison Cell
hatefulcrawdad
265
19k
jQuery: Nuts, Bolts and Bling
dougneiner
57
7.1k
VelocityConf: Rendering Performance Case Studies
addyosmani
319
23k
Statistics for Hackers
jakevdp
789
220k
Side Projects
sachag
451
41k
In The Pink: A Labor of Love
frogandcode
137
21k
Sharpening the Axe: The Primacy of Toolmaking
bcantrill
14
1.3k
ReactJS: Keep Simple. Everything can be a component!
pedronauck
657
120k
Happy Clients
brianwarren
91
6.3k
Design and Strategy: How to Deal with People Who Don’t "Get" Design
morganepeng
113
18k
Optimizing for Happiness
mojombo
369
69k
Transcript
PHPDocを活⽤する
よく⾒るあのコメント実は +こんなコメントを⾒たことありますよね +/* + * @param int $value + *
@return array $result + */ +public function getData($value) +{ + return $result +}
よく⾒るあの コメント実は PHPDocと呼び、将来の ⾃分⾃⾝や他の開発者に 向けて情報を残します。 意識せずに記述している ⽅も多いのではないで しょうか?
コメントは 増やすべき? 減らすべき? 個⼈の考えですが極⼒コメントは少 なくするべきだと考えています。 その上でわかりやすく必要な情報を 理解できるように補⾜するものとし てコメントを残すことを意識します。 ではどのようにするかと⾔うと PHPDocと呼ばれるDocブロックを
残します。
PHPで型宣⾔って必要? +近年、静的型付け⾔語が流⾏していますがその中で得られる メリットとして主に3点挙げられます。 1. コンパイル時のエラー発⾒ 2. メモリ最適化 3. パフォーマンスの向上
PHPで型宣⾔って必要? +動的型付け、静的型付けそれぞれにメリットがありますが、 PHPを使⽤するメリットを享受しながら、 1. 事前にエラーを発⾒する 2. 他の開発者に使⽤⽤途や意図を伝える +という2点のために私は習慣づけるようになりました。
PHPDocによるメリット IDEによる解析・補完が使⽤できる 実⾏時に宣⾔された型であることを確認する 読み込みに必要な時間を短縮できる