[Laravel vx Docker] Laravel Sail을 사용하여 Laravel 앱 개발 환경을 효율적으로 설정하기

라라벨 세일(Laravel Sail) 소개

Laravel Sail은 Laravel 프레임워크의 공식 개발 환경입니다. Sail은 Docker를 사용하여 Laravel 애플리케이션 개발 환경을 쉽게 설정하고 관리할 수 있는 경량 명령줄 인터페이스(CLI)를 제공합니다. 아래에서는 Laravel Sail의 주요 기능과 사용법을 설명합니다.

Laravel Sail 사용의 이점

1. OS 독립적인 개발 환경 구축
   • Sail은 Docker를 사용하여 Laravel 애플리케이션용 개발 환경을 컨테이너화합니다. 이를 통해 OS에 독립적인 개발 환경을 구축할 수 있습니다.
2. 손쉬운 개발 환경 설정
   • Sail을 사용하면 몇 가지 명령만으로 Laravel 개발 환경을 설정할 수 있습니다. MySQL, Redis, MailHog 등을 이용한 복잡한 개발 환경도 쉽게 구축할 수 있습니다.
3. 다른 버전의 프로젝트도 쉽게 관리
   • 예를 들어 Laravel의 버전은 PHP 버전에 따라 다르지만 docker-compose.yml 파일에서 프로젝트별 환경을 설정해 주면 쉽게 버전을 전환할 수 있습니다.

Laravel Sail과 함께 Docker를 사용하여 프로젝트를 생성하면 구조는 위 다이어그램과 같습니다.

용법

개발환경

• 맥
• PHP v8.3
• 라라벨 v11
• 도커

전제조건

Laravel 프로젝트를 생성하기 전에 Docker Desktop을 다운로드하여 시작하세요.
https://www.docker.com/products/docker-desktop/

1. 라라벨 프로젝트 생성

다음 명령을 실행하여 새로운 Laravel 프로젝트를 생성하고 Laravel Sail을 설정하세요.

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

이렇게 하면 Laravel 프로젝트 파일이 생성됩니다. 생성된 docker-compose.yml 파일에 개발 환경이 설명되어 있습니다.

with 쿼리를 사용하여 서비스 지정

PHP 버전을 지정하거나 MySQL 대신 PostgreSQL을 사용하려면 프로젝트 생성 시 명령에 with=,,...를 지정하면 됩니다.

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

2. 항해 시작

프로젝트 디렉토리로 이동하여 Sail을 시작하세요.

./vendor/bin/sail up -d

이 명령은 Docker 컨테이너를 시작하고 Laravel 애플리케이션을 실행합니다.

※별칭 등록

./vendor/bin/sail을 입력하는 것은 번거로우므로 셸 구성 파일에 별칭 항해로 저장하세요.

다음 명령으로 사용 중인 쉘의 경로를 확인하세요

echo $SHELL

예: /bin/zsh

셸 구성 파일 편집

• zsh의 경우

셸 구성 파일은 ~/.zshrc입니다.
별칭을 추가하려면 다음 명령을 실행하세요

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

• 배쉬용

셸 구성 파일은 ~/.bash_profile 또는 ~/.bashrc입니다.
별칭을 추가하려면 다음 명령을 실행하세요.

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

위 설정으로 항해 명령을 단축된 형태로 실행할 수 있습니다.

./vendor/bin/sail up -d

3. 항해 명령 사용

Sail을 사용하여 다양한 개발 작업을 수행할 수 있습니다. 다음은 몇 가지 예입니다.

• 애플리케이션 시작:

echo $SHELL

• 애플리케이션 중지:

echo "alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'" >> ~/.zshrc
source ~/.zshrc

• Artisan 명령 실행:

echo "alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'" >> ~/.bash_profile
source ~/.bash_profile

• Composer 명령 실행:

sail up -d

• npm 명령 실행:

sail up -d

4. 서비스 변경

프로젝트를 생성한 후에도 Docker 구성 파일인 docker-compose.yml 파일을 수정하여 서비스를 변경할 수 있습니다. 여기서는 PHP 버전과 사용되는 데이터베이스를 변경하겠습니다.

PHP 버전 변경

먼저 현재 PHP 버전을 확인하세요

sail down

다음으로 docker-compose.yml 파일에 설명된 개발 환경 정보를 수정합니다.

sail artisan migrate

빌드 컨텍스트와 이미지를 8.1로 변경합니다.

sail composer install

docker-compose.yml 수정 후 애플리케이션을 중지합니다.

sail npm install

다음으로 Docker 컨테이너를 다시 빌드하여 변경 사항을 반영하세요.

