컨트롤러 (Controllers)

• 소개
• 컨트롤러 작성하기
  • 기본 컨트롤러
  • 단일 액션 컨트롤러
• 컨트롤러 미들웨어
  • 미들웨어 속성
• 리소스 컨트롤러
  • 일부 리소스 라우트
  • 중첩 리소스
  • 리소스 라우트 이름 지정
  • 리소스 라우트 파라미터 이름 지정
  • 리소스 라우트 범위 지정
  • 리소스 URI 지역화
  • 리소스 컨트롤러 보완하기
  • 싱글턴 리소스 컨트롤러
  • 미들웨어와 리소스 컨트롤러
• 의존성 주입과 컨트롤러

소개 (Introduction)

라우트 파일에서 모든 요청 처리 로직을 클로저로 정의하는 대신, 이 동작을 "컨트롤러" 클래스로 구성할 수 있습니다. 컨트롤러는 관련된 요청 처리 로직을 하나의 클래스로 묶을 수 있습니다. 예를 들어 UserController 클래스는 사용자 표시, 생성, 수정, 삭제를 포함하여 사용자와 관련된 모든 들어오는 요청을 처리할 수 있습니다. 기본적으로 컨트롤러는 app/Http/Controllers 디렉터리에 저장됩니다.

컨트롤러 작성하기 (Writing Controllers)

기본 컨트롤러

새 컨트롤러를 빠르게 생성하려면 make:controller Artisan 명령어를 실행할 수 있습니다. 기본적으로 애플리케이션의 모든 컨트롤러는 app/Http/Controllers 디렉터리에 저장됩니다.

php artisan make:controller UserController

기본 컨트롤러의 예를 살펴보겠습니다. 컨트롤러는 들어오는 HTTP 요청에 응답하는 public 메서드를 원하는 만큼 가질 수 있습니다.

<?php

namespace App\Http\Controllers;

use App\Models\User;
use Illuminate\View\View;

class UserController extends Controller
{
    /**
     * Show the profile for a given user.
     */
    public function show(string $id): View
    {
        return view('user.profile', [
            'user' => User::findOrFail($id)
        ]);
    }
}

컨트롤러 클래스와 메서드를 작성한 뒤에는 다음과 같이 컨트롤러 메서드로 연결되는 라우트를 정의할 수 있습니다.

use App\Http\Controllers\UserController;

Route::get('/user/{id}', [UserController::class, 'show']);

들어오는 요청이 지정된 라우트 URI와 일치하면 App\Http\Controllers\UserController 클래스의 show 메서드가 호출되고, 라우트 파라미터가 해당 메서드로 전달됩니다.

컨트롤러가 반드시 기본 클래스를 확장해야 하는 것은 아닙니다. 하지만 모든 컨트롤러에서 공유해야 하는 메서드가 포함된 기본 컨트롤러 클래스를 확장하면 편리한 경우가 있습니다.

단일 액션 컨트롤러

컨트롤러 액션이 특히 복잡하다면, 해당 단일 액션 전용으로 컨트롤러 클래스 하나를 사용하는 것이 편리할 수 있습니다. 이를 위해 컨트롤러 안에 __invoke 메서드 하나를 정의할 수 있습니다.

<?php

namespace App\Http\Controllers;

class ProvisionServer extends Controller
{
    /**
     * Provision a new web server.
     */
    public function __invoke()
    {
        // ...
    }
}

단일 액션 컨트롤러의 라우트를 등록할 때는 컨트롤러 메서드를 지정할 필요가 없습니다. 대신 컨트롤러 이름만 라우터에 전달하면 됩니다.

use App\Http\Controllers\ProvisionServer;

Route::post('/server', ProvisionServer::class);

make:controller Artisan 명령어의 --invokable 옵션을 사용하여 호출 가능한 컨트롤러를 생성할 수 있습니다.

php artisan make:controller ProvisionServer --invokable

컨트롤러 스텁은 스텁 게시를 사용하여 커스터마이즈할 수 있습니다.

