설치

번역일: 2026년 6월 27일

설치

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

Laravel 소개

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

Laravel은 뛰어난 개발자 경험을 제공하는 동시에, 강력한 의존성 주입, 표현력 있는 데이터베이스 추상화 레이어, 큐와 스케줄링, 단위·통합 테스트 등 다양한 기능을 갖추고 있습니다.

PHP 웹 프레임워크를 처음 접하든, 오랜 경험을 가진 개발자든 Laravel은 함께 성장하는 프레임워크입니다. 웹 개발의 첫걸음을 돕기도 하고, 더 높은 수준의 전문성을 쌓는 데도 도움이 됩니다.

왜 Laravel인가?

웹 애플리케이션을 만들 때 선택할 수 있는 도구와 프레임워크는 많습니다. 그중에서도 Laravel은 현대적인 풀스택 웹 애플리케이션을 만들기에 가장 좋은 선택이라고 생각합니다.

점진적으로 성장하는 프레임워크

Laravel은 "점진적(progressive)" 프레임워크입니다. 웹 개발을 막 시작한 분이라면 방대한 공식 문서, 가이드, 영상 튜토리얼(Laracasts)이 부담 없이 개념을 익힐 수 있도록 도와줍니다.

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

확장성 높은 프레임워크

Laravel은 뛰어난 확장성을 자랑합니다. PHP의 수평 확장 특성과 Redis 같은 분산 캐시 시스템에 대한 내장 지원 덕분에, 월 수억 건의 요청도 거뜬히 처리할 수 있습니다.

극한의 확장이 필요하다면 Laravel Cloud 같은 플랫폼을 통해 사실상 무제한에 가까운 규모로 운영할 수 있습니다.

AI 친화적인 프레임워크

Laravel의 명확한 컨벤션과 잘 정의된 구조는 Cursor, Claude Code 같은 도구를 이용한 AI 보조 개발에 이상적인 환경을 만들어 줍니다. AI 에이전트에게 컨트롤러를 추가하라고 지시하면 파일을 어디에 두어야 할지 정확히 알고, 마이그레이션이 필요하면 네이밍 컨벤션과 파일 위치를 예측 가능하게 처리합니다.

Eloquent 관계, 폼 요청, 미들웨어 같은 기능은 일관된 패턴을 따르기 때문에 AI가 신뢰할 수 있는 코드를 생성합니다. 결과적으로 AI가 만든 코드도 숙련된 Laravel 개발자가 직접 작성한 것처럼 자연스럽습니다.

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

강력한 커뮤니티 프레임워크

Laravel은 PHP 생태계 최고의 패키지들을 결합해 가장 강력하고 개발자 친화적인 프레임워크를 제공합니다. 전 세계 수천 명의 개발자가 프레임워크에 기여하고 있으며, 여러분도 언젠가 기여자가 될 수 있습니다.

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.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 프레임워크의 모든 설정 파일은 config 디렉터리에 있습니다. 각 옵션에는 설명이 달려 있으므로 파일을 열어 어떤 옵션이 있는지 살펴보는 것을 권장합니다.

Laravel은 별도의 추가 설정 없이 바로 개발을 시작할 수 있습니다. 다만 config/app.php 파일은 한 번 살펴보는 것이 좋습니다. url, locale(애플리케이션 언어) 등 프로젝트 환경에 맞게 조정할 옵션들이 담겨 있습니다.

환경 기반 설정

로컬 개발 환경과 프로덕션 서버는 설정이 달라야 하는 경우가 많습니다. Laravel의 중요한 설정값들은 프로젝트 루트에 있는 .env 파일에서 관리됩니다.

.env 파일은 개발자마다, 서버마다 다른 값을 가질 수 있기 때문에 절대로 소스 컨트롤(Git 등)에 커밋해서는 안 됩니다. 만약 커밋된다면 저장소에 접근한 외부인에게 데이터베이스 비밀번호나 API 키 같은 민감한 정보가 노출될 수 있습니다.

NOTE

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

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

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

애플리케이션 생성 시 Laravel이 자동으로 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나 DBngin 사용을 권장합니다.

디렉터리 설정

Laravel 애플리케이션은 반드시 웹 서버의 "웹 루트 디렉터리" 최상위에서 서비스되어야 합니다. 웹 루트의 하위 디렉터리에서 서비스하려고 시도하지 마세요. 그렇게 하면 애플리케이션 내부의 민감한 파일이 외부에 노출될 수 있습니다.

