설치

업데이트됨

번역일: 2026년 8월 4일

이 페이지는 원문이 업데이트되어 번역이 갱신되었습니다.

원문 수정: 2026년 8월 4일
번역 갱신: 2026년 8월 4일

설치

Laravel 소개
- 왜 Laravel인가?
Laravel 애플리케이션 만들기
초기 설정
Herd로 설치하기
- macOS에서 Herd
- Windows에서 Herd
IDE 지원
Laravel과 AI
- Laravel Boost 설치
다음 단계
- 풀스택 프레임워크로 사용하기
- API 백엔드로 사용하기

Laravel 소개

Laravel은 표현력 있고 우아한 문법을 갖춘 웹 애플리케이션 프레임워크입니다. 프레임워크는 애플리케이션을 만드는 데 필요한 구조와 출발점을 제공합니다. 덕분에 개발자는 세부적인 구현 사항보다 실제로 만들고 싶은 것에 집중할 수 있습니다.

Laravel은 뛰어난 개발자 경험을 제공하는 동시에, 완전한 의존성 주입(dependency injection), 표현력 높은 데이터베이스 추상화 레이어, 큐와 예약 Job, 단위 및 통합 테스트 등 강력한 기능을 함께 제공합니다.

PHP 웹 프레임워크를 처음 접하든, 수년간의 경험을 가진 개발자든 Laravel은 함께 성장하는 프레임워크입니다. 웹 개발의 첫걸음을 내딛는 분께는 든든한 길잡이가 되고, 전문성을 높이려는 분께는 강력한 도구를 제공합니다.

왜 Laravel인가?

웹 애플리케이션을 만들 때 선택할 수 있는 도구와 프레임워크는 다양합니다. 그럼에도 Laravel은 현대적인 풀스택 웹 애플리케이션을 구축하는 데 가장 적합한 선택이라고 자신 있게 말할 수 있습니다.

단계적으로 성장하는 프레임워크

Laravel은 "점진적(progressive)" 프레임워크입니다. 웹 개발을 처음 시작하는 분이라면 방대한 공식 문서, 가이드, 영상 튜토리얼(Laracasts)이 부담 없이 배워나갈 수 있도록 안내합니다.

경험 있는 시니어 개발자에게는 의존성 주입, 단위 테스트, 큐, 실시간 이벤트 등 견고한 도구를 제공합니다. Laravel은 전문적인 웹 애플리케이션 개발에 최적화되어 있으며 엔터프라이즈 수준의 워크로드도 충분히 처리할 수 있습니다.

확장 가능한 프레임워크

Laravel은 뛰어난 확장성을 자랑합니다. PHP의 수평 확장 친화적인 특성과 Redis 같은 빠른 분산 캐시 시스템에 대한 내장 지원 덕분에 수평 확장이 매우 용이합니다. 실제로 Laravel 애플리케이션은 월 수억 건의 요청을 문제없이 처리한 사례가 있습니다.

극단적인 확장이 필요한 경우에는 Laravel Cloud를 통해 사실상 무제한에 가까운 규모로 운영할 수도 있습니다.

AI 개발에 최적화된 프레임워크

Laravel의 명확한 컨벤션과 잘 정의된 구조는 Cursor, Claude Code 같은 도구를 활용한 AI 지원 개발에 이상적입니다. AI 에이전트에게 컨트롤러를 추가하라고 하면, 어디에 파일을 만들어야 할지 즉시 압니다. 새 마이그레이션이 필요할 때도 네이밍 컨벤션과 파일 위치가 예측 가능합니다. 이런 일관성이 유연성 위주의 다른 프레임워크에서 AI 도구가 자주 실수하는 부분을 없애줍니다.

