Slide 1

Slide 1 text

www.bengo4.com PHPのエラーを理解して 適切なエラーハンドリングを学ぶ PHPerKaigi 2022 2022.4.9 namizato

Slide 2

Slide 2 text

2 2 並里 辰也(ナミザト タツヤ) 自己紹介 弁護士ドットコム株式会社 在籍そろそろ2年 Laravelが好きだったけど2年位あまり追えてない 最近はバスケばかりしてる @namizatork

Slide 3

Slide 3 text

Bengo4.com, Inc. ● 一般市民と弁護士を結びつ け、お悩み解決を目指す ● 2005年サービス開始 ● 利用者数 約1,000万人/ 月 ● 累計法律相談数 約100万件 3 弁護士ドットコム というサービス https://www.bengo4.com

Slide 4

Slide 4 text

Bengo4.com, Inc. 弁護士ドットコム Creators’ Blog https://creators.bengo4.com 最新の記事 postcss-preset-envで少し未来のCSSを予習す る デザイナーに優しい HTMLテンプレートの開発方 針をボトムアップで作った話 サービス運用10年以上の重み、弁護士ドットコム のユニットテスト速度改善 弁護士ドットコムサービスのビジネスと共にみるマ イクロサービスの進化 4

Slide 5

Slide 5 text

Bengo4.com, Inc. 目次 ● 今回の対象者と話す内容 ● エラーについて ● エラーハンドリングについて ● PHPの例外について ● エラーハンドリングを学ぶ ● 振り返り 5

Slide 6

Slide 6 text

今回の対象者と 話す内容 6

Slide 7

Slide 7 text

Bengo4.com, Inc. 今回の対象者と話す内容 ● 対象者 ○ エラーハンドリングという言葉は知ってるけど何をするの?という人 ○ PHPのエラー?とりあえずいつもググってるよ!という人 ● 話す内容 ○ エラーについて ○ エラーハンドリングについて ○ 適切なエラーハンドリング 7

Slide 8

Slide 8 text

Bengo4.com, Inc. (一応)本内容での言葉を統一しておく ● エラー(エラー処理) ● エラーハンドリング(例外処理) ● 例外(Exception) 8

Slide 9

Slide 9 text

エラーについて 9

Slide 10

Slide 10 text

Bengo4.com, Inc. エラーについて 実行中のプログラムが正常に処理を続行できなくなるような問題・事態のこと。 10

Slide 11

Slide 11 text

Bengo4.com, Inc. PHPのエラー ● PHPのエラーは大きく分類して、致命的なエラー と 警告・注意 が存在する ○ 致命的なエラー ■ 現在の処理を中断する、はよ直せ(怒り) ○ 警告・注意 ■ 現在の処理は中断しないけど、直した方がいいよ(ハナホジ) 11

Slide 12

Slide 12 text

Bengo4.com, Inc. PHPの致命的なエラー / 警告・注意 を一部抜粋 ● 致命的なエラー ○ Fatal error(存在しない関数を呼び出すなどで発生) ○ Parse error(PHPの文法で間違いがあった時などで発生) ● 警告・注意 ○ Warning(存在しないファイルを呼び出した時などで発生) ○ Notice(定義されていない変数を使用した時などで発生) 12

Slide 13

Slide 13 text

Bengo4.com, Inc. 13 Warning や Notice は php.ini などの設定次第で無視 (いわゆる白い画面のアレを表示しない)することは可能。 バグの発生要因になるので、推奨はしない。

Slide 14

Slide 14 text

エラーハンドリングにつ いて 14

Slide 15

Slide 15 text

Bengo4.com, Inc. エラーハンドリングについて プログラムがエラーを起こした時にすぐに実行を終了せずにあらかじめ用意しておいた 処理を行うこと。 ユーザー操作によって解決できない問題があった場合に対処するための処理。 15

Slide 16

Slide 16 text

Bengo4.com, Inc. PHPのエラーハンドリング 5系から導入された try - catch で記述する。 例外が発生し得る箇所を try {} で囲み、例外が発生した時点で後続する処理は中断 され catch {} で受け取り、例外が発生した時の対応(ハンドリング)を行う。 例外を明示的に(ほとんどはこのケースだと思うが)発生させたい場合は、 該当する箇所で throw を用いる。 16

Slide 17

Slide 17 text

Bengo4.com, Inc. PHPのエラーハンドリング書き方 17

Slide 18

Slide 18 text

PHPの例外について 18

Slide 19

Slide 19 text

Bengo4.com, Inc. 19 実は前述した「PHPのエラー」で紹介した致命的なエラーなどの一部は try - catch で捕捉できません。(方法はあるにはある) ですが、大抵の場合それらを捕捉する必要はありません。 次のページで簡単に PHP の例外について 触れながら説明していきます。

Slide 20

Slide 20 text

Bengo4.com, Inc. PHPの例外(Exception) 5系までは、全ての致命的エラーはエラーハンドリングがで きず処理がそこで中断されてしまいます。 しかし、7系からは Throwable インターフェースが実装さ れ、それを継承した Exception と Error が導入されまし た。そのおかげで致命的エラーの多くが Error をスローす るようになり、捕捉が可能になりました。 右の図(by @ngyuki)は例外の継承関係を図にしたもの です。 20

