【Laravel】サービスクラス設計パターン｜ビジネスロジックの分離とテスト性の両立

Laravelでは、コントローラーにビジネスロジックを直接書くと、保守性・再利用性・テスト性のいずれも損なわれやすくなります。その解決策として有効なのが「サービスクラス」の設計です。

この記事では、Laravelにおけるサービスクラスの設計パターンと、ビジネスロジックの分離によるメリット、テストコードとの連携方法を実例を交えて解説します。

サービスクラスとは？
サービスクラスの基本構造
コントローラーからの呼び出し
サービスクラス設計のメリット
サービスクラスに依存するテストの書き方
よくあるアンチパターンと改善ポイント
まとめ

サービスクラスとは？

サービスクラスとは、コントローラーとモデルの間に立って、ビジネスロジックをまとめる役割を担うクラスです。例えば、ユーザー登録処理、決済処理、メール通知など複数の処理を組み合わせるロジックを1つの責任としてまとめます。

従来のコントローラー：

public function store(Request $request)
{
    $user = User::create([...]);

    Notification::send($user, new WelcomeNotification());

    event(new UserRegistered($user));

    return redirect()->route('dashboard');
}

このように複数の処理が混在する場合、テストしづらく、ロジックの流用も困難になります。

サービスクラスの基本構造

Laravelでは、以下のようなディレクトリ構成でサービスクラスを配置するのが一般的です。

app/
├── Services/
│   └── UserService.php

サービスクラスの実装例：

namespace App\Services;

use App\Models\User;
use App\Notifications\WelcomeNotification;
use Illuminate\Support\Facades\Notification;

class UserService
{
    public function register(array $data): User
    {
        $user = User::create($data);

        Notification::send($user, new WelcomeNotification());

        event(new \App\Events\UserRegistered($user));

        return $user;
    }
}

コントローラーからの呼び出し

コントローラーでは、責務を限定し、サービスクラスに処理を委譲します。

use App\Services\UserService;

class RegisterController extends Controller
{
    public function __construct(protected UserService $userService) {}

    public function store(Request $request)
    {
        $user = $this->userService->register($request->validated());

        return redirect()->route('dashboard');
    }
}

__construct()で依存注入（DI）すれば、サービスクラスのテストやMock差し替えも容易になります。

サービスクラス設計のメリット

関心の分離：コントローラーはルーティングとレスポンスのみに集中
再利用性：同じロジックをAPI・バッチ・CLIなどでも流用可能
テスト性：サービス単位でユニットテストを書きやすくなる

サービスクラスに依存するテストの書き方

サービスクラスにメソッドを持たせることで、ユニットテストを明確に定義できます。

public function test_user_registration()
{
    $service = new UserService();

    $user = $service->register([
        'name' => 'テストユーザー',
        'email' => 'test@example.com',
        'password' => bcrypt('secret'),
    ]);

    $this->assertDatabaseHas('users', ['email' => 'test@example.com']);
}

ビジネスルールをサービス単位でテストできることで、LaravelのFeatureTestよりも高速かつ安定したテストを構築できます。