PHPで始める振る舞い駆動開発(Behaviour-Driven Development)

#phpcon #track4  PHPで始める振る舞い駆動開発   (Behaviour-Driven Development)  PHP Conference Japan 2025 
うーたん  PHPカンファレンス2025 公式ロゴより 

#phpcon #track4  自己紹介  2 

#phpcon #track4  自己紹介  • うーたん  ◦ 𝕏：@uutan1108  • 株式会社ゆめみ  ◦
サーバーサイドエンジニア  ◦ 技術広報  イベント開催するので   来てください！！   3 

#phpcon #track4  第一章    振る舞い駆動開発って何？   4 

#phpcon #track4  テストを書いていますか？   5 

#phpcon #track4  テストを書くメリット   • 早い段階で不具合を検知できる  • 要件／仕様を理解しやすくなる  • 開発者の負担を軽減できる 
6 

#phpcon #track4  テスト駆動開発とは  7 

#phpcon #track4  テスト駆動開発 (TDD)  テスト駆動開発 (てすとくどうかいはつ、英: test-driven development; TDD) とは、プログラム開発手法の一種で、プログラムに必要な各機能
について、最初にテストを書き（これをテストファーストと言う）、そのテストが動作する必要最低限な実装をとりあえず行なった後、コードを洗練させる、という短い工程を繰り返すスタイルである。  多くのアジャイルソフトウェア開発手法、例えばエクストリーム・プログラミングにおいて強く推奨されている。近年はビヘイビア駆動開発へと発展を遂げている。  引用元：https://ja.wikipedia.org/wiki/テスト駆動開発  8 

#phpcon #track4  TDDのサイクル   • 最初にテストを書き  • そのテストが動作する必要最低限な実装をとりあえず行なった後  •
コードを洗練させる  という短い工程を繰り返す  画像引用元：https://service.shiftinc.jp/column/4654/  9 

#phpcon #track4  振る舞い駆動開発 (ビヘイビア駆動開発 )とは  10 

#phpcon #track4  ビヘイビア駆動開発   (英: behaviour-driven development;BDD)  テスト駆動開発で記述されるテストケースは、作成したプログラムの動作が正しいかどうかを検証するために行う「テスト」である。テストであるという点は同一であるが、加えて、これ
から作成しようとするプログラムに期待される「振る舞い」や「制約条件」、つまり「要求仕様」に近い形で、自然言語を併記しながらテストコードを記述する。   引用元：https://ja.wikipedia.org/wiki/テスト駆動開発  11 

#phpcon #track4  要求仕様とは   12 

#phpcon #track4  要求仕様書   要求仕様書は、システム開発やソフトウェアプロジェクトにおいて、顧客やユーザーのニーズや期待を具体的に文書化するための重要なドキュメントです。  その目的は、開発会社と発注顧客間での認識合わせを図り、プロジェクトの進行中に生じうる誤解やミスコミュニケーションを防ぐ
ことです。  引用元：https://biz.techvan.co.jp/tech-is/blog/infra/001258.html  13 

#phpcon #track4  プロジェクトには多くの人が関わる   14 

#phpcon #track4  • 発注顧客 / ビジネスオーナー  • プロダクトオーナー / ビジネスアナリスト 
• 開発者 / プログラマー  • テスター / QAエンジニア  • スクラムマスター / プロジェクトマネージャー  • など...  プロジェクトの進行中に生じうる誤解や   ミスコミュニケーションを防ぐ必要がある   プロジェクトには多くの人が関わる   15 

#phpcon #track4  つまり  16 

#phpcon #track4  BDD（振る舞い駆動開発）では、   要求仕様を自然言語で記述したテストコード   を書いて開発するため、開発関係者全員がビジネス  
要件について議論することが求められる   17 

#phpcon #track4  第二章    自然言語で要求仕様を意識してテストを書く   18 

#phpcon #track4  書いてみる     コードはGitHubにあります。   https://github.com/OHMORIYUSUKE/php-bdd-sample    19 

#phpcon #track4  テストするアプリケーション   20 

#phpcon #track4  テストするアプリケーション   • プログラミング言語名を入力  • 該当のプログラミング言語の情報が表示される  • ない場合はメッセージが表示される 
21 

#phpcon #track4  テストで使うライブラリなど   22 

