설치

• Laravel 소개
  • 왜 Laravel인가?
• Laravel 애플리케이션 생성
  • PHP 및 Laravel 설치 프로그램 설치
  • 애플리케이션 생성
• 초기 구성
  • 환경 기반 구성
  • 데이터베이스 및 마이그레이션
  • 디렉토리 구성
• Herd를 사용한 로컬 설치
  • macOS에서의 Herd
  • Windows에서의 Herd
• Sail을 사용한 Docker 설치
  • macOS에서의 Sail
  • Windows에서의 Sail
  • Linux에서의 Sail
  • Sail 서비스 선택
• IDE 지원
• 다음 단계
  • 풀 스택 프레임워크 Laravel
  • API 백엔드 Laravel

Laravel 소개

Laravel은 표현력이 풍부하고 우아한 구문을 가진 웹 애플리케이션 프레임워크입니다. 웹 프레임워크는 애플리케이션을 만들기 위한 구조와 시작점을 제공하여, 세부 사항에 대한 걱정 없이 멋진 것을 만드는 데 집중할 수 있도록 해줍니다.

Laravel은 철저한 의존성 주입, 표현력 있는 데이터베이스 추상화 레이어, 큐 및 예약된 작업, 유닛 및 통합 테스트 등 강력한 기능을 제공하면서도 놀라운 개발자 경험을 제공하기 위해 노력합니다.

PHP 웹 프레임워크를 처음 접하는 사용자든 수년간의 경험을 가진 사용자든, Laravel은 함께 성장할 수 있는 프레임워크입니다. 웹 개발자로서 첫 발을 내딛거나 전문 지식을 한 단계 끌어올리는 데 도움을 드릴 것입니다. 여러분이 무엇을 만들지 기대됩니다.

왜 Laravel인가?

웹 애플리케이션을 구축할 때 다양한 도구와 프레임워크를 사용할 수 있습니다. 그러나 저희는 Laravel이 최신 풀 스택 웹 애플리케이션을 구축하는 데 가장 적합한 선택이라고 믿습니다.

진보적인 프레임워크

저희는 Laravel을 "진보적인" 프레임워크라고 부르고 싶습니다. 이는 Laravel이 여러분과 함께 성장한다는 의미입니다. 웹 개발에 첫발을 내딛는 단계라면 Laravel의 방대한 문서 라이브러리, 가이드 및 비디오 튜토리얼이 압도되지 않고도 기본을 배우는 데 도움이 될 것입니다.

숙련된 개발자라면 Laravel은 의존성 주입, 유닛 테스트, 큐, 실시간 이벤트 등을 위한 강력한 도구를 제공합니다. Laravel은 전문적인 웹 애플리케이션을 구축하기 위해 세밀하게 조정되었으며 엔터프라이즈 작업 부하를 처리할 준비가 되어 있습니다.

확장 가능한 프레임워크

Laravel은 매우 확장 가능합니다. PHP의 확장 친화적인 특성과 Redis와 같은 빠르고 분산된 캐시 시스템에 대한 Laravel의 기본 지원 덕분에 Laravel을 사용한 수평 확장은 매우 쉽습니다. 실제로 Laravel 애플리케이션은 월간 수억 건의 요청을 처리하도록 쉽게 확장되었습니다.

극단적인 확장이 필요하십니까? Laravel Vapor와 같은 플랫폼을 사용하면 AWS의 최신 서버리스 기술에서 거의 무한대로 Laravel 애플리케이션을 실행할 수 있습니다.

커뮤니티 프레임워크

Laravel은 PHP 생태계에서 최고의 패키지를 결합하여 가장 강력하고 개발자 친화적인 프레임워크를 제공합니다. 또한 전 세계의 수천 명의 재능있는 개발자들이 프레임워크에 기여했습니다. 어쩌면 당신도 Laravel 기여자가 될 수 있을 것입니다.

Laravel 애플리케이션 생성

PHP 및 Laravel 설치 프로그램 설치

첫 번째 Laravel 애플리케이션을 만들기 전에 로컬 컴퓨터에 PHP, Composer 및 Laravel 설치 프로그램이 설치되어 있는지 확인하십시오. 또한 애플리케이션의 프런트엔드 자산을 컴파일할 수 있도록 Node 및 NPM 또는 Bun을 설치해야 합니다.

