[Laravel] 프로젝트 초기 세팅 및 배포 준비 가이드

1. 라라벨 프로젝트 생성

1-1. 새로운 Laravel 프로젝트를 생성하는 명령어는 다음과 같습니다.

composer create-project --prefer-dist laravel/laravel {프로젝트명}

1-2. 기존 프로젝트를 Git에서 받은 경우, 의존성을 설치합니다.

php composer install

---

2. .env 설정

2-1. .env 파일이 없으면 .env.example을 복사하여 생성합니다.

cp .env.example .env

2-2. 앱 키를 생성합니다.

php artisan key:generate

---

3. Node.js 관련 설정 (필요한 경우)

3-1. 프론트엔드 빌드가 필요할 경우 다음 명령어로 패키지를 설치합니다.

npm install

---

4. 데이터베이스 설정

4-1. .env 파일 내 데이터베이스 설정을 실제 환경에 맞게 수정합니다.

예시:

DB_HOST=127.0.0.1
DB_DATABASE=your_database
DB_USERNAME=your_username
DB_PASSWORD=your_password

---

5. 기타 환경 설정

5-1. .env에서 캐시, 큐, 메일 등의 추가 설정을 적용합니다.

예시:

CACHE_DRIVER=file
QUEUE_CONNECTION=sync
MAIL_MAILER=smtp
MAIL_HOST=smtp.mailtrap.io

---

6. 마이그레이션 실행

6-1. DB 테이블 생성을 위한 마이그레이션 명령어를 실행합니다.

php artisan migrate

---

7. 서버 실행

7-1. 기본 개발 서버 실행:

php artisan serve

7-2. 외부 접근이 가능한 서버 실행 (예: Docker, 로컬 네트워크 테스트):

php artisan serve --host=0.0.0.0

---

8. 권한 설정 (Linux 서버 배포 시)

8-1. 쓰기 권한이 필요한 디렉토리에 권한 부여:

chmod -R 775 storage bootstrap/cache

---

9. Git에서 변경 사항 관리

9-1. .env 파일은 Git에 커밋하지 않도록 .gitignore에 포함시킵니다.

9-2. 초기 설정 후 Git에 커밋:

git add .
git commit -m "프로젝트 초기 설정 완료"
git push

---

10. 추가 패키지 설치

10-1. PHP 패키지 설치:

composer require {패키지명}

10-2. Node.js 패키지 설치:

npm install {패키지명}

---

11. 배포 준비 (Production 환경)

11-1. 프로덕션 환경용 패키지 설치:

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

11-2. 캐시 및 퍼포먼스 최적화:

php artisan config:cache
php artisan route:cache
php artisan view:cache

 

---

12. 결론

위 과정을 따르면 Laravel 프로젝트를 로컬에서 개발하고, Git으로 소스 관리를 수행하며, 배포 환경까지 구성할 수 있습니다. 초기 세팅은 장기적인 유지보수성과 성능 향상에 매우 중요하므로, 모든 항목을 꼼꼼히 검토하고 적용하는 것이 좋습니다.