설치

번역일: 2026년 6월 27일

설치

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

Laravel 소개

Laravel은 표현력 있고 우아한 문법을 갖춘 웹 애플리케이션 프레임워크입니다. 프레임워크는 애플리케이션을 만들기 위한 구조와 출발점을 제공하므로, 개발자는 세부적인 구현보다 실제로 만들고자 하는 것에 집중할 수 있습니다.

Laravel은 뛰어난 개발 경험을 제공하는 동시에, 강력한 의존성 주입, 직관적인 데이터베이스 추상화 계층, 큐와 예약 Job, 단위 및 통합 테스트 등 다양한 기능을 갖추고 있습니다.

PHP 웹 프레임워크를 처음 접하는 입문자든, 수년간의 경험을 가진 숙련 개발자든 Laravel은 함께 성장할 수 있는 프레임워크입니다. 첫 발걸음을 내딛는 데 도움을 드리거나, 전문성을 한 단계 더 끌어올릴 수 있도록 지원합니다.

NOTE

Laravel이 처음이신가요? Laravel Bootcamp에서 첫 번째 Laravel 애플리케이션을 직접 만들어보며 프레임워크를 익혀보세요.

왜 Laravel인가?

웹 애플리케이션을 구축할 때 선택할 수 있는 도구와 프레임워크는 다양합니다. 그중에서도 Laravel은 현대적인 풀스택 웹 애플리케이션을 만드는 데 최선의 선택이라고 자신합니다.

함께 성장하는 프레임워크

Laravel을 "점진적(progressive)" 프레임워크라고 부릅니다. 개발자의 성장에 맞춰 함께 발전한다는 의미입니다. 웹 개발을 막 시작했다면, Laravel의 방대한 문서와 가이드, 영상 튜토리얼이 부담 없이 기초를 쌓을 수 있도록 도와줍니다.

시니어 개발자라면 의존성 주입, 단위 테스트, 큐, 실시간 이벤트 등 강력한 도구를 활용해 전문적인 수준의 애플리케이션을 구축할 수 있습니다.

확장 가능한 프레임워크

Laravel은 뛰어난 확장성을 자랑합니다. PHP의 수평 확장 친화적 특성과 Redis 같은 고속 분산 캐시 시스템에 대한 내장 지원 덕분에 대규모 트래픽도 유연하게 대응할 수 있습니다. 실제로 월 수억 건의 요청을 처리하는 Laravel 애플리케이션도 어렵지 않게 운영됩니다.

극한의 확장성이 필요하다면 Laravel Vapor를 통해 AWS 서버리스 인프라 위에서 사실상 무제한 규모로 운영할 수도 있습니다.

커뮤니티 기반 프레임워크

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

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.4)"

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.4'))

Linux

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

명령어 실행 후에는 터미널을 재시작하세요. 이후 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으로 애플리케이션에 접속할 수 있습니다. 이제 다음 단계를 진행하거나, 데이터베이스 설정을 먼저 구성해도 좋습니다.

NOTE

개발을 빠르게 시작하고 싶다면 스타터 킷 사용을 고려해보세요. 스타터 킷은 백엔드 및 프론트엔드 인증 스캐폴딩을 제공합니다.

초기 설정

Laravel의 모든 설정 파일은 config 디렉터리에 있습니다. 각 옵션에는 설명이 달려 있으므로, 파일들을 둘러보며 사용 가능한 옵션들을 파악해두면 좋습니다.

Laravel은 별도의 추가 설정 없이도 바로 개발을 시작할 수 있습니다. 다만 config/app.php 파일을 한 번 살펴보는 것을 권장합니다. url, locale 등 애플리케이션에 맞게 변경할 수 있는 설정들이 포함되어 있습니다.

NOTE

한국어 서비스를 개발한다면 config/app.php의 locale을 ko로, timezone을 Asia/Seoul로 설정하는 것을 잊지 마세요.

환경 기반 설정

로컬 개발 환경과 운영 서버는 설정 값이 다를 수 있습니다. 이를 위해 Laravel은 애플리케이션 루트의 .env 파일을 통해 환경별 설정을 관리합니다.

