배포 (Deployment)

• 소개
• 서버 요구 사항
• 서버 설정
  • Nginx
• 최적화
  • 자동 로더 최적화
  • 설정 로딩 최적화
  • 라우트 로딩 최적화
  • 뷰 로딩 최적화
• 디버그 모드
• Forge / Vapor로 배포하기

소개

라라벨 애플리케이션을 실제 프로덕션 환경에 배포할 준비가 되었다면, 효율적인 운영을 위해 꼭 확인하고 적용해야 할 중요한 사항들이 있습니다. 이 문서에서는 라라벨 애플리케이션을 올바르게 배포하기 위해 체크해야 할 주요 포인트들을 안내합니다.

서버 요구 사항

라라벨 프레임워크는 몇 가지 필수 시스템 요구 사항이 있습니다. 웹 서버가 다음 최소 PHP 버전과 확장 모듈을 갖추고 있는지 반드시 확인해야 합니다.

• PHP >= 7.3
• BCMath PHP Extension
• Ctype PHP Extension
• Fileinfo PHP Extension
• JSON PHP Extension
• Mbstring PHP Extension
• OpenSSL PHP Extension
• PDO PHP Extension
• Tokenizer PHP Extension
• XML PHP Extension

서버 설정

Nginx

애플리케이션을 Nginx가 실행 중인 서버에 배포한다면 아래 제공된 설정 파일을 참고하여 웹 서버를 설정할 수 있습니다. 대부분의 경우, 이 파일은 서버의 환경에 맞게 일부 커스터마이징이 필요합니다. 서버 관리에 직접 신경 쓰고 싶지 않으시다면, Laravel Forge와 같은 라라벨 공식 서버 관리·배포 서비스를 활용하는 것도 좋은 방법입니다.

아래 설정 예시와 같이, 웹 서버가 모든 요청을 애플리케이션의 public/index.php 파일로 전달하도록 반드시 설정해야 합니다. 절대로 index.php 파일을 프로젝트 루트로 이동해서는 안 되며, 프로젝트 루트에서 애플리케이션을 서비스하면 중요한 설정 파일들이 외부에 노출될 수 있습니다.

server {
    listen 80;
    listen [::]:80;
    server_name example.com;
    root /srv/example.com/public;

    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-Content-Type-Options "nosniff";

    index index.php;

    charset utf-8;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }

    error_page 404 /index.php;

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}

최적화

자동 로더 최적화

프로덕션 환경에 배포할 때는 Composer의 클래스 자동 로더 맵을 꼭 최적화하여, 필요한 클래스 파일을 빠르게 로드할 수 있도록 해주십시오.

composer install --optimize-autoloader --no-dev

[!TIP] 자동 로더를 최적화하는 것 외에도, 반드시 프로젝트의 소스 제어 저장소에 composer.lock 파일을 포함시키는 것이 좋습니다. composer.lock 파일이 있으면 프로젝트의 의존성 설치 속도가 훨씬 빨라집니다.

설정 로딩 최적화

프로덕션 환경에 애플리케이션을 배포할 때, 반드시 배포 과정에서 config:cache 아티즌 명령어를 실행해야 합니다.

php artisan config:cache

이 명령어는 라라벨의 모든 설정 파일을 하나로 합쳐 캐시된 파일로 만들어주며, 설정값을 불러올 때 파일 시스템 접근 횟수를 대폭 줄여줍니다.

[!NOTE] 배포 과정에서 config:cache 명령어를 사용한다면, 오직 설정 파일 내에서만 env 함수를 호출해야 합니다. 설정이 캐시된 후에는 .env 파일이 로드되지 않으며, .env 변수에 대한 모든 env 함수 호출은 null을 반환하게 됩니다.

라우트 로딩 최적화

많은 라우트를 가진 대규모 애플리케이션을 개발한다면, 배포 시 반드시 route:cache 아티즌 명령어를 실행하는 것이 좋습니다.

php artisan route:cache

이 명령어는 모든 라우트 등록 정보를 하나의 캐시 파일 내의 메서드 호출로 압축하여, 수백 개 이상의 라우트를 등록할 때 라우트 등록 성능을 크게 개선해 줍니다.

뷰 로딩 최적화

프로덕션 환경에 애플리케이션을 배포할 때, 반드시 배포 과정에서 view:cache 아티즌 명령어를 실행하는 것이 좋습니다.

php artisan view:cache

이 명령어는 모든 Blade 뷰 파일을 미리 컴파일해 두므로, 뷰가 요청될 때마다 즉석에서 컴파일하는 대신 미리 준비한 결과를 반환함으로써 성능을 높일 수 있습니다.

디버그 모드

config/app.php 설정 파일의 debug 옵션은 오류가 발생했을 때 사용자가 얼마나 많은 정보를 확인할 수 있는지를 결정합니다. 기본적으로 이 옵션은 .env 파일에 저장된 APP_DEBUG 환경 변수 값을 따릅니다.

프로덕션 환경에서는 이 값을 반드시 false로 설정해야 합니다. 만약 프로덕션에서 APP_DEBUG 변수가 true로 설정되어 있으면, 민감한 설정 정보가 애플리케이션 사용자에게 노출될 위험이 있습니다.

Forge / Vapor로 배포하기

Laravel Forge

직접 서버 설정을 관리할 준비가 아직 되지 않았거나, 라라벨 애플리케이션을 안정적으로 운영하는 데 필요한 다양한 서비스 설정이 부담스럽다면, Laravel Forge를 이용하는 것도 좋은 선택입니다.

Laravel Forge는 DigitalOcean, Linode, AWS 등 다양한 인프라 제공자 위에 서버를 생성할 수 있으며, 라라벨 애플리케이션을 운영하는 데 필요한 Nginx, MySQL, Redis, Memcached, Beanstalk 등 각종 도구를 자동 설치·관리해 줍니다.

Laravel Vapor

라라벨에 최적화된 완전 서버리스·오토 스케일링 배포 플랫폼을 원한다면 Laravel Vapor를 고려해 보세요. Laravel Vapor는 AWS 기반의 서버리스 배포 플랫폼으로, Vapor 위에서 라라벨 인프라를 손쉽게 구축하고 서버리스의 뛰어난 확장성과 심플함을 경험할 수 있습니다. 이 플랫폼은 라라벨 제작진이 직접 미세 조정하여, 기존의 라라벨 개발 방식 그대로 원활하게 사용할 수 있습니다.