Monlogの実装に学ぶInterfaceのつかいどころ

PHPConference福岡2023で発表した内容です。

プロポーザル内容
https://fortee.jp/phpconfukuoka-2023/proposal/9d76efbe-492e-499c-b8db-57eafb069d67

Transcript

1. Monologの実装に学ぶ Interfaceの使いどころ PHPカンファレンス福岡2023
2. 自己紹介
3. 自己紹介 名前：おぎ PHPer歴：3年 住んでるところ：秘境グンマー 所属：Innovator Japan.inc 特技：スノーボード
4. Innovator Japan Inc. 「人の可能性を最大限に引き出し、ウェルビーイングな社会を実現する 」 日本発のビジネスデザインカンパニー
5. 本日、カンファレンス初登壇🎉
6. アウトライン 1. Interfaceとは 2. MonologのInterface a. Monologとは b. 代表的なInterface c. HandlerInterface 3. まとめ
7. Interfaceとは
8. 自分のインターフェースのイメージ（約1年前） - 実装が書けない？これ何のためにあるの？ - ライブラリとか作る人じゃないと使わないんじゃないの？ - 実装を差し替えるなんてそうそうなくない？
9. インタフェース、インタフェイス、インターフェイスとも書き、英語で界面や接触 面、中間面などといった意味を持ち、転じてコンピュータと周辺機器の接続部分 を表すようになった。さらに、ユーザーインターフェースなどのように、人間と自 動機械との間の複雑な操作をする手順・規則との意味にも使われる。 出典: フリー百科事典『ウィキペディア（ Wikipedia）』より抜粋 インターフェース
10. JavaやC#などのオブジェクト指向プログラミング言語においてサポートされる、 実装を持たない抽象型のことである。これらの言語において、クラスは実装の 多重継承をサポートしない代わりに、任意の数のインタフェースを実装 (implement) することができ、これにより型の多重継承をサポートする。 出典: フリー百科事典『ウィキペディア（ Wikipedia）』より抜粋 インタフェース (抽象型)
11. なる...ほど...？🤔
12. キーワードっぽいもの - 抽象型...？ - 依存性逆転...？ - 振る舞い...？
13. Interfaceってよくわからない…🫠
14. MonologのInterface
15. Monologとは • PHP製のロガーライブラリ • Laravel、Symfonyでもデフォルトのロ ガーとして採用されている • ファイル、ソケット、メール、DBへのロ ギングをサポート • デフォルトではサポートされていない ログ転送も自前で実装することで拡 張可能 Monolog - Logging for PHP
16. 代表的なInterface Processor - ロギングの前処理（ホスト名の追加、UIDの付与等） Formatter - ログデータの加工処理（特定のフォーマットへの加工） Handler - ログの書き出し（ログの出力・記録）
17. LoggerInterfaceのDIの設定 Handlerと呼ばれるログの出力を 処理するクラスを登録
18. pushHandler()の実装 Interface！
19. HandlerInterface
20. Monolog/Loggerのメソッド内部
21. addRecord()内部（抜粋） 登録された各ハンドラーの handleメソッド の呼び出し
22. つまり 1. HandlerInterface実装した具象クラスを作成 2. ↑をpushHandlerでLoggerに登録 3. いい感じに整形したデータ（LogRecord）を渡してくれる！ ライブラリ側のコードを一切変えずに ログの出力先（≒ふるまい）を拡張可能
23. まとめ
24. Interfaceは「使う側」と「使われる側」を疎結合にする - MonologはHandlerが渡したLogRecordをどう処理するか知らない - HandlerはLogRecordがどんな処理をされて届くか知らない - 知らないからこそお互いに影響を受けにくい （≒拡張の自由度が高い） Monolog Handler Handler Interface handle() 呼んだことで 何が起こるかは知らない implements 約束を守ることで 整形済のデータ(LogRecord) を受け取れる
25. Interfaceのつかいどころ ≒後に実装の追加・変更が予想される箇所 例： - 通知（メール、Push） - アプリが利用する決済サービス（変更、追加等） - データストア（CSV、RDB、KV）
26. Interfaceを賢く使って 変更や拡張に強いプログラムを書こう！
27. 参考： - ちょうぜつソフトウェア設計入門 - 良いコード/悪いコードで学ぶ設計入門 - interfaceの本質と使いどころ - Monolog - Logging for PHP - PSR-3: Logger Interface
28. ご清聴ありがとうございました