sail php -v
PHP 8.3.12 (cli) (built: Sep 27 2024 03:53:05) (NTS)

애플리케이션을 다시 시작하세요.

services:
    laravel.test:
        build:
            context: "./vendor/laravel/sail/runtimes/8.3"
            dockerfile: Dockerfile
            args:
                WWWGROUP: "${WWWGROUP}"
        image: "sail-8.3/app"

PHP 버전이 변경되었는지 확인하세요.

services:
    laravel.test:
        build:
            context: "./vendor/laravel/sail/runtimes/8.1"
            dockerfile: Dockerfile
            args:
                WWWGROUP: "${WWWGROUP}"
        image: "sail-8.1/app"

PHP 버전이 PHP 8.3에서 PHP 8.1로 변경되었습니다.

사용된 데이터베이스 변경

MySQL로 만든 프로젝트를 PostgreSQL로 변경하세요.

Sail 설치 명령 실행

sail down

pgsql 선택

sail build --no-cache

docker-compose.yml 파일을 확인하고 pgsql 항목이 추가되었는지 확인하세요.

sail up -d

ext, 프로젝트 디렉토리에서 .env 파일을 열고 DB_CONNECTION=pgsql 및 DB_HOST=pgsql이 설정되어 있는지 확인하세요.
그렇지 않은 경우 수동으로 변경하세요.

sail php -v
PHP 8.1.30 (cli) (built: Sep 27 2024 04:07:29) (NTS)

docker-compose.yml 및 .env의 변경 사항을 확인한 후 애플리케이션을 중지합니다.

sail php artisan sail:install

다음으로 Docker 컨테이너를 다시 빌드하여 변경 사항을 반영하세요.

 ┌ Which services would you like to install? ───────────────────┐
 │   ◼ mysql                                                  ┃ │
 │ › ◻ pgsql                                                  │ │
 │   ◻ mariadb                                                │ │
 │   ◻ redis                                                  │ │
 │   ◻ memcached                                              │ │
 └────────────────────────────────────────────────── 1 selected ┘
  Use the space bar to select options.

애플리케이션을 다시 시작하세요.

services:
    laravel.test:
...
        depends_on:
            - mysql
            - redis
            - meilisearch
            - mailpit
            - selenium
            - pgsql
...
        pgsql:
            image: 'postgres:17'
            ports:
                - '${FORWARD_DB_PORT:-5432}:5432'
            environment:
                PGPASSWORD: '${DB_PASSWORD:-secret}'
                POSTGRES_DB: '${DB_DATABASE}'
                POSTGRES_USER: '${DB_USERNAME}'
                POSTGRES_PASSWORD: '${DB_PASSWORD:-secret}'
            volumes:
                - 'sail-pgsql:/var/lib/postgresql/data'
                - './vendor/laravel/sail/database/pgsql/create-testing-database.sql:/docker-entrypoint-initdb.d/10-create-testing-database.sql'
            networks:
                - sail
            healthcheck:
                test:
                    - CMD
                    - pg_isready
                    - '-q'
                    - '-d'
                    - '${DB_DATABASE}'
                    - '-U'
                    - '${DB_USERNAME}'
                retries: 3
                timeout: 5s

마이그레이션 파일을 실행하세요.

DB_CONNECTION=pgsql
DB_HOST=pgsql
DB_PORT=5432
DB_DATABASE=laravel
DB_USERNAME=sail
DB_PASSWORD=******

Docker에서 셸을 시작하고 pgsql을 확인하세요

현재 실행 중인 Docker 컨테이너 목록을 표시합니다.

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

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

애플리케이션의 컨테이너 이름을 확인하고 Docker 내부에서 애플리케이션의 bash를 시작하세요.

./vendor/bin/sail up -d

pgsql에 연결합니다.

echo $SHELL

비밀번호를 묻는 메시지가 표시되므로 .env 파일에 지정된 DB_PASSWORD를 입력하세요.

echo "alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'" >> ~/.zshrc
source ~/.zshrc

pgsql에서 테이블 확인

echo "alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'" >> ~/.bash_profile
source ~/.bash_profile

이렇게 하면 프로젝트 생성 후에도 MySQL에서 PostgreSQL로 변경할 수 있습니다.

결론

이 글을 통해 Laravel Sail을 사용하여 개발 환경을 효율적으로 설정하고 관리하는 방법을 이해할 수 있습니다. 적절한 서비스를 선택하고 프로젝트 요구 사항에 따라 설정을 맞춤화하면 보다 유연하고 강력한 개발 환경을 구현할 수 있습니다.

위 내용은 [Laravel vx Docker] Laravel Sail을 사용하여 Laravel 앱 개발 환경을 효율적으로 설정하기의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!