[Laravel 11] controller 개별 middleware 적용 에러

laravel 강의는 예전것들이 많이 올해 새로 나온 laravel11 버전에 맞지 않는 경우가 종종 있다. 대부분의 경우 방식은 달라도 자동으로 import 해주거나 하여 개발자가 수작업 할 일이 없지만 middleware 적용에서 에러가 발생했다.

 

[에러 상황]

middleware 에 관한 공부를 하던 중 web.php 에서 route group 에 한번에 middleware를 적용할 수 있음을 배웠다.

 

Route::resource('articles', ArticleController::class)->middleware('auth')->except(['index', 'show']);

 

또한 `except` 를 통해 middleware 처리를 제외할 조건도 확인하였다.

다음으로는 개별 controller 에서 middleware를 처리해 주는 방법을 학습하였다.

Controller가 실행될때 자동으로 적용되게 하기 위해 생성자로 지정해 주었다.

class ArticleController extends Controller
{
    public function __construct()
    {
        $this->middleware('auth')->except(['index', 'show']);
    }

 

하지만 middleware 부분에 warning이 떴고 메소드를 추가하라는 선택지가 나왔다.

 

laravel에 설정되어 있는 middleware 메소드를 알아서 찾았어야 하는데 해당 메소드를 Class 내에서 찾고, 이것이 없다는 것이다.

 

실제 import를 하려고 하면 해당 메소드를 구현하거나, 이름을 변경하거나의 선택지가 있다. `Add @method` 해봤지만 동작하지 않았고, 아래와 같은 화면이 노출되었다.

이 외에도 강의와 다르게 라라벨 11버전에서는 몇가지 다른 점이 있었다.

[1] Laravel11 버전의 업데이트 내용

버전 문제일수 있다 생각하여 검색해 보니 실제 Laravel11 버전에서는 middleware 관련하여 몇가지 변경사항이 있었다.

https://rezakhademix.medium.com/laravel-11-no-http-kernel-no-casts-no-console-kernel-721c62adb6ef

Laravel 11: No Http Kernel, No $casts, No Console Kernel!

 

1. app/http/Middleware 폴더 삭제

더이상 해당 폴더가 지원되지 않는다고 한다. 대신 `app.php` 파일에 middleware 설정이 작성되어 있다고 한다.

 

2. Kernel.xml 파일 삭제

해당 파일도 더이상 존재하지 않는다고 한다. 해당 파일에서 기존에 수정하던 것은 `app.php` 파일에서 작성하라고 한다.

 

[에러 해결]

구글링한 결과 다행히 답을 찾을 수 있었다! 검색은 화면에 노출된 에러메세지로 검색하였다.

검색 : Call to undefined method Controller::middleware()

 

어떤 깃헙 repo의 pr 내역에서 해결법을 찾을 수 있었다.

https://github.com/laravel/framework/issues/50566

Call to undefined method ::middleware() when calling authorizeResource() · Issue #50566 · laravel/framework

To be able to use authorizeResource() in Laravel 11, your base controller class in app\Http\Controllers\Controller.php should extend \Illuminate\Routing\Controller (because that's where the middleware() method is), just like the Controller.php file found in a fresh Laravel 10 installation.

 

Laravel11 에서는 app\Http\Controllers\Controller.php 파일에 작성된 클래스가 상속받아야 한다는 것이다. 상속 대상 클래스가 middleware 메소드를 구현하고 있다고 한다. 그래서 해당 파일을 아래와 같이 작성하였다.

<?php

namespace App\Http\Controllers;

use Illuminate\Foundation\Auth\Access\AuthorizesRequests;

abstract class Controller extends \Illuminate\Routing\Controller
{
    use AuthorizesRequests;
}

 

이후 기존에 작성한 ArticleController로 돌아가보니 middleware 메소드를 사용하는 부분의 warning 라인이 없어지고 command+클릭으로 이동하니 `AuthorizesRequesets` 파일로 이동했다!

 

그리고 기능도 정상적으로 동작하였다!

 

[테스트로 기능확인]

middleware를 적용하고 기존에 작성한 테스트코드를 실행해보니 테스트가 실패하였다.

 

인증관련해서 404가 나올줄알았지만 302인 이유는 실제 화면에서는 미인증 유저가 해당 화면에 접근할 경우 로그인 화면으로 "리다이렉트" 시키기 때문이다! 따라서 리다이렉트 코드인 302가 반환되었다. 

 

해당 테스트코드는 미인증 회원의 접근이 잘 막아지는지로 코드를 수정하고, 로그인한 회원의 테스트코드를 작성하였다.

/**
 * @test
 */
public function 로그인한_사용자는_글쓰기_화면을_볼_수_있다(): void
{
    $user = User::factory()->create();
    $this->actingAs($user)
        ->get(route('articles.create'))
        ->assertStatus(200)
        ->assertSee('글쓰기');
}

테스트 성공!