요청 생명주기 (Request Lifecycle)
소개 (Introduction)
"실제 환경"에서 어떤 도구를 사용할 때, 그 도구가 어떻게 동작하는지 이해하면 더 자신감을 갖게 됩니다. 애플리케이션 개발도 마찬가지입니다. 개발 도구가 어떻게 작동하는지 알면 더 편안하고 자신 있게 도구를 사용할 수 있습니다.
이 문서의 목표는 Laravel 프레임워크가 어떻게 작동하는지에 대한 전체적인 개념을 고수준에서 이해할 수 있도록 돕는 것입니다. 프레임워크 전체를 더 잘 알게 되면 모든 것이 덜 '마법처럼' 느껴지고 애플리케이션을 구축하는 데 더 자신감이 생깁니다. 처음에 모든 용어를 완벽히 이해하지 못하더라도 낙담하지 마세요! 우선 전반적으로 어떤 일이 일어나는지 기본 개념을 파악하려고 노력하면, 문서의 다른 부분을 살펴보면서 자연스럽게 지식이 쌓일 것입니다.
생명주기 개요 (Lifecycle Overview)
처음 단계
Laravel 애플리케이션으로 들어오는 모든 요청의 진입점은 public/index.php 파일입니다. 모든 요청은 웹 서버(Apache / Nginx)의 설정에 의해 이 파일로 전달됩니다. index.php 파일 자체에는 많은 코드가 포함되어 있지 않습니다. 대신 나머지 프레임워크를 로드하는 시작점 역할을 합니다.
index.php 파일은 Composer가 생성한 오토로더 정의를 불러오고, bootstrap/app.php에서 Laravel 애플리케이션 인스턴스를 가져옵니다. Laravel이 가장 먼저 하는 작업은 애플리케이션 / 서비스 컨테이너 인스턴스를 생성하는 것입니다.
HTTP / 콘솔 커널
다음으로, 들어오는 요청은 애플리케이션 인스턴스의 handleRequest 또는 handleCommand 메서드를 통해 각각 HTTP 커널 또는 콘솔 커널로 전달됩니다. 이는 요청 유형에 따라 달라집니다. 이 두 커널은 모든 요청이 흐르는 중앙 허브 역할을 합니다. 여기서는 HTTP 커널에 집중해 보겠습니다. HTTP 커널은 Illuminate\Foundation\Http\Kernel 클래스의 인스턴스입니다.
HTTP 커널은 요청이 처리되기 전에 실행될 bootstrappers 배열을 정의합니다. 이 부트스트래퍼들은 오류 처리 설정, 로그 설정, 애플리케이션 환경 감지와 같이 요청 처리 전에 필요한 여러 작업을 수행합니다. 일반적으로 이 클래스들은 Laravel 내부 설정을 처리하며, 여러분이 직접 신경 쓸 부분은 아닙니다.
또한 HTTP 커널은 요청을 애플리케이션의 미들웨어 스택으로 전달하는 역할도 합니다. 이 미들웨어들은 HTTP 세션을 읽고 쓰는 작업, 애플리케이션이 유지보수 모드인지 확인, CSRF 토큰 검증 등 다양한 역할을 수행합니다. 이런 부분들은 곧 더 자세히 설명할 예정입니다.
HTTP 커널의 handle 메서드 시그니처는 매우 간단합니다: Request 객체를 받아 Response 객체를 반환합니다. 커널은 여러분의 애플리케이션 전체를 대표하는 큰 블랙박스 같은 역할을 한다고 생각하면 됩니다. HTTP 요청을 넣으면 HTTP 응답을 내보내죠.
서비스 프로바이더
커널 부트스트래핑 과정에서 가장 중요한 작업 중 하나는 애플리케이션의 서비스 프로바이더를 로드하는 것입니다. 서비스 프로바이더는 데이터베이스, 큐, 유효성 검증, 라우팅 등 프레임워크의 다양한 구성 요소들을 부트스트랩하는 역할을 담당합니다.
Laravel은 서비스 프로바이더 리스트를 순회하면서 각 프로바이더를 인스턴스화합니다. 프로바이더 인스턴스가 생성되면, 모든 프로바이더에 대해 register 메서드가 호출됩니다. 그 다음 등록이 완료된 모든 프로바이더에 대해 boot 메서드가 호출됩니다. 이렇게 하는 이유는 모든 컨테이너 바인딩이 등록 완료된 후에 boot 메서드가 실행되도록 해 서비스 프로바이더들이 서로 의존할 수 있게 하려는 것입니다.
Laravel이 제공하는 거의 모든 주요 기능은 서비스 프로바이더를 통해 부트스트랩되고 설정됩니다. 프레임워크가 제공하는 수많은 기능을 부트스트랩하고 구성하기 때문에, 서비스 프로바이더는 전체 Laravel 부트스트랩 과정에서 가장 중요한 부분입니다.
내부적으로 수십 개의 서비스 프로바이더를 사용하지만, 여러분도 직접 서비스 프로바이더를 만들어 사용할 수 있습니다. 여러분의 애플리케이션에서 사용 중인 사용자 정의 또는 서드파티 서비스 프로바이더 목록은 bootstrap/providers.php 파일에서 확인할 수 있습니다.
라우팅
애플리케이션이 부트스트랩되고 모든 서비스 프로바이더가 등록되면, Request는 라우터에게 전달되어 요청을 디스패치합니다. 라우터는 요청을 라우트나 컨트롤러로 전달하고, 라우트에 지정된 미들웨어를 실행합니다.
미들웨어는 애플리케이션으로 들어오는 HTTP 요청을 필터링하거나 검사하는 편리한 메커니즘을 제공합니다. 예를 들어, Laravel에는 사용자가 인증되었는지 확인하는 미들웨어가 포함되어 있습니다. 인증이 되어 있지 않으면 이 미들웨어는 사용자를 로그인 화면으로 리다이렉트합니다. 인증된 경우 요청이 애플리케이션 내부로 계속 진행됩니다. 어떤 미들웨어는 PreventRequestsDuringMaintenance처럼 애플리케이션 내 모든 라우트에 할당되어 있고, 어떤 미들웨어는 특정 라우트나 라우트 그룹에만 할당되어 있습니다. 미들웨어에 대한 자세한 내용은 전체 미들웨어 문서를 참고하세요.
요청이 매칭된 라우트에 할당된 모든 미들웨어를 통과하면, 라우트 또는 컨트롤러 메서드가 실행되고, 이 메서드가 반환하는 응답은 다시 라우트의 미들웨어 체인을 거쳐 전송됩니다.
마무리
라우트 또는 컨트롤러 메서드가 응답을 반환하면, 응답은 라우트의 미들웨어를 거슬러 다시 전달됩니다. 이를 통해 애플리케이션이 나가는 응답을 수정하거나 검사할 기회를 가집니다.
마지막으로, 응답이 미들웨어를 모두 통과하면 HTTP 커널의 handle 메서드는 응답 객체를 애플리케이션 인스턴스의 handleRequest로 반환하고, 해당 메서드는 반환된 응답의 send 메서드를 호출합니다. send 메서드는 응답 내용을 사용자의 웹 브라우저로 전송합니다. 이렇게 해서 Laravel 요청 생명주기를 완벽히 마친 것입니다!
서비스 프로바이더 집중 탐구 (Focus on Service Providers)
서비스 프로바이더는 Laravel 애플리케이션을 부트스트랩하는 핵심입니다. 애플리케이션 인스턴스가 생성되고, 서비스 프로바이더들이 등록되며, 부트스트랩된 애플리케이션에 요청이 전달됩니다. 정말 그만큼 단순합니다!
Laravel 애플리케이션이 어떻게 구축되고 서비스 프로바이더를 통해 부트스트랩되는지 확실히 이해하는 것은 매우 중요합니다. 여러분이 직접 정의하는 서비스 프로바이더들은 app/Providers 디렉토리에 저장됩니다.
기본적으로 AppServiceProvider는 꽤 비어 있는 상태입니다. 이 프로바이더는 여러분 애플리케이션만의 부트스트랩 작업과 서비스 컨테이너 바인딩을 추가하기에 좋은 장소입니다. 대규모 애플리케이션의 경우, 특정 서비스별로 더 세분화된 부트스트랩 작업을 처리하는 여러 서비스 프로바이더를 만드는 것이 좋습니다.