설치

• Laravel 소개
  • 왜 Laravel인가?
• Laravel 프로젝트 생성
• 초기 설정
  • 환경별 설정
  • 데이터베이스와 마이그레이션
  • 디렉터리 설정
• Sail을 이용한 Docker 설치
  • macOS에서 Sail 사용
  • Windows에서 Sail 사용
  • Linux에서 Sail 사용
  • Sail 서비스 선택
• IDE 지원
• Laravel과 AI
  • Laravel Boost 설치
• 다음 단계
  • 풀스택 프레임워크로 사용하기
  • API 백엔드로 사용하기

Laravel 소개

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

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

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

왜 Laravel인가?

웹 애플리케이션을 개발할 때 선택할 수 있는 도구와 프레임워크는 다양합니다. 그러나 현대적인 풀스택 웹 애플리케이션을 구축하는 데 있어 Laravel이 최선의 선택이라고 자신 있게 말할 수 있습니다.

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

Laravel은 "점진적(progressive)" 프레임워크라고 부를 수 있습니다. 개발자와 함께 성장한다는 의미입니다. 웹 개발을 이제 막 시작하는 분이라면, 방대한 공식 문서와 가이드, 영상 튜토리얼이 부담 없이 기초를 쌓는 데 도움이 됩니다.

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

확장 가능한 프레임워크

Laravel은 뛰어난 확장성을 자랑합니다. PHP의 확장 친화적인 특성과 Redis 같은 고속 분산 캐시 시스템에 대한 기본 지원 덕분에 수평 확장이 매우 쉽습니다. 실제로 Laravel로 구축된 애플리케이션 중 월 수억 건의 요청을 처리하는 사례도 있습니다.

더욱 극단적인 확장이 필요하다면 Laravel Vapor를 통해 AWS의 서버리스 기술 위에서 사실상 무제한에 가까운 규모로 운영할 수도 있습니다.

커뮤니티 중심의 프레임워크

Laravel은 PHP 에코시스템의 우수한 패키지들을 결합하여 가장 강력하고 개발자 친화적인 프레임워크를 제공합니다. 또한 전 세계 수천 명의 개발자들이 프레임워크에 기여하고 있습니다. 여러분도 언젠가 Laravel 기여자가 될 수 있습니다.

Laravel 프로젝트 생성

첫 Laravel 프로젝트를 만들기 전에, 로컬 머신에 PHP와 Composer가 설치되어 있는지 확인하세요. macOS에서 개발한다면 Laravel Herd를 통해 PHP와 Composer를 빠르게 설치할 수 있습니다. 아울러 Node와 NPM도 함께 설치하기를 권장합니다.

PHP와 Composer가 준비되었다면 Composer의 create-project 명령어로 새 Laravel 프로젝트를 생성할 수 있습니다.

또는 Composer로 Laravel 인스톨러를 전역 설치한 뒤 사용하는 방법도 있습니다.

프로젝트가 생성되면 Artisan의 serve 명령어로 로컬 개발 서버를 시작합니다.

개발 서버가 시작되면 브라우저에서 http://localhost:8000으로 애플리케이션에 접속할 수 있습니다. 이제 Laravel 에코시스템의 다음 단계를 시작할 준비가 되었습니다. 물론 데이터베이스 설정도 함께 진행하는 것이 좋습니다.

초기 설정

Laravel 프레임워크의 모든 설정 파일은 config 디렉터리에 저장됩니다. 각 옵션에는 설명이 달려 있으니, 파일을 직접 살펴보며 사용 가능한 옵션들을 파악해 두는 것이 좋습니다.

Laravel은 설치 후 거의 추가 설정 없이 바로 개발을 시작할 수 있습니다. 다만 config/app.php 파일은 한 번쯤 살펴보기를 권장합니다. 이 파일에는 timezone이나 locale처럼 프로젝트 상황에 맞게 변경해야 할 옵션들이 포함되어 있습니다.

환경별 설정

Laravel의 많은 설정 값은 로컬 개발 환경과 운영 서버 환경에 따라 달라질 수 있습니다. 그래서 중요한 설정 값들은 애플리케이션 루트에 위치한 .env 파일을 통해 정의합니다.

.env 파일은 개발자마다, 서버마다 다른 환경 설정이 필요하기 때문에 소스 컨트롤(Git 등)에 커밋하지 않아야 합니다. 또한 민감한 인증 정보가 외부에 노출될 수 있는 보안 위험도 있습니다.

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

Laravel 애플리케이션을 만들었다면 이제 데이터를 데이터베이스에 저장하고 싶을 것입니다. 기본적으로 .env 설정 파일은 Laravel이 127.0.0.1의 MySQL 데이터베이스를 사용하도록 구성되어 있습니다.

로컬 머신에 MySQL이나 Postgres를 설치하지 않으려면 SQLite를 사용할 수 있습니다. SQLite는 작고 빠른 파일 기반 데이터베이스 엔진으로, 간단한 개발 환경에 적합합니다. SQLite를 사용하려면 .env 파일을 다음과 같이 수정하세요.

SQLite 설정이 완료되면 데이터베이스 마이그레이션을 실행하여 애플리케이션의 데이터베이스 테이블을 생성합니다.

php artisan migrate

SQLite 데이터베이스 파일이 아직 없다면 Laravel이 생성 여부를 물어봅니다. 일반적으로 database/database.sqlite 경로에 파일이 만들어집니다.

디렉터리 설정

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

Sail을 이용한 Docker 설치

운영 체제에 관계없이 Laravel을 최대한 쉽게 시작할 수 있도록, Laravel은 Sail을 기본 제공합니다. Sail은 Docker를 이용해 Laravel 프로젝트를 실행하는 내장 솔루션입니다.

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

