HTTP 리다이렉트

번역일: 2026년 6월 20일

HTTP 리다이렉트

리다이렉트 생성
이름 있는 라우트로 리다이렉트
컨트롤러 액션으로 리다이렉트
세션 플래시 데이터와 함께 리다이렉트

리다이렉트 생성

리다이렉트 응답은 Illuminate\Http\RedirectResponse 클래스의 인스턴스로, 사용자를 다른 URL로 보내는 데 필요한 HTTP 헤더를 담고 있습니다. RedirectResponse 인스턴스를 만드는 가장 간단한 방법은 전역 redirect 헬퍼를 사용하는 것입니다.

Route::get('/dashboard', function () {
    return redirect('/home/dashboard');
});

폼 유효성 검사에 실패했을 때처럼, 사용자를 이전 페이지로 돌려보내야 할 때는 전역 back 헬퍼를 사용합니다. 이 기능은 세션을 활용하므로, back 함수를 호출하는 라우트는 반드시 web 미들웨어 그룹을 사용하거나 세션 관련 미들웨어가 적용되어 있어야 합니다.

Route::post('/user/profile', function () {
    // 요청 유효성 검사...

    return back()->withInput();
});

이름 있는 라우트로 리다이렉트

redirect 헬퍼를 인수 없이 호출하면 Illuminate\Routing\Redirector 인스턴스가 반환됩니다. 이를 통해 Redirector의 다양한 메서드를 체인으로 호출할 수 있습니다. 예를 들어, 이름 있는 라우트로 리다이렉트하려면 route 메서드를 사용합니다.

return redirect()->route('login');

라우트에 파라미터가 있다면, route 메서드의 두 번째 인수로 전달합니다.

// URI가 profile/{id}인 라우트로 리다이렉트

return redirect()->route('profile', ['id' => 1]);

편의를 위해 전역 to_route 함수도 사용할 수 있습니다.

return to_route('profile', ['id' => 1]);

Eloquent 모델로 파라미터 채우기

ID 파라미터를 Eloquent 모델에서 가져와야 할 때, 모델 인스턴스를 직접 전달하면 ID가 자동으로 추출됩니다.

// URI가 profile/{id}인 라우트로 리다이렉트

return redirect()->route('profile', [$user]);

라우트 파라미터에 사용할 값을 직접 지정하고 싶다면, Eloquent 모델에서 getRouteKey 메서드를 오버라이드하면 됩니다.

/**
 * 모델의 라우트 키 값을 반환합니다.
 */
public function getRouteKey(): mixed
{
    return $this->slug;
}

컨트롤러 액션으로 리다이렉트

컨트롤러 액션으로도 리다이렉트할 수 있습니다. action 메서드에 컨트롤러 클래스와 메서드 이름을 배열로 전달하면 됩니다.

use App\Http\Controllers\HomeController;

return redirect()->action([HomeController::class, 'index']);

컨트롤러 라우트에 파라미터가 필요하다면, action 메서드의 두 번째 인수로 전달합니다.

return redirect()->action(
    [UserController::class, 'profile'], ['id' => 1]
);

세션 플래시 데이터와 함께 리다이렉트

리다이렉트와 세션에 데이터 플래시하는 작업은 보통 함께 이루어집니다. 예를 들어, 어떤 작업이 성공적으로 완료된 후 성공 메시지를 세션에 담아 전달하는 경우가 전형적입니다. RedirectResponse 인스턴스에서 메서드를 체이닝하면 리다이렉트와 플래시를 한 번에 처리할 수 있습니다.

Route::post('/user/profile', function () {
    // 사용자 프로필 업데이트...

    return redirect('/dashboard')->with('status', '프로필이 업데이트되었습니다!');
});

RedirectResponse의 withInput 메서드를 사용하면 현재 요청의 입력값을 세션에 플래시한 뒤 리다이렉트할 수 있습니다. 세션에 저장된 입력값은 다음 요청에서 쉽게 조회할 수 있습니다.

return back()->withInput();

사용자가 리다이렉트된 후에는 세션에서 플래시 메시지를 꺼내 표시할 수 있습니다. 예를 들어 Blade 문법을 사용하면 다음과 같습니다.

@if (session('status'))
    <div class="alert alert-success">
        {{ session('status') }}
    </div>
@endif

NOTE

플래시 데이터는 다음 요청 한 번만 세션에 유지됩니다. 리다이렉트 후 한 번 읽고 나면 자동으로 삭제되므로, 영구적으로 보관해야 하는 데이터에는 적합하지 않습니다.