요청 생명주기
번역일: 2026년 6월 20일
요청 생명주기
소개
어떤 도구든 작동 원리를 이해하면 훨씬 자신 있게 사용할 수 있습니다. 애플리케이션 개발도 마찬가지입니다. Laravel이 내부적으로 어떻게 동작하는지 알면, 프레임워크가 덜 "마법처럼" 느껴지고 문제가 생겼을 때도 더 빠르게 원인을 찾을 수 있습니다.
이 문서는 Laravel 프레임워크의 전체 흐름을 높은 수준에서 파악할 수 있도록 안내합니다. 처음에는 낯선 용어가 나오더라도 걱정하지 마세요. 대략적인 흐름을 먼저 잡아두면, 다른 문서를 읽으면서 자연스럽게 이해가 깊어집니다.
생명주기 개요
아래 다이어그램은 HTTP 요청이 Laravel 애플리케이션을 통과하는 전체 흐름을 요약합니다.
첫 번째 단계
Laravel 애플리케이션으로 들어오는 모든 요청의 진입점은 public/index.php 파일입니다. Apache나 Nginx 같은 웹 서버는 설정에 따라 모든 요청을 이 파일로 전달합니다. index.php 자체에는 코드가 많지 않습니다. 이 파일의 역할은 프레임워크의 나머지 부분을 불러오는 시작점 역할을 하는 것입니다.
index.php는 Composer가 생성한 오토로더 정의를 로드한 다음, bootstrap/app.php에서 Laravel 애플리케이션 인스턴스를 가져옵니다. Laravel이 가장 먼저 하는 일은 애플리케이션 인스턴스, 즉 서비스 컨테이너를 생성하는 것입니다.
HTTP / 콘솔 커널
다음으로, 들어온 요청은 요청의 종류에 따라 HTTP 커널 또는 콘솔 커널 중 하나로 전달됩니다. 두 커널 모두 모든 요청이 반드시 통과하는 중앙 허브 역할을 합니다. 여기서는 app/Http/Kernel.php에 위치한 HTTP 커널을 중심으로 살펴보겠습니다.
HTTP 커널은 Illuminate\Foundation\Http\Kernel 클래스를 상속하며, 요청이 실제로 처리되기 전에 실행될 부트스트래퍼(bootstrappers) 배열을 정의합니다. 부트스트래퍼는 에러 처리 설정, 로깅 설정, 애플리케이션 환경 감지 등 요청 처리 전에 반드시 준비되어야 하는 작업들을 담당합니다. 이 클래스들은 대부분 Laravel 내부 설정을 처리하므로, 개발자가 직접 신경 쓸 필요는 없습니다.
HTTP 커널은 또한 애플리케이션이 요청을 처리하기 전에 모든 요청이 통과해야 하는 미들웨어 목록을 정의합니다. 이 미들웨어들은 HTTP 세션 읽기/쓰기, 점검 모드(maintenance mode) 확인, CSRF 토큰 검증 등을 처리합니다.
HTTP 커널의 handle 메서드 시그니처는 단순합니다. Request를 받아서 Response를 반환합니다. 커널을 애플리케이션 전체를 감싸는 하나의 큰 블랙박스라고 생각해도 좋습니다. HTTP 요청을 넣으면 HTTP 응답이 나오는 구조입니다.
서비스 프로바이더
커널 부트스트랩 과정에서 가장 중요한 작업 중 하나는 애플리케이션의 서비스 프로바이더를 로드하는 것입니다. 서비스 프로바이더는 데이터베이스, 큐, 유효성 검사, 라우팅 등 프레임워크의 다양한 구성 요소를 초기화하는 역할을 합니다. 애플리케이션에서 사용하는 모든 서비스 프로바이더는 config/app.php의 providers 배열에 등록됩니다.
Laravel은 이 목록을 순회하며 각 프로바이더를 인스턴스화합니다. 인스턴스화가 완료되면 모든 프로바이더의 register 메서드가 먼저 호출되고, 그 다음 모든 프로바이더의 boot 메서드가 호출됩니다. boot가 실행될 시점에는 모든 컨테이너 바인딩이 이미 등록된 상태이므로, boot 안에서 다른 바인딩에 안전하게 의존할 수 있습니다.
NOTE
register에서는 다른 서비스 프로바이더의 서비스를 사용하지 마세요. 아직 해당 프로바이더가 등록되지 않았을 수 있습니다. 다른 서비스에 의존하는 로직은 반드시 boot 메서드에 작성하세요.
Laravel이 제공하는 거의 모든 주요 기능은 서비스 프로바이더를 통해 초기화되고 설정됩니다. 서비스 프로바이더는 Laravel 부트스트랩 과정에서 가장 핵심적인 요소입니다.
라우팅
애플리케이션에서 가장 중요한 서비스 프로바이더 중 하나는 App\Providers\RouteServiceProvider입니다. 이 프로바이더는 애플리케이션의 routes 디렉터리에 있는 라우트 파일들을 로드합니다. RouteServiceProvider 코드를 직접 열어서 동작 방식을 살펴보는 것을 권장합니다.
애플리케이션 부트스트랩이 완료되고 모든 서비스 프로바이더가 등록되면, Request는 라우터로 전달되어 디스패치됩니다. 라우터는 요청을 적절한 라우트 또는 컨트롤러로 전달하고, 해당 라우트에 지정된 미들웨어를 실행합니다.
미들웨어는 애플리케이션으로 들어오는 HTTP 요청을 필터링하거나 검사하는 편리한 메커니즘을 제공합니다. 예를 들어, Laravel에는 사용자의 인증 여부를 확인하는 미들웨어가 내장되어 있습니다. 인증되지 않은 사용자는 로그인 페이지로 리디렉션되고, 인증된 사용자는 요청이 계속 진행됩니다. 일부 미들웨어는 HTTP 커널의 $middleware 속성에 정의되어 모든 라우트에 적용되고, 일부는 특정 라우트나 라우트 그룹에만 적용됩니다. 자세한 내용은 미들웨어 문서를 참고하세요.
요청이 해당 라우트에 지정된 모든 미들웨어를 통과하면, 라우트 또는 컨트롤러 메서드가 실행됩니다. 반환된 응답은 다시 미들웨어 체인을 역방향으로 거슬러 올라가며 전달됩니다.
마무리
라우트 또는 컨트롤러 메서드가 응답을 반환하면, 그 응답은 미들웨어 체인을 역방향으로 통과합니다. 이 과정에서 애플리케이션은 나가는 응답을 수정하거나 검사할 수 있습니다.
마지막으로, 응답이 모든 미들웨어를 통과하면 HTTP 커널의 handle 메서드가 응답 객체를 반환하고, index.php는 반환된 응답 객체의 send 메서드를 호출합니다. send 메서드는 응답 내용을 사용자의 웹 브라우저로 전송합니다. 이로써 Laravel 요청 생명주기의 전체 여정이 완료됩니다.
서비스 프로바이더에 집중하기
서비스 프로바이더는 Laravel 애플리케이션 부트스트랩의 핵심입니다. 애플리케이션 인스턴스가 생성되고, 서비스 프로바이더가 등록되며, 요청이 부트스트랩된 애플리케이션에 전달됩니다. 전체 구조는 이것이 전부입니다.
Laravel 애플리케이션이 서비스 프로바이더를 통해 어떻게 구성되고 초기화되는지를 잘 이해해두면 실제 개발에서 큰 도움이 됩니다. 기본 서비스 프로바이더들은 app/Providers 디렉터리에 저장됩니다.
기본적으로 AppServiceProvider는 내용이 거의 비어 있습니다. 이 프로바이더는 애플리케이션 고유의 부트스트래핑 로직이나 서비스 컨테이너 바인딩을 추가하기에 좋은 위치입니다. 애플리케이션 규모가 커지면, 특정 서비스별로 더 세분화된 서비스 프로바이더를 별도로 만드는 것도 좋은 방법입니다.