Slim 4 + PHPUnit + Mockery で始めるユニットテスト入門｜DIとモックでテストを自動化

本記事には広告が含まれています

2025/05/31

Slim 4 + PHPUnit + Mockery で始めるユニットテスト入門｜DIとモックでテストを自動化

この記事では Slim 4 + PHPUnit + Mockery を組み合わせ、依存性注入（DI）とサービス層のモック化に焦点を当てたユニットテスト戦略を解説します。

「Slim だからテストは後回しでいい」と考えがちな開発者に向け、導入ハードルを下げつつテスト網を拡充する具体策を提示します。

Slim 4 と PSR‑11 コンテナの活用 ― DI 設計の前提を固める

Slim 4 以降は AppFactory::setContainer() によって PSR‑11 準拠のコンテナを差し替えられます。つまり $container->get() をルートハンドラ内で直に呼ぶよりも、コンストラクタインジェクションで依存を解決する方が自然でテスト可能性も高まります。

例えばリポジトリクラスを直接生成すると「本番では DB、テストではモック」という切り替えが難しくなりますが、ArticleRepositoryInterface を注入すれば Mockery 由来のテストダブルへ瞬時に差し替え可能です。

コンテナ直取得 vs コンストラクタインジェクション

観点	コンテナ直取得	コンストラクタインジェクション
テスト容易性	低い	高い
可読性	取得箇所が散在	依存が明示的
実装工数	少	やや多

多少コードが増える代わりに「いつでも安全にリファクタできる」という保険を手に入れられます。

PHPUnit + Mockery のセットアップ手順【PHP 8.3 対応】

2025年5月時点で slim/psr7 は PHP 8.0 以降が必須です。テスト用の phpunit/phpunit（10.x 系）と mockery/mockery（2.x 系）は Composer で追加します。

composer require --dev phpunit/phpunit ^10 mockery/mockery ^2

tests/bootstrap.php にはオートローダと、Mockery::globalHelpers() を使う場合のみ次を追加します。

グローバルヘルパーは mock() を手軽に呼べる利点がありますが、名前空間汚染を避けたい場合は省略しても問題ありません。

特に、PSR-4 に準拠したテスト構成では Mockery::mock() を明示的に使った方が可読性と保守性が高いこともあります。

require __DIR__ . '/../vendor/autoload.php';
// 任意: Procedural ヘルパーを使うなら有効化
Mockery::globalHelpers();

PHPUnit の xml ではユニットテスト用ディレクトリを tests/Unit と分け、E2E や API テストと明確に住み分けておくと CI が高速化します。

サービス層をモック化したユニットテスト例 ― DB を切り離す

本番では MySQL に書き込む ArticleRepository をモックに差し替え、ビジネスロジックのみを検証するコード例を示します。

namespace Tests\Unit;

use App\Service\ArticleService;
use App\Repository\ArticleRepositoryInterface;
use Mockery;
use PHPUnit\Framework\TestCase;

class ArticleServiceTest extends TestCase
{
protected function tearDown(): void
{
Mockery::close();
}

```
public function testPublishReturnsTrueOnSuccess(): void
{
    $repo = Mockery::mock(ArticleRepositoryInterface::class);
    $repo->shouldReceive('save')
         ->once()
         ->andReturn(true);

// ArticleService は ArticleRepositoryInterface を受け取る設計
    $service = new ArticleService($repo);
    $result  = $service->publish(['title' => '新記事']);

    $this->assertTrue($result);
}
```

}

ここでは shouldReceive() で呼び出し回数と戻り値を明示しています。これにより「DB 接続に失敗したらどうなるか」といった分岐も、andThrow() を差し替えるだけでテストできます。