Laravel 로컬 환경 구축하기 윈도우에서 MySQL 연결하는 법

 

PHP 개발을 조금 더 효율적으로 하고 싶다면, 이제는 프레임워크를 활용하는 것이 필수가 되었습니다. 그중에서도 Laravel은 가장 널리 사용되는 PHP 프레임워크로, 구조적인 개발과 빠른 생산성이 강점입니다.

이 글에서는 윈도우에서 Laravel 로컬 개발 환경을 세팅하는 방법과 함께, MySQL 데이터베이스와 연동하는 방법까지 차근차근 설명드릴게요. 초보자도 쉽게 따라할 수 있도록 구성했으니 안심하고 따라오세요!

1. Laravel 설치를 위한 환경 준비

• PHP 8.x 이상 (Laravel 10 기준)
• Composer (PHP 패키지 관리 도구)
• MySQL 또는 MariaDB
• Laravel Installer (선택 사항)

2. Laragon으로 PHP 개발 환경 구축하기

Laragon 설치 및 Laravel 개발에 최적화된 이유는 다음과 같습니다.

• 빠른 부팅 속도
• *.test 형태의 가상 도메인 자동 설정
• Composer 및 Git 자동 포함
• Laravel 설치 명령어 자동 인식

설치 방법

1. Laragon 공식 홈페이지에서 설치 파일 다운로드
2. 설치 후 실행 → Quick app > Laravel 선택
3. 자동으로 Laravel 프로젝트 생성됨 (C:\laragon\www\프로젝트이름)

3. Laravel에서 MySQL 연결 설정하기

.env 파일 설정

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

1. Laragon 실행 후 MySQL 서버 켜기
2. phpMyAdmin에서 laravel_db 데이터베이스 생성
3. .env 파일 수정 후 저장
4. 터미널에서 php artisan migrate 실행

4. 데이터베이스 확인하기

• users
• migrations
• password_resets

이 테이블들이 보이면 Laravel과 MySQL 연동 성공!

5. 실무 팁: Laravel 프로젝트 관리

• 프로젝트 디렉토리는 영어로
• Laragon 사용 시 php artisan serve 생략 가능
• .env 수정 후 php artisan config:cache 실행

6. 오류 발생 시 확인할 것들

• MySQL 서버가 켜져 있는지
• .env 내용이 정확한지
• 캐시를 삭제했는지

함께 보면 좋은 연관 주제

• Laravel + Vue 환경 구성
• REST API 만들기
• Laravel 인증(Auth) 설정
• Laravel GitHub 업로드

마무리하며

Laravel을 윈도우 환경에서 설치하고 MySQL과 연동하는 과정은 생각보다 간단합니다. Laragon을 활용하면 초보자도 부담 없이 시작할 수 있고, 실무에서도 충분히 활용 가능한 수준의 환경이 구축됩니다.

처음에는 다소 복잡해 보여도, 한 번만 제대로 세팅해 두면 이후 개발 속도는 눈에 띄게 빨라집니다. 다음 글에서는 Laravel에서 게시판이나 로그인 기능 구현을 소개해 드릴게요.