파일 구성 외에도 Laravel의 표현력 있는 문법과 풍부한 공식 문서는 AI 에이전트가 정확하고 관용적인 코드를 생성하는 데 필요한 맥락을 충분히 제공합니다. Eloquent 관계, Form Request, 미들웨어 같은 기능들은 에이전트가 안정적으로 이해하고 재현할 수 있는 패턴을 따릅니다. 결과적으로 AI가 생성한 코드도 마치 숙련된 Laravel 개발자가 작성한 것처럼 자연스럽습니다.

자세한 내용은 에이전트 개발 문서를 참고하세요.

커뮤니티 프레임워크

Laravel은 PHP 생태계 최고의 패키지들을 결합하여 가장 견고하고 개발자 친화적인 프레임워크를 만들어냅니다. 또한 전 세계 수천 명의 개발자가 프레임워크 개발에 기여하고 있습니다. 여러분도 언젠가 기여자가 될 수 있습니다.

Laravel 애플리케이션 만들기

AI로 시작하기

Claude Code나 OpenCode 같은 AI 코딩 에이전트를 사용한다면, 프로젝트를 시작하기 전에 에이전트에게 Laravel 전용 지침서를 먼저 제공할 수 있습니다.

아래 프롬프트는 에이전트에게 Laravel 설치 방법을 어디서 찾을지, 어떤 사항을 우선시할지, 아직 선택하지 않은 항목에 대해 어떤 기본값을 사용할지를 알려줍니다. 에이전트에 아래 내용을 붙여넣어 시작해보세요:

I'm building a new Laravel application.

Fetch and follow the instructions from https://laravel.com/for/agents. Treat the returned Markdown as the source of truth for how to install and set up Laravel in this session.

에이전트가 지침을 읽고 나면, Laravel 기본 설정에 맞게 단계별로 안내를 진행합니다.

PHP 및 Laravel 인스톨러 설치

첫 Laravel 애플리케이션을 만들기 전에 로컬 머신에 PHP, Composer, 그리고 Laravel 인스톨러가 설치되어 있어야 합니다. 프론트엔드 에셋 컴파일을 위해 Node와 NPM 또는 Bun도 설치하는 것을 권장합니다.

PHP와 Composer가 아직 설치되지 않았다면, 아래 명령어 하나로 PHP, Composer, Laravel 인스톨러를 한 번에 설치할 수 있습니다:

macOS

/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.5)"

Windows PowerShell

# 관리자 권한으로 실행하세요...
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://php.new/install/windows/8.5'))

Linux

/bin/bash -c "$(curl -fsSL https://php.new/install/linux/8.5)"

위 명령어를 실행한 후에는 터미널 세션을 재시작해야 합니다. php.new를 통해 설치한 PHP, Composer, Laravel 인스톨러를 나중에 업데이트하려면 같은 명령어를 다시 실행하면 됩니다.

PHP와 Composer가 이미 설치되어 있다면 Composer를 통해 Laravel 인스톨러만 별도로 설치할 수 있습니다:

composer global require laravel/installer

NOTE

GUI 기반의 PHP 설치 및 관리 환경을 원한다면 Laravel Herd를 확인해보세요.

애플리케이션 생성

PHP, Composer, Laravel 인스톨러 설치가 완료되면 새 Laravel 애플리케이션을 만들 수 있습니다:

laravel new example-app

애플리케이션이 생성되면 dev Composer 스크립트로 로컬 개발 서버, 큐 워커, Vite 개발 서버를 한 번에 시작할 수 있습니다:

cd example-app
npm install && npm run build
composer run dev

개발 서버가 실행되면 브라우저에서 http://localhost:8000으로 접속할 수 있습니다. 이제 Laravel 생태계의 다음 단계로 나아갈 준비가 되었습니다. 필요에 따라 데이터베이스를 설정하고 마이그레이션을 실행해보세요.

NOTE

Laravel 애플리케이션 개발을 빠르게 시작하고 싶다면 공식 스타터 킷을 활용해보세요. 스타터 킷은 백엔드와 프론트엔드 인증 스캐폴딩을 기본으로 제공합니다.

초기 설정

