Laravel에서 컨트롤러란 무엇인가요?

Question

Accepted Answer

**컨트롤러(Controller)**는 관련된 요청 처리 로직을 클래스로 그룹화합니다. 모든 로직을 라우트 클로저에 넣는 대신, 컨트롤러는 애플리케이션의 동작(예: 모든 사용자 관련 작업)을 메서드로 정리하여 라우트를 깔끔하게 유지하고 코드를 체계화합니다.

## 기본 컨트롤러

```php
<?php
class UserController extends Controller {
    public function index() {
        return User::all();              // 사용자 목록
    }
    public function show(User $user) {   // route model binding — id로 자동 조회
        return $user;
    }
    public function store(Request $request) {
        $validated = $request->validate(['name' => 'required', 'email' => 'required|email']);
        return User::create($validated);  // 생성
    }
}
```

Artisan으로 생성: `php artisan make:controller UserController`. 각 메서드는 하나의 동작을 처리하고, 라우트가 그것을 가리킵니다.

## 리소스 컨트롤러 (RESTful CRUD)

```php
// 7개의 RESTful 메서드가 모두 스텁된 컨트롤러 생성
// php artisan make:controller PostController --resource

Route::resource('posts', PostController::class);   // 라우트를 메서드에 매핑:
// index() create() store() show() edit() update() destroy()
```

**리소스 컨트롤러**는 표준 CRUD 메서드를 가지며, 관례적인 RESTful 라우팅을 위해 `Route::resource`와 짝을 이룹니다 — 전형적인 CRUD 리소스를 위한 최소한의 보일러플레이트입니다.

## 컨트롤러에서의 의존성 주입

```php
class OrderController extends Controller {
    // 타입 힌트된 의존성은 Laravel의 service container에 의해 자동 주입됨
    public function __construct(private OrderService $orders) {}

public function store(Request $request, Mailer $mailer) {   // 메서드 주입도 가능
        // $request와 $mailer가 자동으로 해석되어 주입됨
    }
}
```

Laravel의 service container는 타입 힌트된 의존성을 컨트롤러의 생성자와 메서드에(`Request`를 포함하여) **자동으로 주입**합니다 — 깔끔하고 테스트 가능한 코드입니다.

## 컨트롤러를 가볍게 유지하기

```text
✓ 컨트롤러는 HTTP 관심사를 처리해야 함 (입력 검증, 서비스 호출, 응답 반환)
✗ 비즈니스 로직은 비대한 컨트롤러가 아닌 서비스/모델에 속함 ("가벼운 컨트롤러")
```

## 왜 중요한가

컨트롤러는 Laravel의 핵심 구성 요소입니다 — 요청 처리 로직을 응집력 있는 클래스로 정리하며, 이는 사소한 라우트를 넘어선 모든 애플리케이션에 필수적입니다.

컨트롤러를 만들고, 라우트를 그 메서드에 매핑하며, 특히 **리소스 컨트롤러**를 `Route::resource`와 함께 사용하는 방법(최소한의 보일러플레이트로 관례적인 RESTful CRUD를 구현)을 이해하는 것은 Laravel 앱을 구축하는 일상 지식입니다.

Laravel의 핵심 기능은 service container를 통한 컨트롤러로의 **자동 의존성 주입**입니다 — 타입 힌트된 의존성(서비스, 요청, 메일러)이 자동으로 해석되어 주입되어 깔끔하고 테스트 가능하며 느슨하게 결합된 코드를 가능하게 합니다.

마찬가지로 중요한 것은 컨트롤러를 **가볍게** 유지하는 모범 사례입니다 — HTTP 관심사(검증, 서비스 호출, 응답 반환)만 처리하고 비즈니스 로직은 서비스/모델에 위임하여, 코드를 유지보수 가능하고 테스트 가능하게 유지합니다.

컨트롤러는 라우팅 및 모델과 함께 Laravel의 요청 처리의 근간을 이루므로, 잘 정리되고 전문적인 Laravel 애플리케이션을 구축하는 데 근본적입니다.