wpppb

WP プラグイン PHPUnit ブートストラップ

PHPUnit を使用した WordPress プラグインの統合テスト用のブートストラップ。

インストール

composer require --dev jdgrimes/wpppb

設定

まず、 testsディレクトリを含む WordPress 開発リポジトリのローカル チェックアウトが必要です。これを取得するための推奨される方法は、特に WordPress コアに貢献する予定がある場合、VVV を使用することです。 WPPPB は WordPress コアにすでに含まれているテスト ツールに基づいて構築されているため、それらがなければ機能しません。

WordPress のtestsディレクトリのローカル コピーを取得したら、WPPPB のセットアップ スクリプトを実行できます。

vendor/bin/wpppb-init

プロンプトに答えれば準備完了です。

テストは、プロジェクトのルート (つまり、Composer によって追加されたvendorディレクトリの横) に作成されるtestsディレクトリに配置されます。プラグインのソース (圧縮されて WordPress サイトにインストールされる部分) は、プロジェクト自体のルートではなく、これら 2 つのディレクトリと並んでsrcディレクトリにあることが期待されます。ファイル構造の例は次のようになります。

 - src/
  - my-plugin.php
  - includes/
  - etc.
- tests/
- vendor/

いくつかの変更を加えれば、別のディレクトリ構造で WPPPB を使用できる可能性がありますが、これがデフォルトで想定されている構造です。

使用法

通常と同じように PHPUnit テストを実行できます。

phpunit

プラグインのアンインストール ルーチンをテストするなど、他の素晴らしいことを行うこともできます。

(デフォルトのブートストラップは Composer の PHP オートローダーを利用するため、PHP 5.3 が必要であることに注意してください。PHP 5.2 での使用方法については、こちらを参照してください。)

目的

このプロジェクトの目的は、WordPress コアのテストスイートを使用してプラグインの統合テストを実行したいプラグイン開発者にブートストラップを提供することです。その目的は、テストを可能な限り現実的なものにする実装を提供することで、これを簡単にするだけでなく、より良いものにすることです。

この目的を達成するために、ローダーはプラグインをリモートでアクティブ化し、通常と同じように WordPress にプラグインをロードさせることで機能します。これにより、通常行われるように、 muplugins_loadedアクションでプラグインを手動で含めてアクティブ化するよりも、より現実的なテストが可能になります。

ライセンス

このプロジェクトのコードは、MIT ライセンスに基づいて提供されています。