Laravel 프로젝트 설치

안녕하세요! 이제 드디어 Laravel 프로젝트를 만들어보겠습니다. Laravel은 마치 집의 골조와 같다고 생각하시면 됩니다. 이 골조 위에서 우리가 원하는 웹 애플리케이션을 만들어 나갈 거예요.

💡 강의 노트: Laravel 설치는 생각보다 간단합니다! Composer라는 도구가 모든 걸 자동으로 해주거든요. 마치 자동 조립 가구 같다고 생각하시면 됩니다.

🚀 Laravel 프로젝트 생성

왜 Laravel을 사용하나요?

Laravel을 선택하는 이유를 먼저 말씀드릴게요.

  • 빠른 개발: 이미 만들어진 기능들이 많아서 개발 시간이 단축됩니다
  • 보안: 웹 보안에 필요한 기능들이 기본으로 들어있어요
  • 확장성: 작은 프로젝트부터 대규모 서비스까지 대응 가능합니다

방법 1: Laravel 인스톨러 사용 (추천)

이 방법이 가장 쉽고 빠릅니다. Laravel 전용 설치 도구를 사용하는 방법이에요.

🎯 실습 가이드: 터미널을 열고 아래 명령어를 하나씩 입력해주세요. 각 명령어가 끝날 때까지 기다려주시고, 에러가 나면 손을 들어주세요!

# 1단계: Laravel 인스톨러를 컴퓨터에 전역으로 설치
composer global require laravel/installer

# 2단계: jinyphp_demo_01이라는 이름으로 새 프로젝트 생성
laravel new jinyphp_demo_01

# 3단계: 생성된 프로젝트 폴더로 이동
cd jinyphp_demo_01

💬 설명:

  • 1단계는 한 번만 실행하면 됩니다 (이미 설치되어 있다면 스킵)
  • 2단계에서 프로젝트 이름을 jinyphp_demo_01로 정했어요 (원하시면 다른 이름으로 바꿔도 됩니다)
  • 3단계로 프로젝트 폴더 안으로 들어가는 거예요

방법 2: Composer로 직접 생성

Composer만으로도 Laravel 프로젝트를 만들 수 있습니다. 인스톨러 없이도 가능한 방법이에요.

# Laravel 프로젝트 생성
composer create-project laravel/laravel jinyphp_demo_01

# 프로젝트 디렉토리로 이동
cd jinyphp_demo_01

🤔 어떤 방법을 선택할까요? 방법 1을 추천합니다! 더 빠르고 앞으로도 계속 사용할 수 있거든요.

⚙️ 기본 Laravel 설정

Laravel이 설치되었으니 이제 기본 설정을 해보겠습니다. 마치 새 차를 받고 시트 조절을 하는 것과 같다고 생각하세요.

환경 파일 설정

.env 파일은 Laravel의 핵심 설정 파일입니다. 데이터베이스 접속 정보, 암호화 키 등 중요한 설정들이 들어있어요.

🔐 보안 팁: .env 파일은 절대 다른 사람과 공유하면 안 됩니다! 비밀번호나 API 키 같은 민감한 정보가 들어있거든요.

# .env 파일이 없다면 복사 (보통 자동으로 생성됩니다)
cp .env.example .env

# 애플리케이션 보안 키 생성 (매우 중요!)
php artisan key:generate

💬 설명:

  • key:generate 명령어는 암호화에 사용할 비밀 키를 만들어줍니다
  • 이 키가 없으면 Laravel이 제대로 작동하지 않아요

.env 파일 기본 설정 확인

생성된 .env 파일을 열어서 내용을 확인해보겠습니다. 에디터(VS Code, 메모장 등)로 열어주세요.

# 애플리케이션 기본 설정
APP_NAME="Jinyphp Demo 01"
APP_ENV=local
APP_DEBUG=true
APP_TIMEZONE=Asia/Seoul
APP_URL=http://localhost:8000

# 데이터베이스 설정 (PostgreSQL 기본)
DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=jinyphp_demo_01
DB_USERNAME=postgres
DB_PASSWORD=

# 캐시 설정 (개발 환경)
CACHE_STORE=file
SESSION_DRIVER=file
QUEUE_CONNECTION=sync

# 메일 설정 (개발 환경)
MAIL_MAILER=log
MAIL_HOST=mailpit
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS="hello@example.com"
MAIL_FROM_NAME="${APP_NAME}"

# 로그 설정
LOG_CHANNEL=stack
LOG_DEPRECATIONS_CHANNEL=null
LOG_LEVEL=debug

📝 수정 포인트:

  • APP_NAME을 원하는 이름으로 바꿔보세요
  • APP_TIMEZONE을 Asia/Seoul로 설정 (한국 시간대)
  • 데이터베이스 설정은 다음 단계에서 자세히 다룰 예정입니다