로컬 컴퓨터에 PHP 및 Composer가 설치되어 있지 않은 경우 다음 명령은 macOS, Windows 또는 Linux에 PHP, Composer 및 Laravel 설치 프로그램을 설치합니다.

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

# 관리자 권한으로 실행하세요...
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'))

/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

애플리케이션 생성하기

PHP, Composer, Laravel 설치 프로그램을 설치한 후, 새 Laravel 애플리케이션을 만들 준비가 되었습니다. Laravel 설치 프로그램은 선호하는 테스트 프레임워크, 데이터베이스 및 스타터 키트를 선택하라는 메시지를 표시합니다:

laravel new example-app

애플리케이션이 생성되면 dev Composer 스크립트를 사용하여 Laravel의 로컬 개발 서버, 큐 워커 및 Vite 개발 서버를 시작할 수 있습니다:

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

개발 서버를 시작했다면 웹 브라우저에서 http://localhost:8000에서 애플리케이션에 액세스할 수 있습니다. 다음으로, Laravel 생태계에서 다음 단계로 나아갈 준비가 되었습니다. 물론, 데이터베이스를 구성하고 싶을 수도 있습니다.

초기 구성

Laravel 프레임워크의 모든 구성 파일은 config 디렉토리에 저장됩니다. 각 옵션에는 설명이 포함되어 있으므로 파일을 살펴보고 사용 가능한 옵션에 익숙해지십시오.

Laravel은 즉시 사용할 수 있도록 추가 구성이 거의 필요하지 않습니다. 개발을 시작할 수 있습니다! 하지만 config/app.php 파일과 해당 문서를 검토하는 것이 좋습니다. 여기에는 애플리케이션에 따라 변경할 수 있는 timezone 및 locale과 같은 여러 옵션이 포함되어 있습니다.

환경 기반 구성

Laravel의 많은 구성 옵션 값은 애플리케이션이 로컬 머신에서 실행 중인지 프로덕션 웹 서버에서 실행 중인지에 따라 다를 수 있으므로, 많은 중요한 구성 값은 애플리케이션 루트에 있는 .env 파일을 사용하여 정의됩니다.

.env 파일은 애플리케이션을 사용하는 각 개발자/서버에 다른 환경 구성이 필요할 수 있으므로 애플리케이션의 소스 제어에 커밋하면 안 됩니다. 또한 침입자가 소스 제어 리포지토리에 액세스하는 경우 중요한 자격 증명이 노출되므로 보안 위험이 될 수 있습니다.

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

이제 Laravel 애플리케이션을 만들었으므로 데이터베이스에 일부 데이터를 저장하고 싶을 것입니다. 기본적으로 애플리케이션의 .env 구성 파일은 Laravel이 SQLite 데이터베이스와 상호 작용하도록 지정합니다.

애플리케이션을 생성하는 동안 Laravel은 database/database.sqlite 파일을 만들고 애플리케이션의 데이터베이스 테이블을 만들기 위해 필요한 마이그레이션을 실행했습니다.

MySQL 또는 PostgreSQL과 같은 다른 데이터베이스 드라이버를 사용하려는 경우 .env 구성 파일을 업데이트하여 해당 데이터베이스를 사용하도록 할 수 있습니다. 예를 들어 MySQL을 사용하려면 다음과 같이 .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

디렉토리 구성

Laravel은 항상 웹 서버에 구성된 "웹 디렉토리"의 루트에서 제공되어야 합니다. "웹 디렉토리"의 하위 디렉토리에서 Laravel 애플리케이션을 제공하려고 시도해서는 안 됩니다. 그렇게 하려고 시도하면 애플리케이션 내에 있는 민감한 파일이 노출될 수 있습니다.

Herd를 사용한 로컬 설치

Laravel Herd는 macOS 및 Windows를 위한 매우 빠르고 네이티브한 Laravel 및 PHP 개발 환경입니다. Herd에는 PHP 및 Nginx를 포함하여 Laravel 개발을 시작하는 데 필요한 모든 것이 포함되어 있습니다.

Herd를 설치하면 Laravel 개발을 시작할 준비가 된 것입니다. Herd에는 php, composer, laravel, expose, node, npm 및 nvm을 위한 명령줄 도구가 포함되어 있습니다.

macOS의 Herd

