IT
PHP Laravel
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 개발
-
이메일, 이벤트, 큐 등 활용
댓글
아직 댓글이 없습니다.
로그인 후 댓글을 남길 수 있습니다.