.env 파일은 Git 등의 소스 컨트롤에 커밋하면 안 됩니다. 개발자마다, 서버마다 환경 설정이 다를 수 있고, 데이터베이스 비밀번호나 API 키 같은 민감한 정보가 노출될 수 있기 때문입니다.

NOTE

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

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

애플리케이션을 만들었다면 이제 데이터를 저장할 데이터베이스가 필요합니다. 기본적으로 .env 파일은 SQLite를 사용하도록 설정되어 있으며, 애플리케이션 생성 시 database/database.sqlite 파일과 기본 마이그레이션이 자동으로 준비됩니다.

MySQL이나 PostgreSQL을 사용하려면 .env 파일의 DB_* 항목을 아래와 같이 수정하세요.

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 사용을 고려해보세요.

디렉터리 설정

Laravel은 반드시 웹 서버의 "웹 디렉터리(document root)" 루트에서 서비스되어야 합니다. 웹 디렉터리의 하위 경로에서 Laravel 애플리케이션을 서비스하려 하면 애플리케이션 내부의 민감한 파일이 외부에 노출될 수 있으니 주의하세요.

Herd로 로컬 설치

Laravel Herd는 macOS와 Windows를 위한 빠르고 가벼운 네이티브 Laravel·PHP 개발 환경입니다. PHP와 Nginx를 포함해 Laravel 개발에 필요한 모든 것이 기본 포함되어 있습니다.

Herd를 설치하면 php, composer, laravel, expose, node, npm, nvm 등의 커맨드라인 도구를 바로 사용할 수 있습니다.

NOTE

Herd Pro를 사용하면 로컬 MySQL, PostgreSQL, Redis 데이터베이스 관리, 메일 뷰어, 로그 모니터링 등 추가 기능을 활용할 수 있습니다.

macOS에서 Herd 사용

Herd 웹사이트에서 macOS용 인스톨러를 다운로드하세요. 설치 후 최신 버전의 PHP가 자동으로 내려받아지고, Nginx가 백그라운드에서 항상 실행되도록 Mac이 설정됩니다.

macOS용 Herd는 dnsmasq를 사용해 "파킹된(parked)" 디렉터리를 지원합니다. 파킹된 디렉터리에 있는 Laravel 애플리케이션은 자동으로 서비스됩니다. 기본 파킹 디렉터리는 ~/Herd이며, 이 디렉터리 안의 애플리케이션은 디렉터리 이름을 사용해 .test 도메인으로 접근할 수 있습니다.

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

cd ~/Herd
laravel new my-app
cd my-app
herd open

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

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

Windows에서 Herd 사용

Herd 웹사이트에서 Windows용 인스톨러를 다운로드하세요. 설치가 완료되면 Herd를 시작해 온보딩 과정을 완료하고 UI에 처음 접근할 수 있습니다.

시스템 트레이의 Herd 아이콘을 왼쪽 클릭하면 Herd UI가 열리고, 오른쪽 클릭하면 자주 사용하는 도구에 빠르게 접근할 수 있는 퀵 메뉴가 표시됩니다.

설치 시 홈 디렉터리의 %USERPROFILE%\Herd에 기본 파킹 디렉터리가 생성됩니다. 이 디렉터리 안의 Laravel 애플리케이션은 디렉터리 이름을 사용해 .test 도메인으로 자동 접근할 수 있습니다.

설치 후 Powershell에서 아래 명령어를 실행해 새 Laravel 애플리케이션을 만들 수 있습니다.

cd ~\Herd
laravel new my-app
cd my-app
herd open

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

Sail로 Docker 설치

운영 체제에 관계없이 쉽게 Laravel 개발을 시작할 수 있도록 Laravel은 Sail을 제공합니다. Sail은 Docker를 기반으로 Laravel 애플리케이션을 실행하는 내장 솔루션입니다.

Docker는 애플리케이션과 서비스를 가볍고 독립된 "컨테이너"로 실행하는 도구입니다. 로컬 머신의 기존 소프트웨어나 설정에 영향을 주지 않으므로, 웹 서버나 데이터베이스를 복잡하게 직접 설정할 필요가 없습니다. 시작하려면 Docker Desktop만 설치하면 됩니다.