macOS에서 개발하는 경우 Herd 웹사이트에서 Herd 설치 프로그램을 다운로드할 수 있습니다. 설치 프로그램은 자동으로 최신 버전의 PHP를 다운로드하고 Mac이 백그라운드에서 항상 Nginx를 실행하도록 구성합니다.

macOS용 Herd는 "주차된" 디렉토리를 지원하기 위해 dnsmasq를 사용합니다. 주차된 디렉토리에 있는 모든 Laravel 애플리케이션은 자동으로 Herd에서 제공됩니다. 기본적으로 Herd는 ~/Herd에 주차된 디렉토리를 만들고 해당 디렉토리 이름을 사용하여 .test 도메인에서 이 디렉토리에 있는 모든 Laravel 애플리케이션에 액세스할 수 있습니다.

Herd를 설치한 후 새로운 Laravel 애플리케이션을 만드는 가장 빠른 방법은 Herd에 번들로 제공되는 Laravel CLI를 사용하는 것입니다.

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

물론, 시스템 트레이의 Herd 메뉴에서 열 수 있는 Herd UI를 통해 파킹된 디렉토리 및 기타 PHP 설정을 언제든지 관리할 수 있습니다.

Herd 문서를 확인하여 Herd에 대해 더 자세히 알아볼 수 있습니다.

Windows에서 Herd 사용하기

Herd 웹사이트에서 Herd용 Windows 설치 프로그램을 다운로드할 수 있습니다. 설치가 완료되면 Herd를 시작하여 온보딩 프로세스를 완료하고 처음으로 Herd UI에 액세스할 수 있습니다.

Herd UI는 시스템 트레이 아이콘을 왼쪽 클릭하여 액세스할 수 있습니다. 오른쪽 클릭하면 매일 필요한 모든 도구에 액세스할 수 있는 빠른 메뉴가 열립니다.

설치하는 동안 Herd는 홈 디렉토리에 %USERPROFILE%\Herd에 "파킹된" 디렉토리를 만듭니다. 파킹된 디렉토리에 있는 모든 Laravel 애플리케이션은 Herd에 의해 자동으로 제공되며, 이 디렉토리의 모든 Laravel 애플리케이션은 디렉토리 이름을 사용하여 .test 도메인에서 액세스할 수 있습니다.

Herd를 설치한 후 새로운 Laravel 애플리케이션을 만드는 가장 빠른 방법은 Herd에 번들로 제공되는 Laravel CLI를 사용하는 것입니다. 시작하려면 Powershell을 열고 다음 명령을 실행합니다.

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

Herd에 대해 더 자세히 알아보려면 Windows용 Herd 문서를 확인하세요.

Sail을 사용한 Docker 설치

선호하는 운영 체제에 관계없이 Laravel을 최대한 쉽게 시작할 수 있도록 하고 싶습니다. 따라서 로컬 머신에서 Laravel 애플리케이션을 개발하고 실행하기 위한 다양한 옵션이 있습니다. 나중에 이러한 옵션을 살펴볼 수도 있지만, Laravel은 Docker를 사용하여 Laravel 애플리케이션을 실행하기 위한 기본 제공 솔루션인 Sail을 제공합니다.

Docker는 로컬 머신에 설치된 소프트웨어나 구성에 간섭하지 않는 작고 가벼운 "컨테이너"에서 애플리케이션과 서비스를 실행하는 도구입니다. 즉, 로컬 머신에서 웹 서버 및 데이터베이스와 같은 복잡한 개발 도구를 구성하거나 설정하는 것에 대해 걱정할 필요가 없습니다. 시작하려면 Docker Desktop만 설치하면 됩니다.

Laravel Sail은 Laravel의 기본 Docker 구성과 상호 작용하기 위한 가벼운 명령줄 인터페이스입니다. Sail은 이전 Docker 경험 없이 PHP, MySQL 및 Redis를 사용하여 Laravel 애플리케이션을 구축하기 위한 훌륭한 출발점을 제공합니다.

macOS에서 Sail

Mac에서 개발 중이고 Docker Desktop이 이미 설치되어 있다면 간단한 터미널 명령을 사용하여 새 Laravel 애플리케이션을 만들 수 있습니다. 예를 들어 "example-app"이라는 디렉토리에 새 Laravel 애플리케이션을 만들려면 터미널에서 다음 명령을 실행할 수 있습니다.

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