Laravel 프레임워크의 모든 설정 파일은 config 디렉토리에 있습니다. 각 옵션에는 설명이 포함되어 있으니, 파일들을 살펴보며 어떤 옵션이 있는지 파악해두면 좋습니다.

Laravel은 별도의 추가 설정 없이도 바로 개발을 시작할 수 있습니다. 다만 config/app.php 파일은 한 번 살펴보기를 권장합니다. 애플리케이션의 url이나 locale 같이 프로젝트 상황에 맞게 변경할 수 있는 옵션들이 담겨 있습니다.

환경 기반 설정

Laravel의 설정 값 중 상당수는 로컬 개발 환경인지 프로덕션 서버인지에 따라 달라집니다. 이런 중요한 설정값들은 프로젝트 루트의 .env 파일에 정의합니다.

.env 파일은 개발자마다, 서버마다 다른 환경 설정이 필요하기 때문에 소스 컨트롤(예: Git)에 커밋하지 않아야 합니다. 또한 저장소에 접근 권한을 얻은 외부인이 민감한 인증 정보를 열람할 수 있으므로 보안상으로도 반드시 제외해야 합니다.

NOTE

.env 파일과 환경 기반 설정에 대한 자세한 내용은 설정 문서를 참고하세요.

데이터베이스와 마이그레이션

Laravel 애플리케이션을 만들었다면 이제 데이터를 데이터베이스에 저장할 차례입니다. 기본적으로 .env 설정 파일은 SQLite 데이터베이스를 사용하도록 지정되어 있습니다.

애플리케이션 생성 시 Laravel이 database/database.sqlite 파일을 자동으로 만들고, 기본 테이블 생성을 위한 마이그레이션도 실행해줍니다.

MySQL이나 PostgreSQL 같은 다른 데이터베이스를 사용하고 싶다면 .env 파일의 DB_* 항목을 아래와 같이 수정하세요. 예를 들어 MySQL을 사용하는 경우:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

SQLite 외의 데이터베이스를 선택한 경우, 데이터베이스를 직접 생성한 후 데이터베이스 마이그레이션을 실행해야 합니다:

php artisan migrate

NOTE

macOS나 Windows에서 MySQL, PostgreSQL, Redis를 로컬에 설치해야 한다면 Herd Pro나 DBngin을 고려해보세요.

디렉토리 설정

Laravel은 반드시 웹 서버에 설정된 "웹 디렉토리(document root)"의 루트에서 서빙되어야 합니다. 웹 디렉토리의 하위 디렉토리에서 Laravel 애플리케이션을 서빙하려 하면 안 됩니다. 그렇게 할 경우 애플리케이션 내부의 민감한 파일이 외부에 노출될 수 있습니다.

Herd로 설치하기

Laravel Herd는 macOS와 Windows를 위한 매우 빠른 네이티브 Laravel·PHP 개발 환경입니다. PHP와 Nginx를 비롯해 Laravel 개발에 필요한 모든 것이 포함되어 있습니다.

Herd를 설치하면 바로 Laravel 개발을 시작할 수 있습니다. php, composer, laravel, expose, node, npm, nvm 등의 커맨드라인 도구가 함께 제공됩니다.

NOTE

Herd Pro를 사용하면 로컬 MySQL, PostgreSQL, Redis 데이터베이스 생성 및 관리, 로컬 메일 확인, 로그 모니터링 같은 추가 기능을 활용할 수 있습니다.

macOS에서 Herd

macOS에서 개발한다면 Herd 웹사이트에서 인스톨러를 내려받을 수 있습니다. 인스톨러는 최신 PHP 버전을 자동으로 내려받고, 백그라운드에서 Nginx가 항상 실행되도록 Mac을 설정합니다.

macOS용 Herd는 dnsmasq를 사용하여 "parked" 디렉토리를 지원합니다. parked 디렉토리에 있는 모든 Laravel 애플리케이션은 Herd가 자동으로 서빙합니다. 기본 parked 디렉토리는 ~/Herd이며, 이 안의 애플리케이션은 디렉토리 이름을 그대로 .test 도메인으로 접근할 수 있습니다.

