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