컨트롤러 미들웨어 (Controller Middleware)

Middleware는 라우트 파일에서 컨트롤러의 라우트에 할당할 수 있습니다.

Route::get('/profile', [UserController::class, 'show'])->middleware('auth');

또는 컨트롤러 클래스 안에서 미들웨어를 지정하는 것이 편리할 수도 있습니다. 이렇게 하려면 컨트롤러가 HasMiddleware 인터페이스를 구현해야 합니다. 이 인터페이스는 컨트롤러에 static middleware 메서드가 있어야 함을 지정합니다. 이 메서드에서 컨트롤러의 액션에 적용할 미들웨어 배열을 반환할 수 있습니다.

<?php

namespace App\Http\Controllers;

use Illuminate\Routing\Controllers\HasMiddleware;
use Illuminate\Routing\Controllers\Middleware;

class UserController implements HasMiddleware
{
    /**
     * Get the middleware that should be assigned to the controller.
     */
    public static function middleware(): array
    {
        return [
            'auth',
            new Middleware('log', only: ['index']),
            new Middleware('subscribed', except: ['store']),
        ];
    }

    // ...
}

컨트롤러 미들웨어를 클로저로 정의할 수도 있습니다. 이렇게 하면 별도의 미들웨어 클래스를 작성하지 않고도 인라인 미들웨어를 편리하게 정의할 수 있습니다.

use Closure;
use Illuminate\Http\Request;

/**
 * Get the middleware that should be assigned to the controller.
 */
public static function middleware(): array
{
    return [
        function (Request $request, Closure $next) {
            return $next($request);
        },
    ];
}

미들웨어 속성

PHP 속성을 사용하여 컨트롤러에 미들웨어를 할당할 수도 있습니다.

<?php

namespace App\Http\Controllers;

use Illuminate\Routing\Attributes\Controllers\Middleware;

#[Middleware('auth')]
#[Middleware('log', only: ['index'])]
#[Middleware('subscribed', except: ['store'])]
class UserController
{
    // ...
}

개별 컨트롤러 메서드에도 미들웨어 속성을 배치할 수 있습니다. 메서드에 할당된 미들웨어는 클래스 수준에 할당된 미들웨어와 병합됩니다.

<?php

namespace App\Http\Controllers;

use Closure;
use Illuminate\Http\Request;
use Illuminate\Routing\Attributes\Controllers\Middleware;

#[Middleware('auth')]
class UserController
{
    #[Middleware('log')]
    #[Middleware('subscribed')]
    public function index()
    {
        // ...
    }

    #[Middleware(static function (Request $request, Closure $next) {
        // ...

        return $next($request);
    })]
    public function store()
    {
        // ...
    }
}

리소스 컨트롤러 (Resource Controllers)

애플리케이션의 각 Eloquent 모델을 하나의 "리소스"로 생각하면, 애플리케이션의 각 리소스에 대해 같은 종류의 액션을 수행하는 것이 일반적입니다. 예를 들어 애플리케이션에 Photo 모델과 Movie 모델이 있다고 가정해 보겠습니다. 사용자는 이런 리소스를 생성, 읽기, 수정, 삭제할 수 있을 가능성이 높습니다.

이처럼 흔한 사용 사례 때문에 Laravel 리소스 라우팅은 일반적인 생성, 읽기, 수정, 삭제("CRUD") 라우트를 한 줄의 코드로 컨트롤러에 할당합니다. 시작하려면 make:controller Artisan 명령어의 --resource 옵션을 사용하여 이러한 액션을 처리할 컨트롤러를 빠르게 만들 수 있습니다.

php artisan make:controller PhotoController --resource

이 명령어는 app/Http/Controllers/PhotoController.php에 컨트롤러를 생성합니다. 컨트롤러에는 사용 가능한 각 리소스 작업에 대응하는 메서드가 포함됩니다. 다음으로 컨트롤러를 가리키는 리소스 라우트를 등록할 수 있습니다.