Herd 설치 후 새 Laravel 애플리케이션을 가장 빠르게 만드는 방법은 Herd에 번들된 Laravel CLI를 사용하는 것입니다:

cd ~/Herdlaravel new my-appcd my-appherd open

parked 디렉토리와 PHP 설정은 시스템 트레이의 Herd 메뉴에서 UI를 통해 관리할 수 있습니다.

더 자세한 내용은 Herd 공식 문서를 참고하세요.

Windows에서 Herd

Windows용 인스톨러도 Herd 웹사이트에서 내려받을 수 있습니다. 설치가 완료되면 Herd를 실행하여 온보딩 과정을 마치고 처음으로 Herd UI에 접근할 수 있습니다.

Herd UI는 시스템 트레이의 Herd 아이콘을 왼쪽 클릭하면 열립니다. 오른쪽 클릭으로는 자주 사용하는 도구에 빠르게 접근할 수 있는 빠른 메뉴가 나타납니다.

설치 시 Herd는 홈 디렉토리에 %USERPROFILE%\Herd를 parked 디렉토리로 생성합니다. 이 디렉토리 안의 Laravel 애플리케이션은 디렉토리 이름으로 .test 도메인에서 자동으로 접근할 수 있습니다.

Herd 설치 후 PowerShell에서 다음 명령어를 실행하면 새 Laravel 애플리케이션을 바로 만들 수 있습니다:

cd ~\Herdlaravel new my-appcd my-appherd open

더 자세한 내용은 Windows용 Herd 공식 문서를 참고하세요.

IDE 지원

Laravel 애플리케이션 개발에는 원하는 어떤 코드 에디터든 사용할 수 있습니다. Laravel LSP는 Laravel과 Blade 코드에 대한 코드 자동완성, 호버 정보, 진단, 문서 링크, 정의로 이동, 빠른 수정 등 프레임워크 인식 에디터 지원을 제공합니다.

Laravel LSP를 설치하려면 Composer를 통해 전역으로 설치하세요. Composer의 전역 vendor bin 디렉토리가 PATH에 포함되어 있어야 합니다:

composer global require laravel/lsp

가볍고 확장성 있는 에디터를 원한다면 VS Code 또는 Cursor에 공식 Laravel VS Code 확장을 설치하면 문법 강조, 스니펫, Artisan 명령어 통합, 그리고 Laravel LSP 자동 지원을 활용할 수 있습니다. Sublime Text와 Zed용 공식 확장도 제공됩니다. Neovim, OpenCode 등 언어 서버 호환 에디터의 설정 방법은 Laravel LSP 저장소를 참고하세요.

보다 풍부하고 강력한 Laravel 지원을 원한다면 JetBrains의 IDE인 PhpStorm을 살펴보세요. PhpStorm은 Blade 템플릿, Eloquent 모델·라우트·뷰·번역·컴포넌트에 대한 스마트 자동완성, 강력한 코드 생성 및 프로젝트 전반의 탐색 기능을 기본으로 지원합니다.

클라우드 기반 개발 환경을 원한다면 Firebase Studio를 통해 별도 설치 없이 브라우저에서 바로 Laravel 개발을 시작할 수 있습니다.

Laravel과 AI

Laravel Boost는 AI 코딩 에이전트와 Laravel 애플리케이션 사이의 간극을 메워주는 강력한 도구입니다. Boost는 AI 에이전트에게 Laravel 특화 컨텍스트, 도구, 가이드라인을 제공하여 버전에 맞는 정확하고 컨벤션을 준수하는 코드를 생성할 수 있도록 합니다.

Boost를 설치하면 AI 에이전트가 15가지 이상의 전문 도구에 접근할 수 있게 됩니다. 사용 중인 패키지 확인, 데이터베이스 조회, Laravel 공식 문서 검색, 브라우저 로그 읽기, 테스트 생성, Tinker를 통한 코드 실행 등이 포함됩니다.

