PHP 프레임워크 – Laravel – 1 – Laravel 설치와 구성

작성자 wooah
PHP 프레임워크 - Laravel - 1 - Laravel 설치와 구성
PHP 프레임워크 – Laravel – 1 – Laravel 설치와 구성

PHP 프레임워크 – Laravel – Laravel 설치와 구성

안녕하세요, 여러분~ 😊
이전 시간에는 Laravel이 무엇인지, 어떤 장점이 있는지를 전체적으로 살펴보았죠?
이번 시간에는 Laravel을 내 컴퓨터에 설치하고 실행하는 방법을 자세하고 친근하게 알려드릴게요!

Laravel은 설치만 잘해놓으면 마치 자동정비소처럼 개발을 착착 진행할 수 있는 구조가 되어
더 이상 환경 설정 때문에 시간 낭비할 일이 없어져요 💪

자, 그럼 우리 Laravel 개발을 시작할 준비를 차근차근 해볼까요? 🚀

Laravel 설치를 위한 기본 조건

Laravel은 PHP 언어 기반이기 때문에 아래 환경이 반드시 필요해요:

✅ 필수 구성요소

항목 권장 버전
PHP 8.1 이상
Composer 최신 버전
웹 서버 Apache / Nginx (XAMPP, Laragon 등으로 대체 가능)
데이터베이스 MySQL, MariaDB, PostgreSQL 등

💡 Laravel은 Composer를 통해 설치하고 관리돼요. Composer는 PHP의 패키지 관리자예요!

로컬 개발 환경 준비하기 (초보자용 완전 가이드)

1단계. XAMPP 또는 Laragon 설치 (윈도우 사용자용)

XAMPP는 Apache, MySQL, PHP, Perl이 한 번에 설치되는 패키지에요.

혹은 더 가볍고 Laravel 친화적인 Laragon도 추천해요!

2단계. Composer 설치

Composer는 Laravel을 포함한 PHP 패키지들을 쉽게 설치하고 관리할 수 있게 해주는 도구입니다.

composer --version

Laravel 설치 방법 (2가지)

✅ 방법 1: Laravel 프로젝트 생성 (권장)

composer create-project laravel/laravel my-laravel-app

my-laravel-app이라는 이름의 디렉터리가 생성되며, 최신 버전의 Laravel이 설치돼요.

설치 완료 후 디렉터리 이동:

cd my-laravel-app

✅ 방법 2: 글로벌 설치 후 artisan 사용

composer global require laravel/installer
laravel new my-laravel-app

글로벌로 설치해두면 여러 프로젝트를 빠르게 만들 수 있어요!

Laravel 실행하기 (개발용 내장 서버 사용)

Laravel은 기본적으로 artisan이라는 명령어 도구를 사용합니다.
서버 실행도 아주 간단해요!

php artisan serve

이제 브라우저에서 http://localhost:8000을 열면
짜잔~ 🎉 Laravel의 환영 페이지가 보이실 거예요!

Laravel 디렉터리 구조 살펴보기

Laravel 프로젝트는 처음 보면 디렉터리가 많아서 복잡해 보일 수 있어요.
하지만 알고 보면 기능별로 잘 정리된 우아한 책꽂이 같은 구조랍니다!

폴더명 역할
app/ 핵심 코드 (컨트롤러, 모델, 서비스 등)
routes/ 웹, API 라우터 파일
resources/ 뷰 파일(Blade 템플릿), 언어파일 등
public/ 웹에서 접근 가능한 파일 (index.php, 이미지 등)
database/ 마이그레이션, 시드 데이터
config/ 환경 설정 파일들
vendor/ Composer로 설치된 외부 패키지
.env 환경변수 설정 파일 (DB 정보 등)

.env 파일 설정

.env 파일은 Laravel의 환경설정을 담당하는 아주 중요한 파일이에요.

APP_NAME=Laravel
APP_ENV=local
APP_KEY=base64:...
APP_URL=http://localhost

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

이 파일을 통해 데이터베이스 연결, APP_URL 등 중요한 설정을 쉽게 바꿀 수 있어요.

Artisan 명령어 예시

Laravel에는 artisan이라는 강력한 명령어 도구가 있습니다!

명령어 설명
php artisan serve 개발용 서버 실행
php artisan route:list 현재 등록된 라우터 목록 보기
php artisan make:controller TestController 컨트롤러 생성
php artisan migrate DB 마이그레이션 실행

설치 후 첫 번째 라우팅 해보기

1. routes/web.php 수정

use Illuminate\Support\Facades\Route;

Route::get('/', function () {
    return 'Laravel에 오신 걸 환영합니다!';
});

이제 localhost:8000 접속 시 위 문구가 출력됩니다.

주의할 점 ✅

주의사항 설명
PHP 버전 확인 Laravel 10은 PHP 8.1 이상 필수
Composer 필수 Laravel 설치는 Composer 없이는 불가능
.env 유출 금지 .env 파일은 중요한 정보가 많으니 Git에 올리지 않기!
public 디렉터리 실제 웹 진입점은 public/index.php입니다
권한 설정 storage/와 bootstrap/cache/는 쓰기 권한 필요

마무리하며 😊

Laravel 설치는 마치 “가구가 전부 준비된 집에 이사 오는 것”과 같아요!
기본만 잘 세팅해두면, 그 뒤로는 개발이 훨씬 쾌적해지고 즐거워진답니다.

이번 글에서는 Laravel을 설치하고 실행하기까지의 전 과정을 꼼꼼히 알려드렸어요.
이제 여러분은 Laravel 세계에 첫 발을 디딘 상태! 🎉

다음 시간에는 라우팅과 컨트롤러 만들기에 대해 자세히 다뤄드릴게요.
그럼 모두 즐거운 코딩 하세요~ 💻🌈🔥

답글 남기기