use App\Http\Controllers\PhotoController;

Route::resource('photos', PhotoController::class);

이 단일 라우트 선언은 리소스에 대한 다양한 액션을 처리하는 여러 라우트를 생성합니다. 생성된 컨트롤러에는 이러한 각 액션에 대한 메서드 스텁이 이미 포함되어 있습니다. 애플리케이션의 라우트를 빠르게 살펴보려면 언제든지 route:list Artisan 명령어를 실행하면 됩니다.

resources 메서드에 배열을 전달하여 여러 리소스 컨트롤러를 한 번에 등록할 수도 있습니다.

Route::resources([
    'photos' => PhotoController::class,
    'posts' => PostController::class,
]);

softDeletableResources 메서드는 모두 withTrashed 메서드를 사용하는 여러 리소스 컨트롤러를 등록합니다.

Route::softDeletableResources([
    'photos' => PhotoController::class,
    'posts' => PostController::class,
]);

리소스 컨트롤러가 처리하는 액션

HTTP 동사	URI	액션	라우트 이름
GET	/photos	index	photos.index
GET	/photos/create	create	photos.create
POST	/photos	store	photos.store
GET	/photos/{photo}	show	photos.show
GET	/photos/{photo}/edit	edit	photos.edit
PUT/PATCH	/photos/{photo}	update	photos.update
DELETE	/photos/{photo}	destroy	photos.destroy

누락된 모델 동작 커스터마이즈

일반적으로 암묵적으로 바인딩된 리소스 모델을 찾을 수 없으면 404 HTTP 응답이 생성됩니다. 하지만 리소스 라우트를 정의할 때 missing 메서드를 호출하여 이 동작을 커스터마이즈할 수 있습니다. missing 메서드는 리소스의 어떤 라우트에서든 암묵적으로 바인딩된 모델을 찾을 수 없을 때 호출될 클로저를 인수로 받습니다.

use App\Http\Controllers\PhotoController;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Redirect;

Route::resource('photos', PhotoController::class)
    ->missing(function (Request $request) {
        return Redirect::route('photos.index');
    });

소프트 삭제된 모델

일반적으로 암묵적 모델 바인딩은 소프트 삭제된 모델을 조회하지 않고, 대신 404 HTTP 응답을 반환합니다. 하지만 리소스 라우트를 정의할 때 withTrashed 메서드를 호출하면 프레임워크가 소프트 삭제된 모델을 허용하도록 지시할 수 있습니다.

use App\Http\Controllers\PhotoController;

Route::resource('photos', PhotoController::class)->withTrashed();

인수 없이 withTrashed를 호출하면 show, edit, update 리소스 라우트에서 소프트 삭제된 모델을 허용합니다. withTrashed 메서드에 배열을 전달하여 이러한 라우트 중 일부만 지정할 수 있습니다.

Route::resource('photos', PhotoController::class)->withTrashed(['show']);

리소스 모델 지정

라우트 모델 바인딩을 사용하고 있으며 리소스 컨트롤러의 메서드가 모델 인스턴스를 타입 힌트하도록 하고 싶다면, 컨트롤러를 생성할 때 --model 옵션을 사용할 수 있습니다.

php artisan make:controller PhotoController --model=Photo --resource

폼 요청 생성

리소스 컨트롤러를 생성할 때 --requests 옵션을 제공하면 Artisan에 컨트롤러의 저장 및 수정 메서드에 사용할 폼 요청 클래스를 생성하도록 지시할 수 있습니다.

php artisan make:controller PhotoController --model=Photo --resource --requests

일부 리소스 라우트

리소스 라우트를 선언할 때, 기본 액션 전체가 아니라 컨트롤러가 처리해야 하는 액션의 일부만 지정할 수 있습니다.

use App\Http\Controllers\PhotoController;

Route::resource('photos', PhotoController::class)->only([
    'index', 'show'
]);