물론, 이 URL에서 "example-app"을 원하는 대로 변경할 수 있습니다. 단, 애플리케이션 이름에는 영숫자, 대시, 밑줄만 포함해야 합니다. Laravel 애플리케이션의 디렉토리는 명령어를 실행한 디렉토리 내에 생성됩니다.

Sail의 애플리케이션 컨테이너가 로컬 머신에 빌드되는 동안 Sail 설치는 몇 분 정도 걸릴 수 있습니다.

애플리케이션이 생성된 후, 애플리케이션 디렉토리로 이동하여 Laravel Sail을 시작할 수 있습니다. Laravel Sail은 Laravel의 기본 Docker 구성과 상호 작용하기 위한 간단한 명령줄 인터페이스를 제공합니다:

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

애플리케이션의 Docker 컨테이너가 시작되면, 애플리케이션의 데이터베이스 마이그레이션을 실행해야 합니다:

./vendor/bin/sail artisan migrate

마지막으로 웹 브라우저에서 http://localhost 주소로 애플리케이션에 접속할 수 있습니다.

Windows에서 Sail 사용하기

Windows 컴퓨터에서 새로운 Laravel 애플리케이션을 만들기 전에 Docker Desktop을 설치해야 합니다. 다음으로, Windows Subsystem for Linux 2(WSL2)가 설치 및 활성화되었는지 확인해야 합니다. WSL을 사용하면 Windows 10에서 Linux 바이너리 실행 파일을 기본적으로 실행할 수 있습니다. WSL2를 설치하고 활성화하는 방법에 대한 정보는 Microsoft의 개발자 환경 문서에서 찾을 수 있습니다.

다음으로, 첫 번째 Laravel 애플리케이션을 만들 준비가 되었습니다. Windows 터미널을 실행하고 WSL2 Linux 운영 체제에 대한 새 터미널 세션을 시작하십시오. 그런 다음 간단한 터미널 명령을 사용하여 새로운 Laravel 애플리케이션을 만들 수 있습니다. 예를 들어 "example-app"이라는 디렉토리에 새로운 Laravel 애플리케이션을 만들려면 터미널에서 다음 명령을 실행할 수 있습니다.

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

물론, 이 URL에서 "example-app"을 원하는 이름으로 변경할 수 있습니다. 단, 애플리케이션 이름은 영숫자, 대시, 밑줄만 포함해야 합니다. Laravel 애플리케이션 디렉터리는 명령어를 실행한 디렉터리 내에 생성됩니다.

Sail 설치는 Sail의 애플리케이션 컨테이너가 로컬 머신에 빌드되는 동안 몇 분 정도 걸릴 수 있습니다.

애플리케이션이 생성된 후에는 애플리케이션 디렉터리로 이동하여 Laravel Sail을 시작할 수 있습니다. Laravel Sail은 Laravel의 기본 Docker 구성을 상호 작용하기 위한 간단한 명령줄 인터페이스를 제공합니다.

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

애플리케이션의 Docker 컨테이너가 시작되면 애플리케이션의 데이터베이스 마이그레이션을 실행해야 합니다.

./vendor/bin/sail artisan migrate

마지막으로 웹 브라우저에서 http://localhost 로 애플리케이션에 접속할 수 있습니다.

WSL2 내에서 개발하기

물론 WSL2 설치 내에서 생성된 Laravel 애플리케이션 파일을 수정할 수 있어야 합니다. 이를 위해 Microsoft의 Visual Studio Code 편집기와 원격 개발용 공식 확장을 사용하는 것이 좋습니다.

이러한 도구가 설치되면 Windows 터미널을 사용하여 애플리케이션의 루트 디렉토리에서 code . 명령을 실행하여 Laravel 애플리케이션을 열 수 있습니다.

Linux에서 Sail 사용하기

Linux에서 개발 중이고 Docker Compose가 이미 설치되어 있다면 간단한 터미널 명령을 사용하여 새 Laravel 애플리케이션을 생성할 수 있습니다.

먼저, Linux용 Docker Desktop을 사용 중이라면 다음 명령을 실행해야 합니다. Linux용 Docker Desktop을 사용하지 않는 경우 이 단계를 건너뛰어도 됩니다.

docker context use default

그런 다음, "example-app"이라는 디렉토리에 새 Laravel 애플리케이션을 만들려면 터미널에서 다음 명령을 실행하면 됩니다.

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

