依存を意識して安定した変更に強いコードを書こう

依存を意識して安定した変更に強いコードを書こう良いコードの書き方勉強会 in 京都 2024/8/17 あかつか

自己紹介 • あかつか X: aki_artisan • 神戸でPHP書いてます • レガシーPHPをLaravelに移植 •
PHPカンファレンス関西2025実行委員長 2

そもそも良いコードとは？ • 読みやすいコード • 保守しやすいコード • 変更しやすいコード • パフォーマンスが良いコード •
安全なコード • バイト数が少ないコード（コードゴルフではね） 3

つまり、良いコードとは？ • 読みやすいコード • 保守しやすいコード • 変更しやすいコード • パフォーマンスが良いコード •
安全なコード • バイト数が少ないコード（コードゴルフではね）目的を満たすコード 4

ソフトウェア開発において良いコードとは？ • 自社プロダクトか受託で作るシステムなのかにもよる ◦ 仕様が変化しづらく、再現性を求められる？ ◦ 環境に適用して柔軟に振る舞いを変えていくことが求められる？ ◦ パフォーマンス最優先？目的によって、良いコードは異なる
自分たちで考えていくことが大事 5

今回は自社プロダクト開発の文脈で話しますプロダクト開発にはアジリティが求められる作ったものが正しいとは限らない頻繁に機能拡張や、仕様変更、バグ修正、リファクタリングが行われる 6

変更しやすく保つ必要があるアジリティを失わないようにするためには、変更しやすく保つ必要がある • テストコードを書く • 疎結合な状態を保つ • こまめにリファクタリングする 7

変更しにくくなる原因は？ • 影響範囲がわからない • 複数の責務をもつクラスやメソッド、関数がある • 大事なところほど、手が入りやすくどんどん複雑になっていく依存関係が複雑になっている 8

「依存」をキーワードに考えてみよう 9

「依存」ってなんだか難しい？ AがBに依存している→ピンとこない大胆に「AがBを使っている」と言い換えよう！ AがBを使っている。Bがないと機能しない。AはBに依存している。 AはBを使っている。だから、Bの変更の影響を受ける。 10

依存しているとは使っているということ 12

「AがBに依存ている」とは A B AがBを使っている状態 13

例：「ユーザー登録機能がメール送信機能を使っている」ユーザー登録機能メール送信機能 AがBを使っている状態 14

依存すると何が困るのか 15

依存すると変更の影響をうける（A視点） A B AがBを使っている状態変更影響が波及 16

依存されると変更しづらくなる（B視点）共通モジュールを変更したら、いろいろなところでバグが波及した！ A B AがBを使っている状態変更しづらい 17

実際のプロダクト開発では実際の世界では、依存先（われわれが使うもの）は外部のものだったりするメリットの方が大きいので依存することを選んでいるとも言えるわたしたちのプロダクト Laravel PHP 18

実際のプロダクト開発ではわたしたちのプロダクト Laravel PHP LaravelやPHPのバージョンアップに振り回されるのはこのためだからこそ、できるだけ安定なものに依存したい → 依存注入というアプローチが一役買う 19

実演：依存性を注入してみよう 20

最初の状態ログ出力処理がべた書きログ出力の仕様を変えたい時、毎回全ての箇所で変更しないといけない 21

level1 : ログ出力を外部に委譲ログ出力処理を切り出した 22

level1 : ログ出力を外部に委譲ログ出力処理を切り出した直接ロガーを使っている 23

level2 : ログ出力用クラスを外から与えるどのロガーを使うかを外から与えるようにしたログ出力機能との結合が疎になった 24

level2 : ログ出力用クラスを外から与えるどのロガーを使うかを外から与えるようにしたログ出力機能との結合が疎になった 25

level3 : ログ出力用のインターフェースに依存させる logメソッドを持てば良い（抽象化） 26

level3 : ログ出力用のインターフェースに依存させる logメソッドを持てば良い（抽象化） 27 抽象に依存するとより安定に

依存を外から与えるメリット 28

依存を外から与えると差し替えることができる • テストがしやすい ◦ 例えばテストの時はログ出力をオフにしたい、などの場合、 logメソッドの実装が空のモックで置き換えるなどで、安全にテストが行える ◦ 時間がかかる、お金がかかる、副作用が許容できない、など様々なパターンに対応できる •
拡張性が上がる ◦ 既存の部分に影響を与えることなく、別の実装を使うように差し替えることが可能 • 依存関係が追いやすい 29

良いコードの書き方 30

良いコードを書くには依存を意識する • 変更しづらいコードはビジネスとして価値を産みづらい • 無自覚な依存はコードを変更しづらくする • 「これに依存して大丈夫？」「これはどのくらい安定？」と問いかける • 依存しないといけない時は、依存を外から与えるようにする ◦
コンストラクタ経由で与える ◦ Laravelだと、サービスコンテナを使うなど 31

おすすめ資料① https://speakerdeck.com/blue_goheimochi/phperkaigi2024 32

おすすめ資料② なぜ依存を注入するのか　DIの原理・原則とパターン (Compass Booksシリーズ) 33

まとめ • 依存とは使っているということ • 変更の影響を受けないように、安定なものに依存しよう • 依存を外から与えるようにすると疎結合になる（依存注入） •
何が何を使っているかを意識してプログラミングしよう • 依存する時は、「それはどのくらい安定？」を考えるようにしよう 34

依存を意識して安定した変更に強いコードを書こう

依存を意識して安定した変更に強いコードを書こう

akatsuka

More Decks by akatsuka

Other Decks in Technology

Featured

Transcript