Route::resource('photos', PhotoController::class)->except([
    'create', 'store', 'update', 'destroy'
]);

API 리소스 라우트

API에서 사용할 리소스 라우트를 선언할 때는 일반적으로 create와 edit처럼 HTML 템플릿을 표시하는 라우트를 제외하고 싶을 것입니다. 편의를 위해 apiResource 메서드를 사용하면 이 두 라우트를 자동으로 제외할 수 있습니다.

use App\Http\Controllers\PhotoController;

Route::apiResource('photos', PhotoController::class);

apiResources 메서드에 배열을 전달하여 여러 API 리소스 컨트롤러를 한 번에 등록할 수 있습니다.

use App\Http\Controllers\PhotoController;
use App\Http\Controllers\PostController;

Route::apiResources([
    'photos' => PhotoController::class,
    'posts' => PostController::class,
]);

create 또는 edit 메서드를 포함하지 않는 API 리소스 컨트롤러를 빠르게 생성하려면 make:controller 명령어를 실행할 때 --api 스위치를 사용하세요.

php artisan make:controller PhotoController --api

중첩 리소스

때로는 중첩된 리소스로 이어지는 라우트를 정의해야 할 수 있습니다. 예를 들어 사진 리소스에는 해당 사진에 연결될 수 있는 여러 댓글이 있을 수 있습니다. 리소스 컨트롤러를 중첩하려면 라우트 선언에서 "점" 표기법을 사용할 수 있습니다.

use App\Http\Controllers\PhotoCommentController;

Route::resource('photos.comments', PhotoCommentController::class);

이 라우트는 다음과 같은 URI로 접근할 수 있는 중첩 리소스를 등록합니다.

/photos/{photo}/comments/{comment}

중첩 리소스 범위 지정

Laravel의 암묵적 모델 바인딩 기능은 중첩 바인딩의 범위를 자동으로 지정하여, 해결된 자식 모델이 부모 모델에 속하는지 확인할 수 있습니다. 중첩 리소스를 정의할 때 scoped 메서드를 사용하면 자동 범위 지정을 활성화할 수 있으며, 자식 리소스를 어떤 필드로 조회해야 하는지도 Laravel에 지시할 수 있습니다. 이를 수행하는 방법에 대한 자세한 내용은 리소스 라우트 범위 지정 문서를 참고하세요.

얕은 중첩

대개 자식 ID가 이미 고유 식별자라면 URI 안에 부모 ID와 자식 ID를 모두 포함할 필요는 없습니다. 자동 증가 기본 키처럼 고유 식별자를 사용해 URI 세그먼트에서 모델을 식별하는 경우에는 "얕은 중첩(shallow nesting)"을 사용할 수 있습니다.

use App\Http\Controllers\CommentController;

Route::resource('photos.comments', CommentController::class)->shallow();

이 라우트 정의는 다음 라우트를 정의합니다.

HTTP 동사	URI	액션	라우트 이름
GET	/photos/{photo}/comments	index	photos.comments.index
GET	/photos/{photo}/comments/create	create	photos.comments.create
POST	/photos/{photo}/comments	store	photos.comments.store
GET	/comments/{comment}	show	comments.show
GET	/comments/{comment}/edit	edit	comments.edit
PUT/PATCH	/comments/{comment}	update	comments.update
DELETE	/comments/{comment}	destroy	comments.destroy

리소스 라우트 이름 지정

기본적으로 모든 리소스 컨트롤러 액션에는 라우트 이름이 있습니다. 하지만 원하는 라우트 이름을 담은 names 배열을 전달하여 이 이름을 재정의할 수 있습니다.

use App\Http\Controllers\PhotoController;

Route::resource('photos', PhotoController::class)->names([
    'create' => 'photos.build'
]);

리소스 라우트 파라미터 이름 지정