Laravel Sail은 Laravel의 기본 Docker 설정을 간편하게 다룰 수 있는 경량 커맨드라인 인터페이스입니다. Docker 경험이 없어도 PHP, MySQL, Redis 환경을 손쉽게 구성할 수 있습니다.

NOTE

Docker에 익숙한 분이라면 Laravel에 포함된 docker-compose.yml 파일을 자유롭게 수정해 Sail을 입맛에 맞게 커스터마이즈할 수 있습니다.

macOS에서 Sail 사용

Mac에서 개발 중이고 Docker Desktop이 설치되어 있다면, 아래 명령어 하나로 새 Laravel 애플리케이션을 만들 수 있습니다. example-app은 원하는 이름으로 바꿔도 됩니다(영문 알파벳, 숫자, 하이픈, 언더스코어만 사용 가능).

curl -s "https://laravel.build/example-app" | bash

컨테이너 이미지를 빌드하는 과정에서 몇 분이 소요될 수 있습니다.

애플리케이션이 생성되면 디렉터리로 이동한 후 Sail을 시작합니다.

cd example-app./vendor/bin/sail up

Docker 컨테이너가 시작되면 데이터베이스 마이그레이션을 실행하세요.

./vendor/bin/sail artisan migrate

이후 브라우저에서 http://localhost 로 접속하면 애플리케이션을 확인할 수 있습니다.

NOTE

Laravel Sail에 대한 자세한 내용은 Sail 전체 문서를 참고하세요.

Windows에서 Sail 사용

Windows에서 새 Laravel 애플리케이션을 만들기 전에 Docker Desktop을 설치하고, WSL2(Windows Subsystem for Linux 2)가 활성화되어 있는지 확인하세요. WSL2는 Windows 10에서 Linux 바이너리를 네이티브로 실행할 수 있게 해줍니다. 설치 방법은 Microsoft의 개발자 환경 문서를 참고하세요.

NOTE

WSL2 설치 후 Docker Desktop이 WSL2 백엔드를 사용하도록 설정되어 있는지 확인하세요.

Windows Terminal을 열고 WSL2 Linux 환경의 터미널 세션을 시작한 후, 아래 명령어로 애플리케이션을 생성하세요.

curl -s https://laravel.build/example-app | bash

컨테이너 이미지 빌드에 몇 분이 소요될 수 있습니다.

생성이 완료되면 아래와 같이 Sail을 시작합니다.

cd example-app./vendor/bin/sail up

컨테이너가 실행되면 마이그레이션을 실행하세요.

./vendor/bin/sail artisan migrate

이후 브라우저에서 http://localhost 로 접속하면 애플리케이션을 확인할 수 있습니다.

NOTE

Laravel Sail에 대한 자세한 내용은 Sail 전체 문서를 참고하세요.

WSL2 환경에서 파일 편집

WSL2 환경 내에 생성된 Laravel 파일을 편집하려면 Microsoft의 Visual Studio Code와 공식 Remote Development 확장을 사용하는 것을 권장합니다.

설치 후 애플리케이션 루트 디렉터리에서 Windows Terminal을 열고 code . 명령어를 실행하면 VS Code로 바로 열 수 있습니다.

Linux에서 Sail 사용

Linux에서 개발 중이고 Docker Compose가 설치되어 있다면 아래 명령어로 바로 시작할 수 있습니다.

Docker Desktop for Linux를 사용 중이라면 먼저 아래 명령어를 실행하세요. Docker Desktop for Linux가 아닌 경우 이 단계는 생략해도 됩니다.

docker context use default

이후 아래 명령어로 새 Laravel 애플리케이션을 생성합니다.

curl -s https://laravel.build/example-app | bash

컨테이너 이미지 빌드에 몇 분이 소요될 수 있습니다.

생성이 완료되면 디렉터리로 이동하여 Sail을 시작합니다.

cd example-app./vendor/bin/sail up