Slide 21

Slide 21 text

Bengo4.com, Inc. PHPの例外(Exception) しかし、致命的なエラーの全てが Error に実装されたわけ ではないのが現状です。 ですが、先述した通り全てを捕捉する必要はありません。 大抵のエラーはプログラムやFW側が検知してくれているの で、実装者は開発中に起きたエラーを修正するだけで済み ます。そのためそれらをエラーハンドリングする必要はあり ません。 21

Slide 22

Slide 22 text

エラーハンドリングを学 ぶ 22

Slide 23

Slide 23 text

Bengo4.com, Inc. 23 エラーハンドリングというものについては少しは理解できたけど、 必要性は?どういう時に使えばいいの?など疑問が残っていると思います。 なので、一つ一つQ&A方式で説明していきます。

Slide 24

Slide 24 text

Q. エラーハンドリング を使わないとどうなる の? 24

Slide 25

Slide 25 text

Bengo4.com, Inc. Q. エラーハンドリングを使わないとどうなるの? 25 Answer 1. エラーの発生箇所や原因の特定が難しくなる 2. エラー発生後も後続の処理が実行されてしまう 3. エラーが起きていることをユーザーが認知できない 詳しい説明は次の質問と繋がるので省きます。

Slide 26

Slide 26 text

Q. エラーハンドリング はどんな時に用いる の? 26

Slide 27

Slide 27 text

Bengo4.com, Inc. Q. エラーハンドリングはどんな時に用いるの? 27 Answer 1. エラーの発生箇所や原因の特定をしたい時 2. エラー発生後に後続の処理を中断させて、別の対応をしたい時 3. エラーが起きていることをユーザーに通知したい時

Slide 28

Slide 28 text

Bengo4.com, Inc. エラーの発生箇所や原因の特定をしたい時 28 例外が発生した内容を catch句 で受け取り、メッセージなどをロギングしておけば、 発生箇所や発生日時、原因の特定が容易になる。

Slide 29

Slide 29 text

Bengo4.com, Inc. エラー発生後に後続の処理を中断させて、別の対応をしたい時 29 例外を受け取ったら処理は中断させて、別の対応をしたい時はロギングの時と同様に catch句 の中で行いたい処理を書く。 その際、return をしないと後続してしまうので注意!

Slide 30

Slide 30 text

Bengo4.com, Inc. エラーが起きていることをユーザーに認知したい時 30 こちらも先ほど同様に catch句 で例外を受け取ったら return で呼び出し元かユーザーにエラーを通 知する。 この対応が抜けているとユーザーは処理が問題なく対処されたと認識してしまう。

Slide 31

Slide 31 text

Q. エラーハンドリング を考えるうえで大事な ことは? 31

Slide 32

Slide 32 text

Bengo4.com, Inc. Q. エラーハンドリングを考えるうえで大事なことは? 32 Answer 1. 例外を握り潰さない(物理的にではない) 2. エラーハンドリングのスコープは狭く 3. 補足すべき例外とそうでない例外を理解しよう

Slide 33

Slide 33 text

Bengo4.com, Inc. 例外を握り潰さない 33 せっかく例外を throw しても catch句 で何もしなければエラーを無視してるも同然です。 catch句 ではロギングの他にエラーの発生を呼び出し元に伝える、後続処理を行わないために return するなど、要件に応じた対応をしましょう。

Slide 34

Slide 34 text

Bengo4.com, Inc. エラーハンドリングのスコープは小さく 34 様々な例外を全部一つの try {} の中におさめて、catch は全て Exception で拾ってしまっている try {} の範囲が広いと例外が発生した 時の特定が難しくなる。 さらに catch句 は全て Exception で受け取るのではなく、それぞれ適切 な例外クラスを用意して利用しましょ う。

Slide 35

Slide 35 text

Bengo4.com, Inc. 補足すべき例外とそうでない例外 35 ● 補足すべき例外 ○ 例外発生以降も処理が続けられてしまうとデータ不整合など障害に繋がってしまう時 ○ 例外発生後に呼び出し元やユーザーへの通知、ロギングなどを行いたい時 ○ 例外発生前に行っている処理や状態をロールバックしたい時 ● 補足すべきでない例外 ○ 開発時に対処できるタイプエラーなどの例外 ○ 例外が発生しても、その後に回復処理などが行えない時

Slide 36

Slide 36 text

振り返り 36

Slide 37

Slide 37 text

Bengo4.com, Inc. ここまで学んだエラーハンドリングを振り返る 37 基幹システムにユーザーとポイント情 報をAPIでpostしているが、何らかの エラーになってもユーザーにはポイン トが付与されたままになってしまう。

Slide 38

Slide 38 text

Bengo4.com, Inc. ここまで学んだエラーハンドリングを振り返る 38 基幹システムへのAPIで成功レスポン ス(200)が返ってこなかった場合に、 例外を throw して、 ユーザーに対して付与していたポイン トをロールバック。 その後開発者向けにロギングと通知、 リダイレクトしてユーザーにエラーが あって、ポイントを付与d系なかったこ とを伝える。

Slide 39

Slide 39 text

ご清聴ありがとう ございました。 39