기본적으로 Route::resource는 리소스 이름을 "단수형"으로 바꾼 값을 기준으로 리소스 라우트의 라우트 파라미터를 생성합니다. parameters 메서드를 사용하면 리소스별로 이를 쉽게 재정의할 수 있습니다. parameters 메서드에 전달하는 배열은 리소스 이름과 파라미터 이름으로 이루어진 연관 배열이어야 합니다.

use App\Http\Controllers\AdminUserController;

Route::resource('users', AdminUserController::class)->parameters([
    'users' => 'admin_user'
]);

위 예제는 리소스의 show 라우트에 대해 다음 URI를 생성합니다.

/users/{admin_user}

리소스 라우트 범위 지정

Laravel의 범위가 지정된 암묵적 모델 바인딩 기능은 중첩 바인딩의 범위를 자동으로 지정하여, 해석된 자식 모델이 부모 모델에 속하는지 확인할 수 있습니다. 중첩 리소스를 정의할 때 scoped 메서드를 사용하면 자동 범위 지정을 활성화할 수 있으며, 자식 리소스를 어떤 필드로 조회해야 하는지도 Laravel에 알려줄 수 있습니다.

use App\Http\Controllers\PhotoCommentController;

Route::resource('photos.comments', PhotoCommentController::class)->scoped([
    'comment' => 'slug',
]);

이 라우트는 다음과 같은 URI로 접근할 수 있는 범위가 지정된 중첩 리소스를 등록합니다.

/photos/{photo}/comments/{comment:slug}

사용자 정의 키를 사용하는 암묵적 바인딩을 중첩 라우트 파라미터로 사용할 때, Laravel은 관례에 따라 부모 모델의 연관관계 이름을 추측하고, 부모를 기준으로 중첩 모델을 조회하도록 쿼리 범위를 자동으로 지정합니다. 이 경우 Photo 모델에 comments라는 이름의 연관관계(라우트 파라미터 이름의 복수형)가 있다고 가정하며, 이 연관관계를 사용해 Comment 모델을 조회할 수 있습니다.

리소스 URI 현지화

기본적으로 Route::resource는 영어 동사와 복수형 규칙을 사용해 리소스 URI를 생성합니다. create와 edit 액션 동사를 현지화해야 한다면 Route::resourceVerbs 메서드를 사용할 수 있습니다. 이 작업은 애플리케이션의 App\Providers\AppServiceProvider 안에 있는 boot 메서드의 시작 부분에서 수행할 수 있습니다.

/**
 * Bootstrap any application services.
 */
public function boot(): void
{
    Route::resourceVerbs([
        'create' => 'crear',
        'edit' => 'editar',
    ]);
}

Laravel의 복수형 변환기는 필요에 따라 설정할 수 있는 여러 언어를 지원합니다. 동사와 복수형 언어를 사용자 정의하고 나면, Route::resource('publicacion', PublicacionController::class) 같은 리소스 라우트 등록은 다음 URI를 생성합니다.

/publicacion/crear

/publicacion/{publicaciones}/editar

리소스 컨트롤러 보완

기본 리소스 라우트 세트 외에 리소스 컨트롤러에 추가 라우트를 더해야 한다면, Route::resource 메서드를 호출하기 전에 해당 라우트를 정의해야 합니다. 그렇지 않으면 resource 메서드가 정의한 라우트가 보조 라우트보다 의도치 않게 우선될 수 있습니다.

use App\Http\Controller\PhotoController;

Route::get('/photos/popular', [PhotoController::class, 'popular']);
Route::resource('photos', PhotoController::class);

컨트롤러의 역할을 집중해서 유지해야 한다는 점을 기억하십시오. 일반적인 리소스 액션 세트 밖의 메서드가 반복적으로 필요하다면, 컨트롤러를 더 작은 두 개의 컨트롤러로 나누는 것을 고려하십시오.

싱글턴 리소스 컨트롤러