Laravel Sail은 Laravel의 기본 Docker 설정과 상호작용하기 위한 경량 커맨드라인 인터페이스입니다. Docker 경험이 없어도 PHP, MySQL, Redis를 사용하는 Laravel 애플리케이션을 바로 시작할 수 있습니다.

macOS에서 Sail 사용

Mac에서 개발 중이고 Docker Desktop이 이미 설치되어 있다면, 간단한 터미널 명령어 하나로 새 Laravel 프로젝트를 생성할 수 있습니다. 예를 들어 "example-app" 디렉터리에 새 애플리케이션을 만들려면 다음 명령어를 실행하세요.

URL 안의 "example-app"은 원하는 이름으로 바꿔도 됩니다. 단, 애플리케이션 이름에는 영문자, 숫자, 대시(-), 언더스코어(_)만 사용할 수 있습니다. 명령어를 실행한 디렉터리 안에 애플리케이션 디렉터리가 생성됩니다.

컨테이너 이미지를 빌드하는 동안 설치에 몇 분 정도 소요될 수 있습니다.

프로젝트 생성이 완료되면 애플리케이션 디렉터리로 이동하여 Laravel Sail을 시작합니다.

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

Docker 컨테이너가 시작되면 브라우저에서 http://localhost 로 애플리케이션에 접속할 수 있습니다.

Windows에서 Sail 사용

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

이제 첫 번째 Laravel 프로젝트를 만들 준비가 되었습니다. Windows Terminal을 열고 WSL2 Linux 환경에서 새 터미널 세션을 시작한 뒤 다음 명령어를 실행하세요.

URL 안의 "example-app"은 원하는 이름으로 바꿔도 됩니다. 단, 애플리케이션 이름에는 영문자, 숫자, 대시(-), 언더스코어(_)만 사용할 수 있습니다. 명령어를 실행한 디렉터리 안에 애플리케이션 디렉터리가 생성됩니다.

컨테이너 이미지를 빌드하는 동안 설치에 몇 분 정도 소요될 수 있습니다.

프로젝트 생성이 완료되면 애플리케이션 디렉터리로 이동하여 Laravel Sail을 시작합니다.

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

Docker 컨테이너가 시작되면 브라우저에서 http://localhost 로 애플리케이션에 접속할 수 있습니다.

WSL2 환경에서 개발하기

WSL2 환경 안에 생성된 Laravel 애플리케이션 파일을 편집하려면 Microsoft의 Visual Studio Code와 공식 확장 프로그램인 Remote Development를 사용하는 것을 권장합니다.

이 도구들이 설치되면 Windows Terminal에서 애플리케이션 루트 디렉터리로 이동한 뒤 code . 명령어로 프로젝트를 바로 열 수 있습니다.

Linux에서 Sail 사용

Linux에서 개발 중이고 Docker Compose가 이미 설치되어 있다면, 간단한 터미널 명령어로 새 Laravel 프로젝트를 생성할 수 있습니다.

Docker Desktop for Linux를 사용하는 경우, 먼저 다음 명령어를 실행하세요. Docker Desktop for Linux를 사용하지 않는다면 이 단계는 건너뛰어도 됩니다.

docker context use default

그런 다음 "example-app" 디렉터리에 새 Laravel 애플리케이션을 만들려면 아래 명령어를 실행하세요.

URL 안의 "example-app"은 원하는 이름으로 바꿔도 됩니다. 단, 애플리케이션 이름에는 영문자, 숫자, 대시(-), 언더스코어(_)만 사용할 수 있습니다. 명령어를 실행한 디렉터리 안에 애플리케이션 디렉터리가 생성됩니다.

컨테이너 이미지를 빌드하는 동안 설치에 몇 분 정도 소요될 수 있습니다.

프로젝트 생성이 완료되면 애플리케이션 디렉터리로 이동하여 Laravel Sail을 시작합니다.

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

Docker 컨테이너가 시작되면 브라우저에서 http://localhost 로 애플리케이션에 접속할 수 있습니다.

Sail 서비스 선택

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

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

URL에 devcontainer 파라미터를 추가하면 기본 Devcontainer도 함께 설치됩니다.

IDE 지원

Laravel 애플리케이션 개발 시 원하는 코드 에디터를 자유롭게 사용할 수 있습니다. 그 중 PhpStorm은 Laravel Pint를 포함한 Laravel 에코시스템 전반에 걸쳐 폭넓은 지원을 제공합니다.

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

Laravel과 AI

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

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

또한 Boost는 설치된 패키지 버전에 맞춘 17,000개 이상의 벡터화된 Laravel 에코시스템 문서를 AI 에이전트에게 제공합니다. 덕분에 에이전트는 프로젝트에서 실제로 사용하는 버전에 맞는 정확한 안내를 제공할 수 있습니다.

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

Laravel Boost 설치

Boost는 PHP 8.1 이상을 사용하는 Laravel 10, 11, 12 애플리케이션에 설치할 수 있습니다. 개발 의존성으로 Boost를 설치하세요.

composer require laravel/boost --dev

설치 후 인터랙티브 인스톨러를 실행합니다.

php artisan boost:install

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

다음 단계

Laravel 프로젝트를 생성했다면, 이제 무엇을 배워야 할지 궁금하실 겁니다. 먼저 Laravel이 어떻게 동작하는지 이해하기 위해 다음 문서들을 읽어 보기를 강력히 권장합니다.

• 요청 라이프사이클
• 설정
• 디렉터리 구조
• 프론트엔드
• 서비스 컨테이너
• Facades

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

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

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

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

풀스택 방식으로 Laravel을 사용한다면 Vite를 통해 CSS와 JavaScript를 번들링하는 방법도 꼭 익혀 두기를 권장합니다.

API 백엔드로 사용하기

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

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