찾다

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

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

Susan Sarandon
Susan Sarandon원래의
2024-10-23 08:07:01565검색

라라벨 세일(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 vx Docker] Efficiently Set Up a Laravel App Dev Environment with Laravel Sail
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 중국어 웹사이트의 기타 관련 기사를 참조하세요!

php laravel bash composer mysql npm if switch for select Directory using Interface this display docker database redis postgresql https
성명：
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.
이전 기사：문자열 연결과 중괄호: PHP 보간에는 어느 것이 더 좋나요?다음 기사：문자열 연결과 중괄호: PHP 보간에는 어느 것이 더 좋나요?

관련 기사

더보기