때로는 애플리케이션에 단 하나의 인스턴스만 가질 수 있는 리소스가 있습니다. 예를 들어 사용자의 "profile"은 편집하거나 업데이트할 수 있지만, 한 사용자가 둘 이상의 "profile"을 가질 수는 없습니다. 마찬가지로 이미지에는 하나의 "thumbnail"만 있을 수 있습니다. 이러한 리소스를 "싱글턴 리소스(singleton resources)"라고 하며, 리소스 인스턴스가 오직 하나만 존재할 수 있다는 뜻입니다. 이런 상황에서는 "singleton" 리소스 컨트롤러를 등록할 수 있습니다.

use App\Http\Controllers\ProfileController;
use Illuminate\Support\Facades\Route;

Route::singleton('profile', ProfileController::class);

위의 싱글턴 리소스 정의는 다음 라우트를 등록합니다. 보시다시피 싱글턴 리소스에는 "생성" 라우트가 등록되지 않으며, 리소스 인스턴스가 하나만 존재할 수 있으므로 등록된 라우트는 식별자를 받지 않습니다.

HTTP 동사	URI	액션	라우트 이름
GET	/profile	show	profile.show
GET	/profile/edit	edit	profile.edit
PUT/PATCH	/profile	update	profile.update

싱글턴 리소스는 표준 리소스 안에 중첩할 수도 있습니다.

Route::singleton('photos.thumbnail', ThumbnailController::class);

이 예제에서 photos 리소스는 표준 리소스 라우트를 모두 받습니다. 하지만 thumbnail 리소스는 다음 라우트를 가진 싱글턴 리소스가 됩니다.

HTTP 동사	URI	액션	라우트 이름
GET	/photos/{photo}/thumbnail	show	photos.thumbnail.show
GET	/photos/{photo}/thumbnail/edit	edit	photos.thumbnail.edit
PUT/PATCH	/photos/{photo}/thumbnail	update	photos.thumbnail.update

생성 가능한 싱글턴 리소스

경우에 따라 싱글턴 리소스에 대한 생성 및 저장 라우트를 정의하고 싶을 수 있습니다. 이를 위해 싱글턴 리소스 라우트를 등록할 때 creatable 메서드를 호출할 수 있습니다.

Route::singleton('photos.thumbnail', ThumbnailController::class)->creatable();

이 예제에서는 다음 라우트가 등록됩니다. 보시다시피 생성 가능한 싱글턴 리소스에는 DELETE 라우트도 함께 등록됩니다.

HTTP 동사	URI	액션	라우트 이름
GET	/photos/{photo}/thumbnail/create	create	photos.thumbnail.create
POST	/photos/{photo}/thumbnail	store	photos.thumbnail.store
GET	/photos/{photo}/thumbnail	show	photos.thumbnail.show
GET	/photos/{photo}/thumbnail/edit	edit	photos.thumbnail.edit
PUT/PATCH	/photos/{photo}/thumbnail	update	photos.thumbnail.update
DELETE	/photos/{photo}/thumbnail	destroy	photos.thumbnail.destroy

Laravel이 싱글턴 리소스에 대해 DELETE 라우트는 등록하되 생성 또는 저장 라우트는 등록하지 않도록 하려면 destroyable 메서드를 사용할 수 있습니다.

Route::singleton(...)->destroyable();

API 싱글턴 리소스

apiSingleton 메서드는 API를 통해 조작되는 싱글턴 리소스를 등록할 때 사용할 수 있습니다. 따라서 create와 edit 라우트는 필요하지 않습니다.

Route::apiSingleton('profile', ProfileController::class);

물론 API 싱글턴 리소스도 creatable로 만들 수 있으며, 이 경우 해당 리소스에 대해 store와 destroy 라우트가 등록됩니다.

Route::apiSingleton('photos.thumbnail', ProfileController::class)->creatable();

Middleware와 리소스 컨트롤러

Laravel은 middleware, middlewareFor, withoutMiddlewareFor 메서드를 사용해 리소스 라우트의 모든 메서드 또는 특정 메서드에만 Middleware를 할당할 수 있게 해줍니다. 이 메서드들은 각 리소스 액션에 어떤 Middleware를 적용할지 세밀하게 제어할 수 있도록 합니다.

