요청 생명주기

• 소개
• 생명주기 개요
  • 첫 번째 단계
  • HTTP / 콘솔 커널
  • 서비스 프로바이더
  • 라우팅
  • 마무리
• 서비스 프로바이더에 집중하기

소개

어떤 도구든 내부 동작 원리를 이해하면 훨씬 자신 있게 사용할 수 있습니다. 애플리케이션 개발도 마찬가지입니다. Laravel이 요청을 어떻게 처리하는지 알고 나면, 코드를 작성할 때 막막함이 줄어들고 문제가 생겼을 때도 빠르게 원인을 찾을 수 있습니다.

이 문서는 Laravel 프레임워크의 동작 방식을 큰 그림에서 설명합니다. 처음 읽을 때 모든 용어가 바로 이해되지 않더라도 괜찮습니다. 전체 흐름을 대략적으로 파악해 두면, 다른 문서를 읽으면서 자연스럽게 이해가 깊어질 것입니다.

생명주기 개요

아래 다이어그램은 HTTP 요청이 Laravel 애플리케이션에 들어와서 응답이 반환될 때까지의 전체 흐름을 보여줍니다.

첫 번째 단계

Laravel 애플리케이션으로 들어오는 모든 요청의 진입점은 public/index.php 파일입니다. Apache나 Nginx 같은 웹 서버가 모든 요청을 이 파일로 전달하도록 설정됩니다. index.php 자체에는 많은 코드가 없습니다. 프레임워크의 나머지 부분을 불러오는 출발점 역할을 할 뿐입니다.

index.php는 Composer가 생성한 오토로더 정의를 불러온 뒤, bootstrap/app.php에서 Laravel 애플리케이션 인스턴스를 가져옵니다. Laravel이 가장 먼저 하는 일은 바로 이 애플리케이션 인스턴스, 즉 서비스 컨테이너를 생성하는 것입니다.

HTTP / 콘솔 커널

다음으로, 들어온 요청은 그 종류에 따라 HTTP 커널 또는 콘솔 커널로 전달됩니다. 애플리케이션 인스턴스의 handleRequest 또는 handleCommand 메서드를 통해 각각 처리됩니다. 두 커널은 모든 요청이 반드시 통과하는 중심 허브 역할을 합니다.

여기서는 HTTP 커널에 집중해 보겠습니다. HTTP 커널은 Illuminate\Foundation\Http\Kernel 인스턴스입니다.

HTTP 커널은 요청이 실제로 처리되기 전에 실행해야 할 부트스트래퍼(bootstrapper) 목록을 정의합니다. 부트스트래퍼는 에러 처리 설정, 로깅 설정, 애플리케이션 환경 감지 등 요청 처리에 앞서 필요한 작업들을 수행합니다. 이 클래스들은 Laravel 내부 설정을 담당하므로, 일반적으로 직접 신경 쓸 필요는 없습니다.

HTTP 커널은 또한 요청을 애플리케이션의 미들웨어 스택에 통과시킵니다. 미들웨어는 HTTP 세션 읽기/쓰기, 점검 모드(maintenance mode) 여부 확인, CSRF 토큰 검증 등을 처리합니다.

HTTP 커널의 handle 메서드 시그니처는 매우 단순합니다. Request를 받아 Response를 반환합니다. 커널을 거대한 블랙박스라고 생각해도 좋습니다. HTTP 요청을 넣으면 HTTP 응답이 나옵니다.

서비스 프로바이더

커널 부트스트래핑 과정에서 가장 중요한 작업 중 하나는 애플리케이션의 서비스 프로바이더를 로드하는 것입니다. 서비스 프로바이더는 데이터베이스, 큐, 유효성 검사, 라우팅 등 프레임워크의 다양한 구성 요소를 초기화하는 역할을 합니다.