#phpcon #track4  テストで使うライブラリなど   • Behat  ◦ Behat is a
BDD framework for PHP to help you test business expectations. (引用元：https://github.com/Behat/Behat)  ◦ Behat は、ビジネス要件をテストするのに役立つ PHP 用の BDD フレームワークです。  • PHP  ◦ Behat で自然言語で記述したシナリオのテストの実装  • Selenium WebDriver  ◦ ブラウザをネイティブに操作するために用いる  23 

#phpcon #track4  流れ  Behat  PHP  Selenium WebDriver  振る舞いを  記述  24 

#phpcon #track4  流れ  Behat  PHP  Selenium WebDriver  要求仕様の  テストを実装  25 

#phpcon #track4  流れ  Behat  PHP  Selenium WebDriver  ユーザーの  操作  26 

#phpcon #track4  Behatを用いて自然言語でテストコードを書く   27 

#phpcon #track4  自然言語のテストコード   Feature: ウェブサイトでの情報検索 As a 学習者 I
can ウェブサイトでキーワード検索を実行する so that 必要な技術情報を素早く見つけて学習効率を向上させる Scenario: 興味のある技術について検索する Given ウェブサイトのトップページを開く When "PHP" というキーワードで検索する Then 検索結果に "PHP" が含まれていること And 学習者が求める情報が表示されること 28 

can ウェブサイトでキーワード検索を実行する so that 必要な技術情報を素早く見つけて学習効率を向上させる Scenario: 興味のある技術について検索する Given ウェブサイトのトップページを開く When "PHP" というキーワードで検索する Then 検索結果に "PHP" が含まれていること And 学習者が求める情報が表示されること Feature（機能）：テストする機能全体を定義   29 

can ウェブサイトでキーワード検索を実行する so that 必要な技術情報を素早く見つけて学習効率を向上させる Scenario: 興味のある技術について検索する Given ウェブサイトのトップページを開く When "PHP" というキーワードで検索する Then 検索結果に "PHP" が含まれていること And 学習者が求める情報が表示されること As a / I can / so that（ユーザーストーリー）   As a: 誰がこの機能を使うか（ユーザーの役割）   I can: 何ができるか（実行可能なアクション）   so that: なぜその機能が必要か（ビジネス価値・目的）   30 

can ウェブサイトでキーワード検索を実行する so that 必要な技術情報を素早く見つけて学習効率を向上させる Scenario: 興味のある技術について検索する Given ウェブサイトのトップページを開く When "PHP" というキーワードで検索する Then 検索結果に "PHP" が含まれていること And 学習者が求める情報が表示されること Scenario（シナリオ）：具体的なテストケースを定義   31 

can ウェブサイトでキーワード検索を実行する so that 必要な技術情報を素早く見つけて学習効率を向上させる Scenario: 興味のある技術について検索する Given ウェブサイトのトップページを開く When "PHP" というキーワードで検索する Then 検索結果に "PHP" が含まれていること And 学習者が求める情報が表示されること Given (前提条件)：操作を実行する前の状態   32 

can ウェブサイトでキーワード検索を実行する so that 必要な技術情報を素早く見つけて学習効率を向上させる Scenario: 興味のある技術について検索する Given ウェブサイトのトップページを開く When "PHP" というキーワードで検索する Then 検索結果に "PHP" が含まれていること And 学習者が求める情報が表示されること When（実行アクション）：テスト対象となる具体的なアクション  33 

can ウェブサイトでキーワード検索を実行する so that 必要な技術情報を素早く見つけて学習効率を向上させる Scenario: 興味のある技術について検索する Given ウェブサイトのトップページを開く When "PHP" というキーワードで検索する Then 検索結果に "PHP" が含まれていること And 学習者が求める情報が表示されること Then（期待結果）：期待される結果を検証   34 

can ウェブサイトでキーワード検索を実行する so that 必要な技術情報を素早く見つけて学習効率を向上させる Scenario: 興味のある技術について検索する Given ウェブサイトのトップページを開く When "PHP" というキーワードで検索する Then 検索結果に "PHP" が含まれていること And 学習者が求める情報が表示されること And（追加条件）：複数の条件や検証を並列で記述する際に使用  35 

#phpcon #track4  PHPで対応するテストコードを書く     コードは一部省略しています   36 

#phpcon #track4  Given ウェブサイトのトップページを開く   /** * @Given ウェブサイトのトップページを開く */
public function openHomePage(): void { try { $host = getenv('SELENIUM_HOST') ?: 'localhost'; $port = getenv('SELENIUM_PORT') ?: '4444'; $serverUrl = "http://{$host}:{$port}"; $this->driver = RemoteWebDriver::create($serverUrl, DesiredCapabilities::chrome()); $this->driver->get('http://app:80'); } catch (\Exception $e) { throw $e; } } } 37 

#phpcon #track4  When "PHP" というキーワードで検索する   /** * @When :keyword
というキーワードで検索する */ public function searchWithKeyword(string $keyword): void { try { $searchInput = $this->driver->findElement(WebDriverBy::name('query')); $searchInput->sendKeys($keyword); $searchInput->submit(); } catch (\Exception $e) { throw $e; } } 38 