물론, 이 URL에서 "example-app"을 원하는 대로 변경할 수 있습니다. 단, 애플리케이션 이름은 영숫자, 대시, 밑줄만 포함해야 합니다. Laravel 애플리케이션 디렉토리는 명령을 실행한 디렉토리 내에 생성됩니다.

Sail 설치는 로컬 머신에서 Sail의 애플리케이션 컨테이너가 빌드되는 동안 몇 분 정도 걸릴 수 있습니다.

애플리케이션이 생성된 후 애플리케이션 디렉토리로 이동하여 Laravel Sail을 시작할 수 있습니다. Laravel Sail은 Laravel의 기본 Docker 구성과 상호 작용하기 위한 간단한 명령줄 인터페이스를 제공합니다.

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

애플리케이션의 Docker 컨테이너가 시작되면 애플리케이션의 데이터베이스 마이그레이션을 실행해야 합니다.

./vendor/bin/sail artisan migrate

마지막으로, 웹 브라우저에서 http://localhost 로 애플리케이션에 액세스할 수 있습니다.

Sail 서비스 선택하기

Sail을 통해 새로운 Laravel 애플리케이션을 생성할 때 with 쿼리 문자열 변수를 사용하여 새 애플리케이션의 docker-compose.yml 파일에 구성할 서비스를 선택할 수 있습니다. 사용 가능한 서비스에는 mysql, pgsql, mariadb, redis, memcached, meilisearch, typesense, 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

IDE 지원

Laravel 애플리케이션을 개발할 때 원하는 코드 편집기를 자유롭게 사용할 수 있습니다. 하지만 PhpStorm은 Laravel Pint를 포함하여 Laravel 및 해당 생태계에 대한 광범위한 지원을 제공합니다.

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

다음 단계

이제 Laravel 애플리케이션을 만들었으므로 다음으로 무엇을 배워야 할지 궁금할 수 있습니다. 먼저 다음 문서를 읽고 Laravel이 어떻게 작동하는지 익히는 것이 좋습니다.

Laravel을 어떻게 사용하느냐에 따라 다음 여정이 결정됩니다. Laravel을 사용하는 방법에는 여러 가지가 있으며, 아래에서 프레임워크의 두 가지 주요 사용 사례를 살펴보겠습니다.

Laravel 풀 스택 프레임워크

Laravel은 풀 스택 프레임워크로 사용할 수 있습니다. "풀 스택" 프레임워크란 Laravel을 사용하여 애플리케이션에 대한 요청을 라우팅하고 Blade 템플릿 또는 Inertia와 같은 단일 페이지 애플리케이션 하이브리드 기술을 통해 프론트엔드를 렌더링하는 것을 의미합니다. 이것은 Laravel 프레임워크를 사용하는 가장 일반적인 방법이며, 저희 생각에는 Laravel을 사용하는 가장 생산적인 방법입니다.

이것이 Laravel을 사용하려는 방법이라면 프론트엔드 개발, 라우팅, 뷰 또는 Eloquent ORM에 대한 문서를 확인하는 것이 좋습니다. 또한 Livewire 및 Inertia와 같은 커뮤니티 패키지에 대해 배우는 데 관심이 있을 수도 있습니다. 이러한 패키지를 사용하면 단일 페이지 JavaScript 애플리케이션에서 제공하는 많은 UI 이점을 누리면서 Laravel을 풀 스택 프레임워크로 사용할 수 있습니다.

Laravel을 풀 스택 프레임워크로 사용하는 경우 Vite를 사용하여 애플리케이션의 CSS 및 JavaScript를 컴파일하는 방법을 배우는 것이 좋습니다.

Laravel API 백엔드

Laravel은 JavaScript 단일 페이지 애플리케이션 또는 모바일 애플리케이션의 API 백엔드 역할도 할 수 있습니다. 예를 들어 Next.js 애플리케이션의 API 백엔드로 Laravel을 사용할 수 있습니다. 이 컨텍스트에서 Laravel을 사용하여 애플리케이션에 대한 인증 및 데이터 저장/검색을 제공할 수 있으며, 큐, 이메일, 알림 등과 같은 Laravel의 강력한 서비스를 활용할 수도 있습니다.

이것이 Laravel을 사용하려는 방법이라면 라우팅, Laravel Sanctum 및 Eloquent ORM에 대한 문서를 확인하는 것이 좋습니다.