Laravel은 등록된 프로바이더 목록을 순회하며 각각을 인스턴스화합니다. 모든 프로바이더가 인스턴스화되면 먼저 각 프로바이더의 register 메서드가 호출됩니다. 모든 프로바이더의 register가 완료된 후에야 각 프로바이더의 boot 메서드가 호출됩니다.

Laravel이 제공하는 거의 모든 주요 기능은 서비스 프로바이더를 통해 초기화되고 설정됩니다. 그만큼 서비스 프로바이더는 Laravel 부트스트랩 과정의 핵심입니다.

프레임워크 내부적으로 수십 개의 서비스 프로바이더가 사용되며, 직접 만들거나 서드파티 패키지가 제공하는 프로바이더를 추가할 수도 있습니다. 애플리케이션에서 사용하는 사용자 정의 및 서드파티 서비스 프로바이더 목록은 bootstrap/providers.php 파일에서 확인할 수 있습니다.

라우팅

애플리케이션 부트스트래핑이 완료되고 모든 서비스 프로바이더가 등록되면, Request가 라우터로 전달되어 디스패치됩니다. 라우터는 요청을 적절한 라우트 또는 컨트롤러로 연결하고, 해당 라우트에 지정된 미들웨어를 실행합니다.

미들웨어는 애플리케이션으로 들어오는 HTTP 요청을 검사하거나 필터링하는 편리한 메커니즘입니다. 예를 들어, Laravel에는 사용자의 인증 여부를 확인하는 미들웨어가 포함되어 있습니다. 인증되지 않은 사용자라면 로그인 화면으로 리다이렉트하고, 인증된 사용자라면 요청을 계속 진행시킵니다.

PreventRequestsDuringMaintenance처럼 모든 라우트에 적용되는 미들웨어도 있고, 특정 라우트나 라우트 그룹에만 적용되는 미들웨어도 있습니다. 미들웨어에 대한 자세한 내용은 미들웨어 문서를 참고하세요.

요청이 해당 라우트에 지정된 모든 미들웨어를 통과하면, 라우트 또는 컨트롤러 메서드가 실행되고, 반환된 응답이 미들웨어 체인을 역순으로 거쳐 나갑니다.

마무리

라우트 또는 컨트롤러 메서드에서 응답이 반환되면, 그 응답은 라우트의 미들웨어를 역순으로 통과하며 바깥으로 이동합니다. 이 과정에서 애플리케이션은 나가는 응답을 수정하거나 검사할 수 있습니다.

최종적으로 응답이 미들웨어를 모두 통과하면, HTTP 커널의 handle 메서드가 응답 객체를 애플리케이션 인스턴스의 handleRequest로 반환합니다. 그리고 handleRequest는 응답 객체의 send 메서드를 호출해 응답 내용을 사용자의 웹 브라우저로 전송합니다. 이로써 Laravel 요청 생명주기의 전 여정이 완료됩니다!

서비스 프로바이더에 집중하기

서비스 프로바이더는 Laravel 애플리케이션 부트스트래핑의 진정한 핵심입니다. 애플리케이션 인스턴스가 생성되고, 서비스 프로바이더가 등록되며, 요청이 부트스트랩된 애플리케이션으로 전달됩니다. 생명주기의 본질은 바로 이것입니다.

서비스 프로바이더가 Laravel 애플리케이션을 어떻게 구성하고 초기화하는지 확실히 이해해 두면 큰 도움이 됩니다. 애플리케이션에서 직접 정의한 서비스 프로바이더는 app/Providers 디렉토리에 저장됩니다.

기본적으로 AppServiceProvider는 거의 비어 있습니다. 이 프로바이더는 애플리케이션 고유의 부트스트래핑 로직이나 서비스 컨테이너 바인딩을 추가하기에 적합한 장소입니다. 애플리케이션 규모가 커지면, 특정 서비스별로 더 세분화된 부트스트래핑을 담당하는 서비스 프로바이더를 여러 개 만드는 것도 좋은 방법입니다.