改めて学ぶ Trait の使い方 / phpcon odawara 2025

by meihei

Slide 1

Slide 1 text

Slide 2

Slide 2 text

Slide 3

Slide 3 text

キーノートセッション 🍥かま　10:20ｰ Saki Takamachi 改めて学ぶ Trait の使い方 🍥ぼこ　11:00ｰ meihei 新しいPHP拡張モジュールインストール方法「PHP Installer for Extensions (PIE)」を使ってみよう！ 🍥あじ　11:00ｰ 02 New RelicのAPMを活用した ECサービスにおけるメール遅延解消の舞台裏 🍥かま　15:10ｰ Futoshi Endo BASEで活躍するメンバーの登壇予定スポンサーセッション川口将貴 🍥かま　11:55ｰ

Slide 4

Slide 4 text

No content

Slide 5

Slide 5 text

© 2012-2025 BASE, Inc. 5 #phpcon_odawara #boko ● トレイトの使い所を見極められるようにする ● よりトレイトを使いこなすヒントを知る Non goal ● 明日からトレイトを使いたい！と思わせる事このトークのゴール ※ それと、プロポーザルに書いていた「実務のコードで合った良い・悪い使われ方」は時間に収まらなかったので Ask the speaker とかで話しましょう 🙇

Slide 6

Slide 6 text

Slide 7

Slide 7 text

Slide 8

Slide 8 text

© 2012-2025 BASE, Inc. 8 #phpcon_odawara #boko ざっくり説明 ● コードを再利用するため仕組み ● クラスに似て、メソッドやプロパティが書ける ● 優先順位は現在のクラス → トレイト → 継承元のクラスとなる ○ デフォルト実装を容易する目的で利用される trait Hello { public function sayHello() { echo 'Hello '; } } class HelloWorld { use Hello; public function sayHello() { parent::sayHello(); echo 'World!'; } }

Slide 9

Slide 9 text

Slide 10

Slide 10 text

© 2012-2025 BASE, Inc. 10 © 2012-2025 BASE, Inc. 10 ” その前に前提として DI（合成）で済むならそっちのほうがいい [出典] 五十嵐進士「導入から 10 年、PHP の trait は滅びるべきなのかーーその適切な使いどころと弱点、将来について」P51 https://www.slideshare.net/slideshow/10-php-trait/253165328

Slide 11

Slide 11 text

Slide 12

Slide 12 text

Slide 13

Slide 13 text

Slide 14

Slide 14 text

Slide 15

Slide 15 text

Slide 16

Slide 16 text

Slide 17

Slide 17 text

Slide 18

Slide 18 text

Slide 19

Slide 19 text

Slide 20

Slide 20 text

Slide 21

Slide 21 text

Slide 22

Slide 22 text

© 2012-2025 BASE, Inc. 22 #phpcon_odawara #boko ● クラスに役割ではなく振る舞いを一時的に貸したいとき ○ 「このオブジェクトが何かを担う」よりも「何かできるようにする」 ○ Notiﬁable, EventStorable など ● 複数のクラスに横断的に補助的な機能を提供したいとき ○ ドメインロジックの中心ではない部分の共通化 ○ DTO の toArray() など ● Interfaceのデフォルト実装を提供したいとき ○ 最も王道のパターン ○ 「責務はインターフェースに定義」「振る舞いはトレイトで補助」トレイトの使い所

Slide 23

Slide 23 text

Slide 24

Slide 24 text

Slide 25

Slide 25 text

© 2012-2025 BASE, Inc. 25 #phpcon_odawara #boko 多分前半の話が長いので記事を紹介 ● OSS ライブラリを調べてまとめた記事 ● 時間的にこの発表では喋れない部分を紹介しています ● 実際に我々が書くコードでは３つの使い方と３つのテストパターンになる https://zenn.dev/meihei/articles/0191f119-65f9-7bb5-ad43-c35d120b8425

Slide 26

Slide 26 text

© 2012-2025 BASE, Inc. 26 #phpcon_odawara #boko ● インターフェースのデフォルト実装 ○ aws/aws-sdk-php の S3ClientTrait ○ guzzle/psr7 の MessageTrait ● クラスの分割実装 ○ briannesbitt/Carbon の Comparison や Rounding ● 偶然同じ機能を持つクラスの実装の共通化 ○ laravel/framework の Macroable OSS ライブラリで使われているトレイト

Slide 27

Slide 27 text

© 2012-2025 BASE, Inc. 27 #phpcon_odawara #boko ● クラスに役割ではなく振る舞いを一時的に貸したいとき ○ 偶然同じ機能を持つクラスの実装の共通化 ● 複数のクラスに横断的に補助的な機能を提供したいとき ○ 偶然同じ機能を持つクラスの実装の共通化 ● Interfaceのデフォルト実装を提供したいとき ○ そのままインターフェースのデフォルト実装トレイトの使い所と使い方

Slide 28

Slide 28 text

© 2012-2025 BASE, Inc. 28 #phpcon_odawara #boko ● クラスに役割ではなく振る舞いを一時的に貸したいとき ○ 偶然同じ機能を持つクラスの実装の共通化 ● 複数のクラスに横断的に補助的な機能を提供したいとき ○ 偶然同じ機能を持つクラスの実装の共通化 ● Interfaceのデフォルト実装を提供したいとき ○ そのままインターフェースのデフォルト実装トレイトの使い所と使い方ライブラリの提供する側でよく見る

Slide 29

Slide 29 text

Slide 30

Slide 30 text

Slide 31

Slide 31 text

Slide 32

Slide 32 text

Slide 33

Slide 33 text

© 2012-2025 BASE, Inc. 33 #phpcon_odawara #boko ● テストの対象をトレイト単位で見ている ○ テスト専用のクラスを作成してテストする場合と同じ ● 定義したテスト専用クラスに名前をつけたく無い場合に有効 ● 参考実装 ○ symfony/symfony, googleapis/google-auth-library-php 無名クラスを作成してテストする

Slide 34

Slide 34 text

© 2012-2025 BASE, Inc. 34 #phpcon_odawara #boko ● テストコードからトレイトを use する ○ トレイトの振る舞いをテストコードが持つことになり、テストクラスの責任が不明確になる ● TestCase::getMockForTrait, TestCase::getObjectForTrait を使う ○ PHPUnit12で削除された ● トレイトの private / protected メソッドをテストする ○ トレイトをクラスの実装の一部と見ると、クラスの private / protected メソッドをテストすることがおかしいとわかる NGなトレイトのテストの書き方

Slide 35

Slide 35 text

© 2012-2025 BASE, Inc. 35 #phpcon_odawara #boko ● トレイトは「便利な振る舞い」を再利用するために使う ○ が、ほとんどの場合は DI （依存性注入）がいい ● トレイトの使い所としては３つ ○ クラスに役割ではなく振る舞いを一時的に貸したいとき ○ 複数のクラスに横断的に補助的な機能を提供したいとき ○ Interfaceのデフォルト実装を提供したいとき ● トレイトのテスト（オススメ）は３つ ○ トレイトを use したクラスをそのままテストする ○ テスト専用のクラスを作成してテストする ○ 無名クラスを作成してテストするまとめ

Slide 36

Slide 36 text