개발노트

고즐의 개발 및 서버 개발 노트

Laragon으로 PHP 8.3 로컬 개발 환경 구축하는 방법

# laragon # php8.3 # mariadb # 로컬개발환경 # php개발

Server 2025.12.13 10일 전 21 회 읽음



왜 Laragon인가

PHP 8.3을 사용하면서 로컬 개발 환경을 새로 구성한다면, XAMPP나 Docker 대신 Laragon을 선택하는 것이 훨씬 효율적이다. 설정 부담은 줄이고, 실전 개발에 집중할 수 있기 때문이다.

Laragon은 PHP, Apache, MariaDB를 한 번에 관리할 수 있는 윈도우용 로컬 개발 환경이다. 특히 PHP 버전 전환, 가상 도메인, hosts 자동 설정까지 개발자가 자주 겪는 번거로운 작업을 자동으로 처리해준다.


PHP 8.3 개발자 기준 장점

Laragon은 최신 PHP 버전을 빠르게 지원하며, 로컬과 실서버 환경을 최대한 비슷하게 유지할 수 있도록 설계되어 있다.
  • PHP 8.3 기본 지원 및 버전 전환 간편
  • MariaDB 사용 가능, MySQL 강제 아님
  • Apache와 Nginx 선택 가능
  • 가상호스트와 hosts 파일 자동 관리
  • 불필요한 설정 최소화

특히 여러 서버를 운영하거나 실서버와 로컬 환경 차이로 고생한 경험이 있다면 Laragon의 장점이 바로 체감된다.


Laragon 설치 후 필수 세팅

설치는 간단하지만, 몇 가지 핵심 설정을 해두면 이후 개발 흐름이 훨씬 안정적이 된다.


PHP 8.3 고정

Laragon은 여러 PHP 버전을 함께 제공한다. 실서버와 동일하게 PHP 8.3을 사용한다면 반드시 버전을 고정해두는 것이 좋다.

Laragon 우클릭 → PHP → Version → 8.3.x 선택


MariaDB 사용 설정

MySQL이 아닌 MariaDB를 사용하는 경우에도 전혀 문제 없다. Laragon은 MariaDB를 기본적으로 지원하며 버전 전환도 가능하다.

Laragon 우클릭 → Database → MariaDB → Version 선택


가상 도메인과 관리자 권한

Laragon의 핵심 기능 중 하나는 폴더 기반 가상 도메인 자동 생성이다. 단, 관리자 권한 실행은 필수다.

Laragon은 www 폴더 아래 디렉터리를 기준으로 자동 가상 도메인을 생성한다. 예를 들어 goz 폴더를 만들면 goz.test 도메인이 자동으로 연결된다.

C:laragonwwwgoz
→ http://goz.test

단, Windows hosts 파일을 수정해야 하므로 Laragon은 반드시 관리자 권한으로 실행해야 한다. 관리자 실행 시 라이선스 안내가 나오더라도 무료 사용에는 전혀 문제가 없다.


Mailpit은 무엇인가

Laragon과 함께 실행되는 Mailpit은 로컬 개발 환경에서 메일 발송을 안전하게 테스트하기 위한 도구다.

Mailpit은 PHP의 mail 함수나 SMTP 호출을 실제 메일 발송 없이 가로채서 웹 화면으로 보여준다. 회원가입, 비밀번호 재설정, 문의 메일 같은 기능을 테스트할 때 매우 유용하다.

기본 접속 주소는 다음과 같다.

http://localhost:8025


실무 기준 정리

Laragon은 무겁지 않으면서도 실서버와 최대한 비슷한 개발 환경을 제공한다. 혼자 개발하는 PHP 개발자에게 특히 적합하다.
  • XAMPP보다 가볍고 유연
  • Docker보다 설정 부담 적음
  • PHP 8.3, MariaDB 환경에 최적
  • 로컬 테스트 후 실서버 반영에 안전

PHP 8.3과 MariaDB를 사용하는 개발자라면, Laragon은 충분히 주력 로컬 개발 환경으로 사용할 만한 선택지다. 환경 세팅에 시간을 쓰기보다 개발 자체에 집중하고 싶다면 특히 그렇다.

문의답변