php integration testingダウンロード - php integration testingソースコードダウンロード

php integration testing

パイソン

v1.0 release

ダウンロード

PHP 統合テスト

データベースおよびその他の一般的なインフラストラクチャ関連のテスト用の PHP の統合テストライブラリ。

これは、さまざまなイベントにフックしてフィクスチャを実行する PHPUnit の拡張機能のセットとして開発されています。

現在、次の PHPUnit フックでカスタムフィクスチャを実行できます。

最初のテスト前
テスト前
アフターテスト
最終テスト後

ロードマップ

WIP: WithBeforeTestFixtureName および WithAfterTestFixtureName を使用した AMQP 固有のテストフィクスチャ

要件

PHPUユニット

インストール

作曲家経由

composer require --dev hrodic/php-integration-testing

構成

PHPUnit 構成 XML ファイルでは、その構成で拡張子を指定する必要があります。

使用する構成ファイル名を指定できます。デフォルトは .integration-testing.json

<extensions>
    <extension class="IntegrationTestingPHPUnitRunnerExtensionHandler">
        <arguments>
            <string>.integration-testing.json</string>
        </arguments>
    </extension>
</extensions>

phpunit-integration.xml.dist の例も確認してください。

PHPUnit 拡張機能についてサポートが必要な場合は、公式ドキュメントを参照してください。

PDO フィクスチャ

MySQL または MariaDB の統合をテストする必要がある場合は、PDO ドライバー拡張機能を使用します。

json 構成ファイル内にある構成パラメーターが必要です。

最も重要なパラメータは、DSN、データベースのユーザー名とパスワード、およびいくつかのフィクスチャパス定義です。

例：

"pdo": {
    "dsn": "mysql:host=localhost:3306;dbname=test;charset=utf8",
    "user": "test",
    "password": "test",
    "fixtures": {
      "beforeFirstTest": {
        "path": "tests/fixtures/before-first-test",
        "extension": "sql"
      },
      "beforeTest": {
        "path": "tests/fixtures/before-test",
        "extension": "sql"
      },
      "afterTest": {
        "path": "tests/fixtures/after-test"
      },
      "afterLastTest": {
        "path": "tests/fixtures/after-last-test"
      }
    }
},

AMQP の試合

AMQP (RabbitMQ でテスト済み) フィクスチャと操作を試すこともできます。

構成ファイルを使用して、接続とフック操作を構成します。

注:

フック定義はオプションなので、必要なものだけを設定してください。
メッセージを発行できるのは、 beforeFirstTestとbeforeTestのみです。
4 つのフックすべてでキューをパージできます。
パブリッシュするメッセージ本文のファイル拡張子はデフォルトでjsonになります
交換をdirectとして設定している場合は、 routing_keyを使用します。 fanoutの場合は空の文字列として定義できます

"amqp": {
    "host": "localhost",
    "port": 5672,
    "user": "test",
    "password": "test",
    "vhost": "/",
    "fixtures": {
      "beforeFirstTest": {
        "purgeQueues": [
          "before-first-test-queue"
        ],
        "publishMessages": [
          {
            "exchange": "test-exchange",
            "queue": "before-first-test-queue",
            "routing_key": "before-first-test",
            "path": "tests/fixtures/before-first-test",
            "extension": "json"
          }
        ]
      },
      "beforeTest": {
        "purgeQueues": [
          "before-test-queue"
        ],
        "publishMessages": [
          {
            "exchange": "test-exchange",
            "queue": "before-test-queue",
            "routing_key": "before-test",
            "path": "tests/fixtures/before-test"
          }
        ]
      },
      "afterTest": {
        "purgeQueues": [
          "before-test-queue"
        ]
      },
      "afterLastTest": {
        "purgeQueues": []
      }
    }
  }

フィクスチャの作成

PDO フィクスチャは単なる SQL ファイルです。

特定のフックカテゴリにあるすべてのフィクスチャは、トランザクション内で順番に実行されます。

各段階で SQL を作成する方法とデータベースの整合性はユーザー次第です。このライブラリは、最初にフィクスチャをセットアップし、各テスト後に混乱を解消するのが一般的ですが、いかなる規則に従うことも強制しません。

作成、挿入、削除など、ユーザーが行うように設定したあらゆる操作を行うことができます。テストデータベースは実際のデータベースから分離する必要があることに注意してください。

4 つのフィクスチャフックタイプはすべて、好みのディレクトリに配置できます。

すべての特定のテストで発生する BeforeTest フックと AfterTest フックについては、WithBeforeTestFixtureName インターフェイスや WithAfterTestFixtureName インターフェイスを実装することで、汎用の Before フィクスチャと AfterTest フィクスチャの直後に実行される特定のフィクスチャを提供することもできます。

final class YourIntegrationTest extends TestCase implements WithBeforeTestFixtureName, WithAfterTestFixtureName
{
    private const FIXTURE_NAME = 'pdo-integration-test';

    public static function getAfterTestFixtureName(): string
    {
        return self::FIXTURE_NAME;
    }

    public static function getBeforeTestFixtureName(): string
    {
        return self::FIXTURE_NAME;
    }

    public function testYourRepositoryHere(): void
    {
        // arrange
        // act
        // assert against real database (your fixtures are already there!)       
    }
}

拡張機能はメソッドが定義されているかどうかを確認し、それらのメソッドを使用してメインの BEFORE_TEST_PDO_FIXTURES_PATH および AFTER_TEST_PDO_FIXTURES_PATH ディレクトリ内のサブディレクトリを見つけます。

実行の流れ

テスト/フィクスチャフォルダを見ると、フィクスチャを整理する方法の例が表示されます。複数の SQL ファイルを持つことができ、拡張機能はそれらを順番に読み取って実行します。

├── after-last-test                     # AFTER_LAST_TEST_PDO_FIXTURES_PATH, executed once, at the end
│   └── 01.sql
├── after-test                          # AFTER_TEST_PDO_FIXTURES_PATH, executed after each test
│   ├── 01.sql
│   └── pdo-integration-test            # executed after each test inside the class that defines this fixture name
│       └── 01.sql
├── before-first-test                   # BEFORE_FIRST_TEST_PDO_FIXTURES_PATH, executed once, at the beginning
│   └── 01.sql
└── before-test                         # BEFORE_TEST_PDO_FIXTURES_PATH, executed before each test
    ├── 01.sql
    └── pdo-integration-test            # executed before each test inside the class that defines this fixture name
        └── 01.sql