컨테이너가 실행되면 마이그레이션을 실행하세요.

./vendor/bin/sail artisan migrate

이후 브라우저에서 http://localhost 로 접속하면 애플리케이션을 확인할 수 있습니다.

NOTE

Laravel Sail에 대한 자세한 내용은 Sail 전체 문서를 참고하세요.

Sail 서비스 선택

Sail로 새 애플리케이션을 생성할 때 with 쿼리 파라미터를 사용해 docker-compose.yml에 포함할 서비스를 선택할 수 있습니다. 사용 가능한 서비스는 mysql, pgsql, mariadb, redis, valkey, memcached, meilisearch, typesense, minio, selenium, mailpit입니다.

curl -s "https://laravel.build/example-app?with=mysql,redis" | bash

서비스를 지정하지 않으면 기본적으로 mysql, redis, meilisearch, mailpit, selenium이 구성됩니다.

Devcontainer를 함께 설정하려면 URL에 devcontainer 파라미터를 추가하세요.

curl -s "https://laravel.build/example-app?with=mysql,redis&devcontainer" | bash

IDE 지원

Laravel 개발에는 어떤 코드 에디터도 사용할 수 있습니다. 그중 PhpStorm은 Laravel 및 생태계에 대한 폭넓은 지원을 제공하며 Laravel Pint와도 잘 통합됩니다.

커뮤니티에서 관리하는 PhpStorm 플러그인 Laravel Idea는 코드 생성, Eloquent 문법 자동완성, 유효성 검사 규칙 자동완성 등 다양한 편의 기능을 추가로 제공합니다.

Laravel과 AI

Laravel Boost는 AI 코딩 에이전트와 Laravel 애플리케이션 사이의 간극을 메워주는 강력한 도구입니다. Boost는 AI 에이전트에게 Laravel에 특화된 컨텍스트, 도구, 가이드라인을 제공하여 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 애플리케이션에 설치할 수 있습니다. 개발 의존성으로 설치하세요.

composer require laravel/boost --dev

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

php artisan boost:install

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

NOTE

Boost에 대한 자세한 내용은 GitHub의 Laravel Boost 저장소를 참고하세요.

다음 단계

Laravel 애플리케이션을 만들었다면 이제 무엇을 배워야 할까요? 먼저 아래 문서들을 읽으며 Laravel이 어떻게 동작하는지 이해하는 것을 강력히 권장합니다.

Laravel을 어떻게 활용할지에 따라 다음 단계도 달라집니다. 아래에서 두 가지 대표적인 활용 방식을 살펴보겠습니다.

NOTE

Laravel이 처음이신가요? Laravel Bootcamp에서 첫 번째 Laravel 애플리케이션을 직접 만들어보며 프레임워크를 익혀보세요.

풀스택 프레임워크로 활용

Laravel은 풀스택 프레임워크로 활용할 수 있습니다. 라우트 처리부터 Blade 템플릿이나 Inertia 같은 하이브리드 SPA 기술을 통한 프론트엔드 렌더링까지 모두 Laravel 하나로 처리하는 방식입니다. 이 방식이 Laravel을 가장 많이 활용하는 방법이자, 생산성 면에서도 가장 뛰어난 방식입니다.

이 방향으로 개발할 계획이라면 프론트엔드 개발, 라우팅, 뷰, Eloquent ORM 문서를 살펴보세요. 또한 Livewire와 Inertia 같은 커뮤니티 패키지도 검토해볼 만합니다. 이 패키지들을 사용하면 단일 페이지 JavaScript 애플리케이션의 UI 장점을 누리면서도 Laravel을 풀스택 프레임워크로 계속 활용할 수 있습니다.

풀스택으로 개발한다면 Vite를 이용해 CSS와 JavaScript를 컴파일하는 방법도 함께 익혀두세요.

NOTE

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

API 백엔드로 활용

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

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

NOTE

Laravel 백엔드와 Next.js 프론트엔드를 빠르게 구성하고 싶다면, Laravel Breeze의 API 스택과 Next.js 프론트엔드 구현체를 활용하면 몇 분 만에 시작할 수 있습니다.