또한 Boost는 설치된 패키지 버전에 맞는 17,000개 이상의 벡터화된 Laravel 생태계 문서에 AI 에이전트가 접근할 수 있도록 합니다. 덕분에 에이전트는 프로젝트가 사용하는 정확한 버전에 맞는 안내를 제공할 수 있습니다.

Boost에는 Laravel이 관리하는 AI 가이드라인도 포함되어 있어, 에이전트가 프레임워크 컨벤션을 따르고, 적절한 테스트를 작성하며, Laravel 코드 생성 시 흔한 실수를 피하도록 도와줍니다.

Laravel Boost 설치

Boost는 PHP 8.1 이상에서 실행되는 Laravel 10, 11, 12, 13 애플리케이션에 설치할 수 있습니다. 개발 의존성으로 설치하세요:

composer require laravel/boost --dev

설치 후 대화형 인스톨러를 실행합니다:

php artisan boost:install

인스톨러는 사용 중인 IDE와 AI 에이전트를 자동으로 감지하고, 프로젝트에 맞는 기능을 선택할 수 있도록 안내합니다. Boost는 기존 프로젝트 컨벤션을 존중하며, 기본적으로 특정 스타일 규칙을 강제하지 않습니다.

NOTE

Boost에 대한 더 자세한 내용은 GitHub의 Laravel Boost 저장소를 확인하세요.

커스텀 AI 가이드라인 추가

Laravel Boost에 자체 AI 가이드라인을 추가하려면 애플리케이션의 .ai/guidelines/* 디렉토리에 .blade.php 또는 .md 파일을 추가하면 됩니다. 이 파일들은 boost:install 실행 시 Laravel Boost의 기본 가이드라인과 함께 자동으로 포함됩니다.

다음 단계

Laravel 애플리케이션을 만들었다면 이제 무엇을 배울지 궁금할 것입니다. 먼저 아래 문서들을 통해 Laravel의 동작 방식을 충분히 익혀두기를 강력히 권장합니다:

Laravel을 어떻게 활용하느냐에 따라 다음 학습 방향이 달라집니다. 아래에서 두 가지 주요 활용 방식을 소개합니다.

풀스택 프레임워크로 사용하기

Laravel을 풀스택 프레임워크로 사용할 수 있습니다. "풀스택"이란 Laravel이 요청을 라우팅하고, Blade 템플릿이나 Inertia 같은 SPA 하이브리드 기술로 프론트엔드까지 렌더링하는 방식을 말합니다. 이것이 Laravel을 가장 일반적이고 생산적으로 활용하는 방법입니다.

이 방식으로 개발할 계획이라면 프론트엔드 개발, 라우팅, 뷰, Eloquent ORM 문서를 참고하세요. 또한 Livewire와 Inertia 같은 커뮤니티 패키지도 살펴보세요. 이 패키지들을 활용하면 Laravel을 풀스택 프레임워크로 사용하면서 SPA 수준의 UI 경험도 제공할 수 있습니다.

풀스택으로 사용한다면 Vite를 이용한 CSS·JavaScript 컴파일 방법도 함께 익혀두기를 권장합니다.

NOTE

빠르게 개발을 시작하고 싶다면 공식 애플리케이션 스타터 킷을 확인해보세요.

API 백엔드로 사용하기

Laravel은 JavaScript SPA나 모바일 애플리케이션의 API 백엔드로도 활용할 수 있습니다. 예를 들어 Next.js 애플리케이션의 API 백엔드로 Laravel을 사용하는 방식입니다. 이 경우 Laravel은 인증과 데이터 저장·조회를 담당하면서, 큐, 이메일, 알림 등 Laravel의 강력한 서비스들을 함께 활용할 수 있습니다.

이 방식으로 개발할 계획이라면 라우팅, Laravel Sanctum, Eloquent ORM 문서를 참고하세요.