설치 (Installation)
라라벨 만나보기
라라벨은 표현력 있고 우아한 문법을 제공하는 웹 애플리케이션 프레임워크입니다. 웹 프레임워크는 애플리케이션을 만들기 위한 기본 구조와 시작점을 제공하므로, 여러분은 복잡한 부분은 우리가 처리하는 사이 멋진 것을 만드는 데 집중할 수 있습니다.
라라벨은 개발자가 뛰어난 경험을 얻을 수 있도록 노력하는 동시에, 강력한 기능도 제공합니다. 대표적으로 강력한 의존성 주입, 표현력 있는 데이터베이스 추상화 계층, 큐와 예약 작업, 단위 테스트 및 통합 테스트 등의 기능이 있습니다.
PHP 웹 프레임워크가 처음인 분부터 다년간 경험이 있는 분까지, 라라벨은 여러분과 함께 성장할 수 있는 프레임워크입니다. 처음 웹 개발을 시작하는 분이라면 저희가 첫걸음을 도와드릴 것이고, 전문가라면 기술을 한 단계 끌어올리는 데 도움이 되어드릴 것입니다. 여러분이 어떤 것을 만들어갈지 기대하고 있습니다.
[!NOTE] 라라벨이 처음이신가요? Laravel Bootcamp에서 실습을 통해 라라벨을 다루는 법을 배워보세요. 여러분의 첫 번째 라라벨 애플리케이션을 만드는 과정을 함께 안내해드립니다.
왜 라라벨인가?
웹 애플리케이션을 만들 때 다양한 도구와 프레임워크를 선택할 수 있습니다. 하지만 저희는 라라벨이 최신의 풀스택 웹 애플리케이션 개발에 가장 적합한 선택이라고 생각합니다.
발전하는(Progressive) 프레임워크
라라벨은 "진보적(progressive)" 프레임워크라고 부르기도 합니다. 즉, 라라벨은 개발자와 함께 성장합니다. 웹 개발을 처음 시작하는 분이라면 라라벨의 방대한 문서, 가이드, 비디오 튜토리얼을 활용해 부담 없이 기초부터 학습할 수 있습니다.
경험 많은 시니어 개발자라면, 라라벨은 의존성 주입, 단위 테스트, 큐(Queue), 실시간 이벤트 등 강력한 도구들을 제공합니다. 라라벨은 전문적인 웹 애플리케이션 개발을 위해 최적화되어 있으며, 엔터프라이즈급 대규모 트래픽도 문제없이 대응할 수 있습니다.
확장성 높은 프레임워크
라라벨은 매우 높은 확장성을 자랑합니다. PHP의 확장성 좋은 특성과, 라라벨이 내장 지원하는 Redis와 같은 빠르고 분산된 캐시 시스템 덕분에, 수평 확장이 매우 쉽습니다. 실제로 라라벨로 개발한 애플리케이션이 매달 수억 건의 요청을 처리한 사례도 있습니다.
더 극한의 확장이 필요하다면? Laravel Vapor와 같은 플랫폼을 이용하면 AWS의 최신 서버리스(Serverless) 기술로 라라벨 애플리케이션을 사실상 무한대에 가깝게 확장할 수 있습니다.
커뮤니티 중심의 프레임워크
라라벨은 PHP 생태계에서 최고의 패키지를 결합하여 가장 강력하고 개발자 친화적인 프레임워크를 제공합니다. 또한 전 세계 수많은 능력 있는 개발자가 프레임워크에 기여하고 있습니다. 여러분도 언젠가 라라벨의 기여자가 될 수도 있겠죠.
첫 번째 라라벨 프로젝트 만들기
첫 라라벨 프로젝트를 생성하기 전, 로컬 머신에 PHP와 Composer가 설치되어 있는지 확인하세요. macOS 환경에서는 Homebrew를 사용해 PHP와 Composer를 설치할 수 있습니다. 또한, Node 및 NPM 설치도 권장합니다.
PHP와 Composer 설치를 마친 후, Composer의 create-project 명령어로 새 라라벨 프로젝트를 생성할 수 있습니다:
composer create-project laravel/laravel:^9.0 example-app
또는 Composer를 통해 라라벨 인스톨러를 전역(global)으로 설치한 뒤, 다음과 같이 새 프로젝트를 생성할 수도 있습니다:
composer global require laravel/installer
laravel new example-app
프로젝트가 생성되면, 라라벨의 Artisan CLI에서 제공하는 serve 명령어로 로컬 개발 서버를 시작하세요:
cd example-app
php artisan serve
Artisan 개발 서버를 시작하면, 브라우저에서 http://localhost:8000 주소로 애플리케이션에 접속할 수 있습니다. 이제 라라벨 생태계의 다음 단계로 나아갈 준비가 되었습니다. 물론, 데이터베이스 구성도 바로 진행하실 수 있습니다.
[!NOTE] 라라벨 애플리케이션을 빠르게 시작하고 싶다면, 공식 스타터 키트를 활용해보세요. 라라벨의 스타터 키트는 신규 애플리케이션을 위한 백엔드와 프론트엔드 인증 기능을 손쉽게 제공합니다.
라라벨 & Docker
선호하는 운영 체제와 상관없이 라라벨을 최대한 쉽게 시작할 수 있도록 다양한 개발 환경 옵션을 제공합니다. 이 옵션들은 추후 다양하게 살펴볼 수 있지만, 라라벨은 Sail이라는 내장 솔루션을 통해 Docker를 이용한 프로젝트 실행을 지원합니다.
Docker는 작은 크기의 "컨테이너" 환경에서 애플리케이션과 서비스를 실행할 수 있게 해주는 도구입니다. 이 컨테이너는 로컬 머신의 기존 소프트웨어나 설정에 영향을 주지 않으므로, 복잡한 웹 서버나 데이터베이스와 같은 개발 도구를 따로 설치하거나 설정할 필요가 없습니다. 시작을 위해선 Docker Desktop만 설치하면 됩니다.
라라벨 Sail은 라라벨의 기본 Docker 설정을 손쉽게 다룰 수 있도록 해 주는 경량 명령줄 인터페이스입니다. Sail을 사용하면, Docker에 대한 사전 지식 없이도 PHP, MySQL, Redis를 활용한 라라벨 애플리케이션 개발을 바로 시작할 수 있습니다.
[!NOTE] 이미 Docker에 익숙하다면 걱정하지 마세요! Sail의 모든 구성은 라라벨에 포함된
docker-compose.yml파일을 통해 자유롭게 커스터마이즈할 수 있습니다.
macOS에서 시작하기
Mac에서 개발 중이고 Docker Desktop이 설치되어 있다면, 터미널에서 간단한 명령어로 새 라라벨 프로젝트를 만들 수 있습니다. 예를 들어, "example-app" 폴더에 라라벨 애플리케이션을 만들려면 다음 명령어를 실행하세요:
curl -s "https://laravel.build/example-app" | bash
물론, 위 URL의 "example-app" 부분은 원하는 이름으로 변경할 수 있습니다. 애플리케이션 이름에는 영문자, 숫자, 하이픈(-), 밑줄(_)만 사용할 수 있습니다. 라라벨 애플리케이션 디렉터리는 명령어를 실행한 현재 디렉터리 안에 만들어집니다.
Sail 설치 과정에서 컨테이너 빌드가 진행되므로, 약간의 시간이 걸릴 수 있습니다.
프로젝트 생성 후에는 앱 디렉터리로 이동해서 라라벨 Sail을 실행할 수 있습니다. Sail은 라라벨 기본 Docker 설정을 다루는 간단한 명령줄 인터페이스를 제공합니다:
cd example-app
./vendor/bin/sail up
애플리케이션의 Docker 컨테이너가 모두 실행되면, 웹 브라우저에서 http://localhost 주소로 접속할 수 있습니다.
[!NOTE] 라라벨 Sail에 대해 더 자세히 알고 싶다면 전체 문서를 참고하세요.
Windows에서 시작하기
Windows에서 새 라라벨 애플리케이션을 만들기 전에 Docker Desktop을 먼저 설치해야 합니다. 그 다음, Windows Subsystem for Linux 2(WSL2)가 설치 및 활성화되어 있어야 합니다. WSL을 이용하면 Windows 10에서 리눅스 바이너리 실행 파일을 네이티브로 사용할 수 있습니다. WSL2 설치와 활성화에 관한 방법은 Microsoft의 개발자 환경 공식 문서에서 확인할 수 있습니다.
[!NOTE] WSL2를 설치하고 활성화한 후에는 반드시 Docker Desktop이 WSL2 백엔드를 사용하도록 설정되어 있어야 합니다.
이제 새 라라벨 프로젝트를 만들 준비가 되었습니다. Windows Terminal을 실행하여, WSL2 Linux 터미널 세션을 시작하세요. 그 다음, 아래 명령어로 새 라라벨 프로젝트를 만들 수 있습니다. 예시로 "example-app" 디렉터리에 라라벨 애플리케이션을 생성하려면, 터미널에서 다음을 실행하세요:
curl -s https://laravel.build/example-app | bash
물론, 위 URL의 "example-app" 부분은 원하는 이름으로 수정해도 됩니다. 이름은 영문자, 숫자, 하이픈(-), 밑줄(_)만 포함할 수 있습니다. 라라벨 애플리케이션 디렉터리는 명령어를 실행한 현재 위치에 생성됩니다.
Sail 설치 작업에서 컨테이너 빌드가 이루어지므로 수 분 정도가 소요될 수 있습니다.
프로젝트가 생성된 후에는 애플리케이션 디렉터리로 이동하여 라라벨 Sail을 실행하세요. Sail은 라라벨 기본 Docker 설정을 손쉽게 다루는 명령줄 인터페이스를 제공합니다:
cd example-app
./vendor/bin/sail up
애플리케이션 컨테이너가 실행되면, 브라우저에서 http://localhost 로 애플리케이션에 접속할 수 있습니다.
[!NOTE] 라라벨 Sail 사용법을 더 자세히 알고 싶으시면 전체 문서를 참고하세요.
WSL2 내에서 개발하기
WSL2 환경에 생성된 라라벨 애플리케이션의 파일을 수정하려면, Microsoft의 Visual Studio Code 에디터와 공식 Remote Development 확장팩 사용을 추천합니다.
이 도구들을 설치한 후, Windows Terminal에서 애플리케이션 루트 디렉터리에서 code . 명령어를 실행하면 언제든 라라벨 프로젝트를 Visual Studio Code로 열 수 있습니다.
Linux에서 시작하기
Linux 환경에서 개발 중이고 Docker Compose가 설치되어 있다면, 다음의 명령어로 곧바로 새 라라벨 프로젝트를 만들 수 있습니다. 예를 들어 "example-app" 디렉터리에 라라벨 애플리케이션을 생성하려면, 터미널에서 다음을 실행하세요:
curl -s https://laravel.build/example-app | bash
마찬가지로 URL의 "example-app"은 원하는 이름으로 변경할 수 있으며, 이름에는 영문, 숫자, 하이픈(-), 밑줄(_)만 사용할 수 있습니다. 애플리케이션 디렉터리는 현재 경로에 생성됩니다.
Sail의 설치 및 애플리케이션 컨테이너 빌드에는 몇 분 정도 소요될 수 있습니다.
프로젝트가 만들어지면 앱 디렉터리로 이동해서 라라벨 Sail을 실행하세요. Sail은 라라벨의 기본 Docker 설정을 관리할 수 있는 명령줄 도구를 제공합니다:
cd example-app
./vendor/bin/sail up
컨테이너가 모두 실행되면, 브라우저에서 http://localhost 주소로 접근할 수 있습니다.
[!NOTE] 라라벨 Sail에 대해 더 알아보고 싶다면 전체 문서를 참고하세요.
Sail 서비스 선택하기
Sail을 이용해 새 라라벨 애플리케이션을 만들 때, with 쿼리 스트링 변수로 docker-compose.yml에 어떤 서비스를 추가할지 선택할 수 있습니다. 사용 가능한 서비스에는 mysql, pgsql, mariadb, redis, memcached, meilisearch, minio, selenium, mailpit 등이 있습니다:
curl -s "https://laravel.build/example-app?with=mysql,redis" | bash
특정 서비스를 지정하지 않으면, 기본적으로 mysql, redis, meilisearch, mailpit, selenium이 포함된 스택이 설정됩니다.
또한 URL에 devcontainer 파라미터를 추가해, Sail이 기본 Devcontainer를 설치하도록 할 수 있습니다:
curl -s "https://laravel.build/example-app?with=mysql,redis&devcontainer" | bash
초기 설정
라라벨 프레임워크의 모든 설정 파일은 config 디렉터리에 모여 있습니다. 각 설정 옵션마다 자세한 설명이 작성되어 있으니, 시간을 내어 옵션들을 살펴보고 익숙해지세요.
라라벨은 기본적으로 추가적인 설정 없이 바로 개발을 시작할 수 있게 설계되었습니다. 지금 바로 코딩을 시작해도 문제 없습니다! 하지만 필요하다면 config/app.php 파일과 관련 문서를 확인해보세요. 이 파일에는 timezone, locale 등 상황에 맞게 변경할 수 있는 다양한 옵션이 있습니다.
환경 기반 설정
라라벨의 설정 옵션 값들은, 애플리케이션이 로컬 머신에서 실행되는지 프로덕션 서버에서 동작하는지에 따라 달라질 수 있습니다. 이를 위해 많은 주요 설정 값이 애플리케이션 루트에 위치한 .env 파일에 정의되어 있습니다.
.env 파일은 각 개발자나 서버에서 서로 다른 환경 구성이 필요하기 때문에, 소스코드 저장소에는 포함하지 않아야 합니다. 게다가, 만약 소스코드 저장소에 접근 권한이 없는 사람이 접근하게 될 경우 중요한 자격 증명이 유출될 수 있으니 보안상 매우 위험합니다.
[!NOTE]
.env파일과 환경 기반 설정에 대한 자세한 내용은 설정 문서 전체를 참고하세요.
데이터베이스 & 마이그레이션
이제 라라벨 애플리케이션을 만들었으니, 데이터를 데이터베이스에 저장하고 싶을 것입니다. 기본적으로 .env 설정 파일에는 MySQL 데이터베이스와 127.0.0.1 주소로 접속하도록 지정되어 있습니다. macOS에서 MySQL, Postgres, Redis 등의 설치가 필요하다면 DBngin을 사용하면 간편하게 설치할 수 있습니다.
로컬 머신에 MySQL이나 Postgres를 설치하고 싶지 않다면, SQLite 데이터베이스도 사용할 수 있습니다. SQLite는 작고 빠르며 자체적으로 독립적인 데이터베이스 엔진입니다. 사용하려면 .env 파일에서 라라벨의 sqlite 데이터베이스 드라이버를 지정하면 됩니다. 그 외 다른 데이터베이스 설정은 삭제해도 됩니다:
DB_CONNECTION=sqlite # [tl! add]
DB_CONNECTION=mysql # [tl! remove]
DB_HOST=127.0.0.1 # [tl! remove]
DB_PORT=3306 # [tl! remove]
DB_DATABASE=laravel # [tl! remove]
DB_USERNAME=root # [tl! remove]
DB_PASSWORD= # [tl! remove]
SQLite 데이터베이스 설정을 마친 후에는 데이터베이스 마이그레이션 명령어로 애플리케이션의 데이터베이스 테이블을 생성할 수 있습니다:
php artisan migrate
애플리케이션에 SQLite 데이터베이스 파일이 없다면, 라라벨이 생성 여부를 묻고 직접 파일까지 만들어줍니다. 보통 database/database.sqlite 위치에 데이터베이스 파일이 생성됩니다.
다음 단계
라라벨 프로젝트를 만들었다면, 이제 무엇을 배워야 할지 궁금하실 수 있습니다. 먼저 라라벨의 동작 방식을 잘 이해하기 위해 아래 문서를 읽어보는 것을 강력히 추천합니다:
라라벨을 사용하는 방식에 따라 앞으로의 학습 단계도 달라집니다. 라라벨은 여러가지 방식으로 사용할 수 있는데, 아래에서는 대표적인 두 가지 주요 사용 사례를 살펴보겠습니다.
[!NOTE] 라라벨이 처음이라면, Laravel Bootcamp에서 직접 애플리케이션을 만들며 프레임워크를 체험해보세요.
라라벨: 풀스택 프레임워크
라라벨은 풀스택(Full Stack) 프레임워크로 사용할 수 있습니다. 여기서 "풀스택"이란, 라라벨이 요청 라우팅을 담당하고 Blade 템플릿이나 Inertia와 같은 SPA(싱글 페이지 애플리케이션) 하이브리드 기술로 프론트엔드를 렌더링하는 방식을 말합니다. 이는 라라벨을 사용하는 가장 일반적이며, 저희가 생각하기에도 가장 생산적인 방법입니다.
이런 방식으로 라라벨을 사용할 계획이라면 프론트엔드 개발, 라우팅, 뷰, Eloquent ORM 관련 문서를 참고해보세요. 또한, Livewire, Inertia와 같은 커뮤니티 패키지에도 관심을 가져볼만합니다. 이러한 패키지 덕분에 자바스크립트 SPA의 장점과 라라벨의 풀스택 프레임워크 기능을 함께 누릴 수 있습니다.
라라벨을 풀스택 프레임워크로 쓸 경우, Vite를 활용해 애플리케이션의 CSS와 자바스크립트 빌드 방법도 꼭 공부해보시길 추천합니다.
[!NOTE] 애플리케이션 개발에 빠르게 착수하고 싶으시면, 공식 애플리케이션 스타터 키트를 참고하세요.
라라벨: API 백엔드
라라벨은 자바스크립트 싱글 페이지 애플리케이션(SPA)이나 모바일 애플리케이션을 위한 백엔드 API로도 사용할 수 있습니다. 예를 들어, Next.js 애플리케이션의 API 백엔드로 라라벨을 사용할 수 있습니다. 이 경우, 라라벨은 인증 기능(authentication), 데이터 저장 및 조회 등은 물론, 큐, 이메일, 알림 등 라라벨의 강력한 서비스를 모두 제공할 수 있습니다.
이런 방식의 사용이 목표라면 라우팅, Laravel Sanctum, Eloquent ORM 관련 문서를 참고해보세요.
[!NOTE] 라라벨 백엔드와 Next.js 프론트엔드의 시작 뼈대를 빠르게 만들고 싶다면, Laravel Breeze에서 API 스택과 Next.js 프론트엔드 구현체를 지원하니, 바로 사용해보실 수 있습니다.