📁 중요한 파일 위치들:

jinyphp_demo_01/
├── .env                    # 📄 환경 설정 파일 (중요!)
├── .env.example           # 📄 환경 설정 예제
├── composer.json          # 📄 PHP 패키지 정보
├── package.json           # 📄 NPM 패키지 정보
├── artisan                # 📄 Laravel 명령어 도구
├── config/               # 📁 설정 파일들
├── app/                  # 📁 애플리케이션 코어
└── storage/logs/         # 📁 로그 파일들

🧪 Laravel 설치 확인

설치가 제대로 되었는지 확인해보겠습니다. 마치 새 차 시동을 걸어보는 것과 같아요.

Laravel 버전 및 환경 확인

# Laravel 버전 확인
php artisan --version
# 결과 예시: Laravel Framework 11.x.x

# 환경 정보 확인
php artisan env
# 결과: local (개발 환경임을 확인)

# 설정 확인
php artisan config:show app
# 앱 설정 정보 출력

✅ 체크 포인트: 위 명령어들이 에러 없이 실행되면 설치가 성공한 거예요!

개발 서버 실행

이제 Laravel 웹사이트를 실제로 확인해보겠습니다!

# Laravel 개발 서버 시작
php artisan serve

# 브라우저에서 http://localhost:8000 접속해보세요!

🎉 성공 확인:

  • 브라우저에서 Laravel 환영 페이지가 보이면 성공!
  • “Laravel” 로고와 함께 깔끔한 페이지가 나타날 거예요

🚨 문제 해결:

  • 만약 8000번 포트가 사용 중이라면: php artisan serve --port=8080
  • 외부에서 접속하려면: php artisan serve --host=0.0.0.0 --port=8000

프로젝트 구조 이해하기

Laravel 프로젝트의 폴더 구조를 간단히 살펴보겠습니다. 처음에는 복잡해 보이지만, 규칙이 있어요.

jinyphp_demo_01/
├── app/                    # 🏠 애플리케이션의 심장부
│   ├── Http/Controllers/   # 📞 사용자 요청을 처리하는 곳
│   ├── Models/            # 🗂️ 데이터베이스와 연결되는 부분
│   ├── Providers/         # ⚙️ Laravel 시스템 설정
│   └── Livewire/         # ⚡ 동적 UI 컴포넌트
├── config/               # 📋 모든 설정 파일들
├── database/             # 🗄️ 데이터베이스 관련 파일들
├── resources/            # 🎨 프론트엔드 관련 파일들
│   ├── views/           # 🖼️ 사용자에게 보여지는 페이지
│   ├── css/            # 🎨 스타일 시트
│   └── js/             # ⚡ 자바스크립트 파일
├── routes/              # 🛣️ URL 경로 정의
├── storage/             # 📦 로그, 캐시, 세션 저장소
└── public/              # 🌍 웹에서 직접 접근 가능한 파일들

💡 초보자 팁: 처음에는 app/, resources/views/, routes/ 폴더만 알아도 충분합니다. 나머지는 천천히 배워가면 돼요!

✅ Laravel 설치 완료 체크리스트

설치 확인

  • Laravel 프로젝트 생성 완료 (jinyphp_demo_01 폴더 확인)
  • .env 파일 존재 및 설정 확인
  • 애플리케이션 키 생성 완료 (php artisan key:generate)
  • 개발 서버 정상 실행 (php artisan serve)
  • 브라우저 접속 확인 (http://localhost:8000)

다음 단계 준비

  • 프로젝트 구조 대략적으로 이해
  • 터미널/명령 프롬프트 사용법 익숙해짐
  • 에디터 (VS Code 등) 설치 및 프로젝트 열기

🔗 다음 단계

Laravel 설치가 완료되었습니다! 이제 다음 단계로 넘어가보겠습니다:

  1. 데이터베이스 설정 → 03.database.md
    • PostgreSQL 또는 MySQL 연결
    • 데이터베이스 테이블 생성
  2. GitHub 배포 준비 → 04.github-deploy.md
    • Git 저장소 설정
    • 소스코드 관리 시작

❓ 자주 묻는 질문

Q1: 프로젝트 이름을 바꾸고 싶어요

A: 새로 만드시는 걸 추천합니다. laravel new 새이름 명령어로 다시 생성하세요.

Q2: php artisan serve가 안 돼요

A: PHP가 제대로 설치되었는지 확인해보세요. php --version 명령어로 확인 가능합니다.

Q3: 8000번 포트를 다른 프로그램이 사용하고 있어요

A: php artisan serve --port=8080처럼 다른 포트를 사용하세요.

Q4: .env 파일이 없어요

A: cp .env.example .env 명령어로 복사하고 php artisan key:generate를 실행하세요.

다음 강의에서는 데이터베이스를 연결해보겠습니다. 수고하셨어요! 🎉