#phpcon #track4  Then 検索結果に "PHP" が含まれていること   And 学習者が求める情報が表示されること  
/** * @Then 学習者が求める情報が表示されること */ public function assertLearnerInformationIsDisplayed(): void { try { // 検索結果エリアが存在することを確認 $searchResultsDiv = $this->driver->findElement(WebDriverBy::className('search-results')); Assert::assertNotNull($searchResultsDiv, '検索結果エリアが表示されていません '); // 結果アイテムが存在することを確認 $resultItems = $this->driver->findElements(WebDriverBy::className('result-item')); Assert::assertGreaterThan(0, count($resultItems), '検索結果が表示されていません '); } catch (\Exception $e) { throw new \Exception('学習者に有用な情報が表示されていません : ' . $e->getMessage()); } } 39 

#phpcon #track4  自然言語で PHP と Selenium を用いて  要求仕様を意識したテストを書けた！   40 

#phpcon #track4  要求仕様書   要求仕様書は、システム開発やソフトウェアプロジェクトにおいて、顧客やユーザーのニーズや期待を具体的に文書化するための重要なドキュメントです。  その目的は、開発会社と発注顧客間での認識合わせを図り、プロジェクトの進行中に生じうる誤解やミスコミュニケーションを防ぐ
ことです。  引用元：https://biz.techvan.co.jp/tech-is/blog/infra/001258.html  再掲  41 

can ウェブサイトでキーワード検索を実行する so that 必要な技術情報を素早く見つけて学習効率を向上させる Scenario: 興味のある技術について検索する Given ウェブサイトのトップページを開く When "PHP" というキーワードで検索する Then 検索結果に "PHP" が含まれていること And 学習者が求める情報が表示されること • 顧客やユーザーのニーズや期待を具体的に文書化  • 自然言語で記述し、プロジェクトの進行中に生じうる誤解やミスコミュニケーションを防げそう  42 

#phpcon #track4  PHP の話は終わり   43 

#phpcon #track4  第三章    BDDの「振る舞い」とは何か？   44 

#phpcon #track4  BDD（振る舞い駆動開発）では、   要求仕様を自然言語で記述したテストコード   として開発するため、開発関係者全員がビジネス  
要件について議論することが求められる   再掲  45 

#phpcon #track4  BDDにおける「振る舞い」は要求仕様のこと？   46 

#phpcon #track4  PHPで始める振る舞い駆動開発   (Behaviour-Driven Development)  PHP Conference Japan 2025 
うーたん  PHPカンファレンス2025 公式ロゴより  再掲 

#phpcon #track4  要求仕様ではなくて、   BDDにおける「振る舞い」とは何なのか？   深掘りする     マーティン・ファウラー
(英: Martin Fowler)氏の記事を参考にしました   48 

#phpcon #track4  マーティン・ファウラー   マーティン・ファウラー (英: Martin Fowler、1963年 - )
は、アメリカ合衆国で活動しているソフトウェア技術者である。ソフトウェアアーキテクチャについての、いくつかの本の著者、および講演者として、広く知られている。とりわけオブジェクト指向分析とオブジェクト指向設計、統一モデリング言語 (UML) 、アナリシスパターンをはじめとしたソフトウェアパターン、エクストリーム・プログラミング (XP) を含むアジャイルソフトウェア開発方法論の、各分野において、活発に活動している。  引用元：https://ja.wikipedia.org/wiki/マーティン・ファウラー  49 

#phpcon #track4  BDDにおける「振る舞い」とは何なのか？   仕様の記述「 Given-When-Then」  Given-When-Thenという形式はBDD（振る舞い駆動開発）でよく使われますが、この基本的な考え方はテストや「例による仕様記述」を書く際によく見られます。Meszarosはこのパターンを「4フェーズテスト」として紹介しており、その4つの
フェーズは、Setup（Given）、Exercise（When）、Verify （Then）、Teardownです。Bill Wakeは同様の考え方を Arrange、Act、Assert という形で提唱しました。  参考: Martin Fowler. "GivenWhenThen". Retrieved from https://martinfowler.com/bliki/GivenWhenThen.html  50 

#phpcon #track4  BDDにおける「振る舞い」とは何なのか？   顧客の期待に応える「ビジネス指向テスト」   ビジネス指向テスト（Business-facing test）とは、顧客、ユーザー、ビジネスアナリストなど、開発チーム内の非プログラマーとコミュニケーションを取るための支援として使われるテストのことです。 
自動化された場合、システムのコンポーネント構成には触れず、ドメイン（業務）に即した用語でシステムを記述します。ビジネス指向テストは受け入れ基準として使われることが多く、これらのテストに合格することは、顧客が求める機能がシステムに備わっていることを示します。  参考: Martin Fowler. "BusinessFacingTest". Retrieved from https://martinfowler.com/bliki/BusinessFacingTest.html  51 

#phpcon #track4  BDDにおける振る舞い＝顧客に提供する価値   52 

#phpcon #track4  BDDにおける振る舞い＝顧客に提供する価値   私はこう解釈した  53 

#phpcon #track4  BDDにおける「振る舞い」とは何なのか？   BDDにおける振る舞い＝顧客に提供する価値   BDDにおける「振る舞い」とは、顧客が期待する具体的な価値を、明確で理解しやすいシナリオ 
（Given-When-Then）として定義する。  それをビジネスの観点からテスト（ビジネス指向テスト）することで、システムがその価値を確実に提供していることを保証する。    これは、技術的な詳細よりも、ビジネス上の要件と顧客の期待に応えることに重点を置いている。  54 

#phpcon #track4  これを踏まえて、   「振る舞い」とは何かを意識しないとどうなる？   55 

#phpcon #track4  テストするアプリケーション   • プログラミング言語名を入力  • 該当のプログラミング言語の情報が表示される  • ない場合はメッセージが表示される 
再掲  56 

#phpcon #track4  振る舞いを意識した例   57 

can ウェブサイトでキーワード検索を実行する so that 必要な技術情報を素早く見つけて学習効率を向上させる Scenario: 興味のある技術について検索する Given ウェブサイトのトップページを開く When "PHP" というキーワードで検索する Then 検索結果に "PHP" が含まれていること And 学習者が求める情報が表示されること再掲  58 

#phpcon #track4  いい感じな気がする   59 

#phpcon #track4  振る舞いを意識していない例   60 

#phpcon #track4  自然言語のテストコード   Feature: ウェブサイトでの情報検索 Scenario: 興味のある技術について検索する Given データベースに接続する
And SQLクエリを準備する When localhost:8080/search?q=PHPにアクセスする And search.phpが実行される Then HTTPステータス200が返る And DOM要素".results"が1個存在する 61 

And SQLクエリを準備する When localhost:8080/search?q=PHPにアクセスする And search.phpが実行される Then HTTPステータス200が返る And DOM要素".results"が1個存在する技術的詳細の過度な記述   62 

And SQLクエリを準備する When localhost:8080/search?q=PHPにアクセスする And search.phpが実行される Then HTTPステータス200が返る And DOM要素".results"が1個存在する実際のユーザーは  「検索ボックスにPHPと入力して検索ボタンを押す」  検索時にURLに直接アクセスすることはない   63 

And SQLクエリを準備する When localhost:8080/search?q=PHPにアクセスする And search.phpが実行される Then HTTPステータス200が返る And DOM要素".results"が1個存在する技術的詳細の過度な記述   64 

And SQLクエリを準備する When localhost:8080/search?q=PHPにアクセスする And search.phpが実行される Then HTTPステータス200が返る And DOM要素".results"が1個存在するユーザーは「正常に動作する」ことを期待   65 

And SQLクエリを準備する When localhost:8080/search?q=PHPにアクセスする And search.phpが実行される Then HTTPステータス200が返る And DOM要素".results"が1個存在するユーザーはDOM構造を意識しない  66 

#phpcon #track4  振る舞いを意識した例   67 

can ウェブサイトでキーワード検索を実行する so that 必要な技術情報を素早く見つけて学習効率を向上させる Scenario: 興味のある技術について検索する Given ウェブサイトのトップページを開く When "PHP" というキーワードで検索する Then 検索結果に "PHP" が含まれていること And 学習者が求める情報が表示されること • As a 学習者 / I can / so that で明確に  ビジネス価値を表現  • 技術的詳細（URL、 HTTPステータス、DOM 等）を一切含まない  • 実際のユーザーの行動と期待や提供価値を表現  68 

#phpcon #track4  まとめ  69 

#phpcon #track4  まとめ  • テスト駆動開発(TDD) はテストファーストでコードを洗練させる開発手法。  • TDDを拡張した、振る舞い駆動開発(BDD) は自然言語で
要求仕様や振る舞いを記述するテスト駆動開発。  • BDDにおける「振る舞い」は顧客に提供する具体的な価値。  70 

#phpcon #track4  BDD フレームワークを使うのが BDD ではない。   大切なのは、「振る舞い」を考え、共有し、   テストに落とし込むこと。
  71 

#phpcon #track4  BDD フレームワークを使うのが BDD ではない。   大切なのは、「振る舞い」を考え、共有し、   テストに落とし込むこと。
  72  ご清聴ありがとうございました 🙇 

PHPで始める振る舞い駆動開発(Behaviour-Driven Development)

PHPで始める振る舞い駆動開発(Behaviour-Driven Development)

Transcript

More Decks by uutan1108

Other Decks in Programming

Featured