shopware-phpunit について
Shopware 6 のプラグインやアプリを開発する人向けに、PHPUnit テストの指針を提供するスキルです。優先度と分野別に整理され、テスト設定、統合・API テスト、モック、データ、パフォーマンスの参考資料を備えています。
主な機能
- 01テスト設定の指針
- 02統合テストの実践方法
- 03Store API と Admin API のテスト
- 04モックと依存性注入
- 05テストデータとクリーンアップの指針
活用シーン
- 01Shopware のテスト基盤を設定
- 02リポジトリとサービスをテスト
- 03Storefront コントローラーと API ルートをテスト
- 04失敗する Shopware テストをデバッグ
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ friendsofshopware/ agent-skills --skill shopware-phpunitインストール後、Claude Code で/shopware-phpunitを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/_sections.md_template.mdapi-store-api-testing.mddata-product-builder.mddata-test-fixtures.mdintegration-repository-testing.mdmock-service-decoration.mdmock-static-entity-repository.mdmock-static-system-config-service.mdsetup-base-test-class.mdsetup-kernel-bootstrap.mdsetup-prefer-assertsame.mdsetup-prefer-expect-exception-object.md詳細
Shopware PHPUnit のベストプラクティス
適用する場面
- Shopware 6 のプラグインまたはアプリ用に新しい PHPUnit テストを作成する場合
- Shopware プロジェクトのテストインフラストラクチャをセットアップする場合
- リポジトリ、サービス、コマンド、イベントサブスクライバーをテストする場合
- Shopware カーネルが必要な統合テストを作成する場合
- Storefront コントローラー、または Store API/Admin API のルートをテストする場合
- Shopware のコンテキストで失敗するテストをデバッグする場合
優先度別のルールカテゴリ
| 優先度 | カテゴリ | プレフィックス | 説明 |
|---|---|---|---|
| 重大 | テストのセットアップ | setup- | カーネルのブートストラップ、ベーステストクラス、PHPUnit の設定 |
| 高 | 統合テスト | integration- | リポジトリテスト、サービステスト、データベーストランザクション |
| 高 | API テスト | api- | Store API と Admin API のエンドポイントテスト |
| 中 | モック | mock- | サービスのモック化、テストにおける依存性注入 |
| 中 | データ | data- | テストデータの作成、フィクスチャ、クリーンアップ |
| 低 | パフォーマンス | perf- | テスト実行速度、並列テスト |
使用方法
作業内容に応じて、references/ ディレクトリから関連するリファレンスファイルを読みます。ファイルには、見つけやすいようカテゴリ別のプレフィックスが付いています。
外部リファレンス
コメント
Markdown 対応