회원가입   로그인
IMG-LOGO
공지사항 :

PHP Laravel

lmkfox - 2025-05-06 07:38:33 42 Views 0 Comment

Laravel 설치부터 초기 설정까지 한 번에 정리하기

PHP 웹 프레임워크 중 가장 많이 사용되는 Laravel은 현대적인 웹 애플리케이션을 빠르고 효율적으로 개발할 수 있도록 다양한 기능을 제공합니다. 이번 글에서는 Laravel을 처음 설치하고 초기 설정을 마치는 과정을 단계별로 안내합니다.

1. Laravel 설치 전 준비 사항

Laravel은 PHP 8.1 이상을 요구하므로, 아래 요소들이 사전에 설치되어 있어야 합니다.

필수 사양

  • PHP >= 8.1

  • Composer (PHP 의존성 관리 도구)

  • MySQL, MariaDB, SQLite, PostgreSQL 중 하나

  • Node.js (Laravel Mix 또는 Vite 사용 시)

  • Git (선택사항)

설치 확인

php -v
composer -V

2. Composer로 Laravel 설치

전역 설치 방법 (선택사항)

composer global require laravel/installer

Laravel 새 프로젝트 생성

laravel new project-name

또는 Composer로 직접 생성

composer create-project laravel/laravel project-name

설치가 완료되면 다음 명령으로 디렉토리 이동

cd project-name

3. 개발 서버 실행

Laravel은 PHP 내장 웹서버를 사용할 수 있습니다.

php artisan serve

브라우저에서 http://localhost:8000 에 접속하면 Laravel 시작 페이지를 볼 수 있습니다.

4. 

.env

 파일 설정 (환경 설정)

.env 파일은 Laravel 애플리케이션의 환경별 설정 파일입니다. 주요 설정 항목은 다음과 같습니다.

APP_NAME=LaravelApp
APP_ENV=local
APP_KEY=base64:xxxxxxxxxxxxxxxxxxxx
APP_DEBUG=true
APP_URL=http://localhost

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_db
DB_USERNAME=root
DB_PASSWORD=secret

.env 파일이 없다면 .env.example을 복사해서 생성하세요.

cp .env.example .env

그 후 앱 키를 생성합니다.

php artisan key:generate

5. 디렉토리 권한 설정 (리눅스/맥)

아래 디렉토리에 웹 서버가 쓰기 권한을 가져야 합니다.

chmod -R 775 storage
chmod -R 775 bootstrap/cache

6. 데이터베이스 마이그레이션

DB 연결 정보를 .env에 설정한 후, 아래 명령으로 기본 테이블 생성

php artisan migrate

7. 기본적인 라우팅, 컨트롤러 확인

routes/web.php

간단한 라우트를 등록해 테스트할 수 있습니다.

Route::get('/hello', function () {
    return 'Hello, Laravel!';
});

브라우저에서 http://localhost:8000/hello 확인

8. 프론트엔드 빌드 (옵션)

Laravel 10부터는 기본적으로 Vite를 사용합니다.

npm install
npm run dev

마무리: 이제 준비 완료

이제 Laravel 설치와 초기 설정이 완료되었습니다. 다음 단계로는 다음과 같은 것들을 할 수 있습니다.

  • MVC 구조 이해 및 사용

  • 인증/권한 기능 구현 (laravel/breeze, jetstream)

  • RESTful API 개발

  • 이메일, 이벤트, 큐 등 활용


댓글