시작하기

Laravel 애플리케이션.

Laravel 프로젝트에 기본으로 제공되는 것: APP_KEY와 운영 환경 설정, 데이터베이스를 추가하기 전까지의 SQLite, 릴리스 명령으로서의 마이그레이션, 큐 워커와 스케줄러.

2 분 소요

Laravel은 composer.json의 laravel/framework로 인식됩니다. 서버 설정이나 저장소에 추가 파일 없이 그대로 배포하면 됩니다.

빌드와 실행 방식

  • PHP — 8.2, 8.3, 8.4 중 composer.json의 php 요구 사항을 만족하는 가장 낮은 버전입니다(지정이 없으면 8.3).
  • Composer — composer install --no-dev --optimize-autoloader.
  • 프런트엔드 에셋 — package.json에 build 스크립트(Vite)가 있으면 실행하고 public/build를 포함합니다.
  • 시작 시 — storage:link를 실행한 뒤 설정, 라우트, 뷰 캐시를 만듭니다.
  • HTTPS — 애플리케이션이 HTTPS 요청을 보안 연결로 인식하므로, 프록시 신뢰를 직접 설정하지 않아도 url(), asset(), 리디렉션이 https://를 사용합니다.

자동으로 설정되는 변수

변수값
APP_KEY첫 배포 때 한 번 생성되어 변수와 함께 보관됩니다
APP_ENVproduction
APP_DEBUGfalse
APP_URL애플리케이션 주소
LOG_CHANNELstderr — 로그 탭에 Laravel 로그가 표시됩니다
SESSION_DRIVER, CACHE_STORE애플리케이션에 Valkey가 있으면 redis, 없으면 file

같은 이름의 변수를 직접 추가하면 이 값을 대신합니다(예: SESSION_DRIVER=database). 환경 변수를 참고하세요.

데이터베이스: 처음에는 SQLite

데이터베이스가 없는 새 Laravel 애플리케이션은 Laravel 기본값인 SQLite에 데이터를 보관하며, 파일은 애플리케이션 디스크의 storage/app/database.sqlite에 있습니다. 이 파일은 배포 후에도 유지되고 애플리케이션의 매일 백업에 포함되므로, 먼저 출시하고 데이터베이스는 나중에 정해도 됩니다.

프로젝트에 PostgreSQL 또는 MySQL을 추가하면(개요 → 서비스 → 서비스 추가) 다음 배포부터 애플리케이션이 그 데이터베이스를 사용하고 마이그레이션도 그곳에서 실행됩니다. SQLite 파일의 데이터는 옮겨지지 않으므로, 필요하면 먼저 내보낸 뒤 데이터베이스의 데이터 탭에서 가져오세요. 데이터베이스를 참고하세요.

마이그레이션 — 릴리스 명령

권장 릴리스 명령은 php artisan migrate --force입니다. 배포할 때마다 새 버전이 방문자를 받기 전에 한 번 실행되며, 마이그레이션이 실패하면 현재 버전이 계속 실행됩니다. 프로세스 탭에서 변경할 수 있습니다. 배포를 참고하세요.

큐 워커와 스케줄러

프로세스 탭에서는 기본으로 다음이 실행됩니다.

항목명령
백그라운드 워커 “queue”php artisan queue:work --sleep=3 --tries=3 --max-time=3600
매분 실행되는 예약 명령php artisan schedule:run

이들은 애플리케이션의 리소스를 함께 사용하며 배포할 때마다 재시작합니다. 프로세스 탭에서 변경하거나 삭제할 수 있습니다. 예를 들어 Valkey와 Horizon을 사용한다면 워커를 php artisan horizon으로 바꾸세요.

큐 작업이 많다면 워커를 자체 리소스를 가진 별도의 백그라운드 워커 서비스로 실행하고 프로세스에서는 삭제하세요. 프로젝트의 서비스를 참고하세요.

캐시, 세션, 큐를 위한 Valkey

프로젝트에 Valkey를 추가하면 세션과 캐시가 자동으로 Valkey로 옮겨집니다(다음 배포부터 적용되며 방문자는 한 번 다시 로그인합니다). 큐와 그 밖의 항목은 변수 탭에서 직접 설정합니다. 예:

CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis

REDIS_HOST, REDIS_PASSWORD, REDIS_PORT, REDIS_CLIENT=phpredis는 자동으로 설정됩니다.

WebSocket(Laravel Reverb)

Reverb는 이 프로젝트의 코드로 만든 웹 서비스로 php artisan reverb:start --host=0.0.0.0 --port=$PORT 명령을 사용해 실행합니다. Reverb에는 별도의 주소가 생깁니다.

파일과 업로드

storage/app의 파일(Laravel의 local 및 public 디스크)은 배포 사이에도 애플리케이션 디스크에 남아 있으며 매일 백업됩니다. 프로젝트 폴더의 나머지는 배포할 때마다 저장소에서 새로 가져옵니다. 파일이 많거나 크다면 Laravel의 s3 디스크로 오브젝트 스토리지를 사용하세요.

아직 해결되지 않았나요?

채팅으로 문의하세요. 하루 중 언제든 AI 어시스턴트가 바로 답하고, 필요하면 엔지니어가 참여합니다.

지원팀에 문의