Herd를 이용한 설치

Laravel Herd는 macOS와 Windows를 위한 고속 네이티브 Laravel·PHP 개발 환경입니다. PHP와 Nginx가 포함되어 있어 별도의 설치 없이 Laravel 개발을 바로 시작할 수 있습니다.

Herd를 설치하면 php, composer, laravel, expose, node, npm, nvm 등의 명령줄 도구가 함께 제공됩니다.

NOTE

Herd Pro를 사용하면 로컬 MySQL, Postgres, Redis 데이터베이스 생성·관리, 로컬 메일 확인, 로그 모니터링 등 강력한 추가 기능을 사용할 수 있습니다.

macOS에서 Herd 사용

macOS라면 Herd 웹사이트에서 인스톨러를 다운로드하세요. 인스톨러가 최신 PHP를 자동으로 설치하고, Nginx가 백그라운드에서 항상 실행되도록 Mac을 설정합니다.

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

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

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

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

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

Windows에서 Herd 사용

Windows라면 Herd 웹사이트에서 인스톨러를 다운로드하세요. 설치가 완료되면 Herd를 실행해 온보딩 과정을 마치고 처음으로 Herd UI에 접근하세요.

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

설치 시 홈 디렉터리(%USERPROFILE%\Herd)에 기본 파킹 디렉터리가 생성됩니다. 이 안의 Laravel 애플리케이션은 디렉터리 이름을 기반으로 .test 도메인으로 자동 서비스됩니다.

Herd 설치 후 새 Laravel 애플리케이션을 만들려면 PowerShell을 열고 아래 명령어를 실행하세요.

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

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

IDE 지원

Laravel 개발에는 어떤 코드 편집기를 사용해도 무방합니다. 가볍고 확장성 있는 편집기를 원한다면 VS Code 또는 Cursor에 공식 Laravel VS Code Extension을 설치해 보세요. 문법 강조, 스니펫, Artisan 명령어 통합, Eloquent 모델·라우트·미들웨어·에셋·설정·Inertia.js에 대한 스마트 자동완성 등의 기능을 제공합니다.

보다 풍부하고 강력한 지원을 원한다면 JetBrains IDE인 PhpStorm을 고려해 보세요. Blade 템플릿, Eloquent 모델·라우트·뷰·번역·컴포넌트에 대한 스마트 자동완성, 코드 생성 및 프로젝트 전반의 내비게이션 기능이 내장되어 있습니다.

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

Laravel과 AI

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

애플리케이션에 Boost를 설치하면 AI 에이전트가 15가지 이상의 전문 도구에 접근할 수 있습니다. 사용 중인 패키지 확인, 데이터베이스 쿼리, Laravel 공식 문서 검색, 브라우저 로그 확인, 테스트 생성, Tinker를 통한 코드 실행 등이 가능합니다.

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

Boost에는 프레임워크 컨벤션 준수, 적절한 테스트 작성, 일반적인 실수 방지를 위한 Laravel 공식 AI 가이드라인도 포함되어 있습니다.

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 저장소를 참고하세요.

커스텀 AI 가이드라인 추가

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

다음 단계

Laravel 애플리케이션을 만들었다면 이제 무엇을 배워야 할지 궁금할 것입니다. 먼저 아래 문서들을 읽으며 Laravel의 동작 방식을 익히는 것을 강력히 권장합니다.

Laravel을 어떻게 활용할지에 따라 다음 학습 방향도 달라집니다. 아래에서 대표적인 두 가지 사용 방식을 소개합니다.

풀스택 프레임워크로서의 Laravel

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

이 방식을 선택했다면 프론트엔드 개발, 라우팅, 뷰, Eloquent ORM 문서를 확인해 보세요. Livewire와 Inertia 같은 커뮤니티 패키지도 살펴볼 만합니다. 이 패키지들은 Laravel을 풀스택 프레임워크로 유지하면서 SPA의 UI 이점도 누릴 수 있게 해줍니다.

풀스택 방식을 사용한다면 Vite를 이용한 CSS·JavaScript 컴파일 방법도 함께 학습하는 것을 권장합니다.

NOTE

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

API 백엔드로서의 Laravel

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

이 방식을 선택했다면 라우팅, Laravel Sanctum, Eloquent ORM 문서를 참고하세요.