모든 메서드에 Middleware 적용

middleware 메서드를 사용하면 리소스 또는 싱글턴 리소스 라우트가 생성하는 모든 라우트에 Middleware를 할당할 수 있습니다.

Route::resource('users', UserController::class)
    ->middleware(['auth', 'verified']);

Route::singleton('profile', ProfileController::class)
    ->middleware('auth');

특정 메서드에 Middleware 적용

middlewareFor 메서드를 사용하면 주어진 리소스 컨트롤러의 특정 메서드 하나 이상에 Middleware를 할당할 수 있습니다.

Route::resource('users', UserController::class)
    ->middlewareFor('show', 'auth');

Route::apiResource('users', UserController::class)
    ->middlewareFor(['show', 'update'], 'auth');

Route::resource('users', UserController::class)
    ->middlewareFor('show', 'auth')
    ->middlewareFor('update', 'auth');

Route::apiResource('users', UserController::class)
    ->middlewareFor(['show', 'update'], ['auth', 'verified']);

middlewareFor 메서드는 싱글턴 및 API 싱글턴 리소스 컨트롤러와 함께 사용할 수도 있습니다.

Route::singleton('profile', ProfileController::class)
    ->middlewareFor('show', 'auth');

Route::apiSingleton('profile', ProfileController::class)
    ->middlewareFor(['show', 'update'], 'auth');

특정 메서드에서 Middleware 제외

withoutMiddlewareFor 메서드를 사용하면 리소스 컨트롤러의 특정 메서드에서 Middleware를 제외할 수 있습니다.

Route::middleware(['auth', 'verified', 'subscribed'])->group(function () {
    Route::resource('users', UserController::class)
        ->withoutMiddlewareFor('index', ['auth', 'verified'])
        ->withoutMiddlewareFor(['create', 'store'], 'verified')
        ->withoutMiddlewareFor('destroy', 'subscribed');
});

의존성 주입과 컨트롤러 (Dependency Injection and Controllers)

생성자 주입

Laravel 서비스 컨테이너는 모든 Laravel 컨트롤러를 해석하는 데 사용됩니다. 따라서 컨트롤러 생성자에서 필요한 의존성을 타입 힌트로 지정할 수 있습니다. 선언된 의존성은 자동으로 해석되어 컨트롤러 인스턴스에 주입됩니다.

<?php

namespace App\Http\Controllers;

use App\Repositories\UserRepository;

class UserController extends Controller
{
    /**
     * Create a new controller instance.
     */
    public function __construct(
        protected UserRepository $users,
    ) {}
}

메서드 주입

생성자 주입뿐만 아니라 컨트롤러 메서드에서도 의존성을 타입 힌트로 지정할 수 있습니다. 메서드 주입의 일반적인 사용 사례는 Illuminate\Http\Request 인스턴스를 컨트롤러 메서드에 주입하는 것입니다.

<?php

namespace App\Http\Controllers;

use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;

class UserController extends Controller
{
    /**
     * Store a new user.
     */
    public function store(Request $request): RedirectResponse
    {
        $name = $request->name;

        // Store the user...

        return redirect('/users');
    }
}

컨트롤러 메서드가 라우트 파라미터의 입력도 기대한다면, 다른 의존성 뒤에 라우트 인수를 나열하십시오. 예를 들어 라우트가 다음과 같이 정의되어 있다면,

use App\Http\Controllers\UserController;

Route::put('/user/{id}', [UserController::class, 'update']);

여전히 Illuminate\Http\Request를 타입 힌트로 지정하면서, 다음처럼 컨트롤러 메서드를 정의해 id 파라미터에 접근할 수 있습니다.

<?php

namespace App\Http\Controllers;

use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;

class UserController extends Controller
{
    /**
     * Update the given user.
     */
    public function update(Request $request, string $id): RedirectResponse
    {
        // Update the user...

        return redirect('/users');
    }
}