내 피씨에서 워드프레스를 로컬서버로 구동하기
내 컴퓨터 안에 워드프레스 서버를 통째로 넣는 방법
— Local과 Laragon 이야기
라이브 사이트를 직접 건드리지 않고, 내 PC 안의 “물리적 샌드박스”에서 마음껏 실험하고 부수고 고치는 법
클로드 코드로 워드프레스 사이트 랜딩페이지를 손보는 작업을 하다가 문득 궁금해졌다. 지금 이 화면, 실제 도메인이 아니라 내 컴퓨터 안에서만 존재하는 사이트라는 것. 인터넷 연결도 필요 없고, 실수로 화면을 다 날려먹어도 진짜 손님이 보는 사이트는 멀쩡하다는 것. 이게 어떻게 가능한 걸까 — 그 답이 바로 Local과 Laragon이라는 두 도구였다.
한마디로 정의하면: Local과 Laragon은 웹서버(Apache/nginx), 데이터베이스(MySQL), PHP를 내 PC 안에 미리 통째로 설치·구성해두는 프로그램이다. 워드프레스가 굴러가는 데 필요한 재료를 다 갖춰놓은 “요리 준비 완료 주방”인 셈이다.
🧩 로컬 개발 환경이란 무엇인가
워드프레스 사이트가 브라우저에 뜨려면 뒤에서 세 가지가 동시에 돌아가야 한다. 이 셋을 한 대의 컴퓨터에 몰아넣은 조합을 흔히 LAMP(Linux·Apache·MySQL·PHP) 또는 LEMP(nginx로 바꾼 버전)라고 부른다.
| 구성요소 | 역할 | 대표 프로그램 |
|---|---|---|
| 웹서버 | 브라우저의 요청을 받아 파일을 응답 | Apache, nginx |
| 데이터베이스 | 글, 댓글, 설정값 등 모든 콘텐츠 저장 | MySQL, MariaDB |
| PHP | 워드프레스 코드를 실제로 실행하는 언어 엔진 | PHP 8.x |
이 세 가지를 개별로 하나씩 설치하고 서로 맞물리게 설정하는 건 은근히 손이 많이 가는 작업이다. 버전 충돌, 포트 충돌, 경로 설정 실수— 초보자에게는 진입장벽이 꽤 높다. Local과 Laragon 같은 도구가 하는 일이 바로 이 세 가지를 미리 조립해서, 버튼 몇 번으로 “완성된 서버 환경”을 통째로 내 PC에 띄워주는 것이다.
💡 왜 이런 도구가 만들어졌나
과거의 방식 — 라이브 서버에서 바로 실험
워드프레스 초창기에는 개발자들이 실제 운영 중인 사이트에서 직접 테마 파일을 고치거나, 플러그인을 테스트하는 경우가 흔했다. 문제는 명확하다. 코드 한 줄이 잘못되면 화면이 그대로 흰 화면(치명적 오류)으로 바뀌고, 그 순간 방문자가 보는 사이트도 함께 죽는다.
중간 단계 — XAMPP·MAMP의 등장
이 문제를 해결하려고 XAMPP(크로스플랫폼), MAMP(맥용)처럼 Apache·MySQL·PHP를 한 번에 설치해주는 패키지가 등장했다. 다만 이들은 워드프레스 전용이 아니라 PHP 실행 환경 자체에 초점을 맞춘 범용 도구였다.
지금의 방식 — 워드프레스 특화 도구
Local(WP Engine이 인수해 운영 중인 도구로, 2021년부터 모든 기능을 무료로 전환했다)과 Laragon은 여기서 한 걸음 더 나아가, 워드프레스 사이트 생성 자체를 몇 번의 클릭으로 끝낼 수 있게 만들었다. “사이트 이름만 입력하면 서버 환경부터 워드프레스 설치까지 자동”이라는 게 이 세대 도구들의 핵심 철학이다.
🔄 전체 작업 흐름 — 로컬에서 라이브까지
실제 워드프레스 사이트 개발 작업에서 흔히 쓰는 흐름이 바로 이 구조다. 정리하면 이렇다.
로컬 샌드박스에 사이트 생성
Local이나 Laragon으로 내 PC 안에 워드프레스 사이트를 하나 새로 만든다. 이 사이트는 인터넷 어디에도 연결되어 있지 않은, 완전히 격리된 복제본이다.
VS Code / AI 바이브코딩으로 수정
로컬 사이트의 테마 파일이 저장된 폴더를 VS Code로 열어 직접 코드를 고치거나, Claude Code 같은 AI 코딩 도구에게 “이 카드 클릭하면 상세 페이지로 연결되게 해줘” 같은 요청을 자연어로 던진다. AI가 파일을 직접 수정한다.
로컬 브라우저에서 즉시 확인
Local/Laragon이 만들어준 로컬 주소(예: mysite.local, mysite.test)로 접속해 바로 결과를 눈으로 확인한다. 마음에 안 들면 몇 번이고 고치고 새로고침하면 그만이다 — 아무도 이 화면을 못 본다.
문제 없으면 라이브 서버에 배포
테스트가 끝난 파일만 골라서 SFTP/SCP나 Git으로 실제 운영 서버(Bitnami, Lightsail 등)에 올린다. 이 순간 처음으로 방문자들이 변경 사항을 보게 된다.
핵심은 “실패해도 되는 공간”을 따로 둔다는 것이다. 로컬에서는 사이트를 아무리 망가뜨려도 삭제 후 재생성하면 그만이지만, 라이브 서버에서 같은 실수를 하면 실제 고객·독자가 그 오류를 그대로 마주하게 된다.
👉 이제 두 도구를 각각 실제로 어떻게 쓰는지, 탭을 눌러 확인해보자.
🌱 Local — WP Engine이 만든 워드프레스 전용 데스크톱 앱
Local(구 Local by Flywheel)은 Windows·Mac·Linux를 모두 지원하는 GUI 기반 도구다. 2021년부터 유료였던 Local Pro의 모든 기능이 전체 사용자에게 무료로 풀렸다. 워드프레스 개발에 특화되어 있어서, 사이트 하나를 만드는 과정이 마법사(wizard) 형태로 안내된다.
📥 설치와 사이트 생성
Local 설치
localwp.com에서 운영체제에 맞는 설치 파일을 내려받아 설치한다.
“+ Create a new site” 클릭
사이트 이름을 입력한다. 이 이름이 그대로 로컬 도메인(예: mysite.local)이 된다.
환경 선택 — Preferred vs Custom
대부분은 Local이 추천하는 “Preferred” 구성(최신 PHP·nginx·MySQL 조합)을 그대로 선택하면 된다. 특정 PHP 버전을 맞춰야 한다면(예: 라이브 서버와 동일한 버전) “Custom”을 선택해 PHP·웹서버·DB 버전을 각각 지정할 수 있다.
워드프레스 관리자 계정 설정
사이트 제목, 관리자 아이디·비밀번호·이메일을 입력하면 워드프레스 설치가 자동으로 끝난다.
“ADD SITE” → 완료
몇 초 후 사이트가 생성되고, “WP Admin” 버튼으로 바로 관리자 화면에, “View Site” 버튼으로 로컬 사이트 화면에 접속할 수 있다.
🔧 Local의 실무 편의 기능
| 기능 | 설명 |
|---|---|
| 사이트별 완전 격리 | 사이트마다 독립된 환경이라 여러 프로젝트를 동시에 띄워도 서로 충돌하지 않는다 |
| Live Link | 임시 공개 URL을 생성해 인터넷 어디서나 접속 가능하게 만든다 — 클라이언트에게 검수용으로 공유할 때 유용 |
| SSL 지원 | 로컬에서도 https 환경으로 테스트 가능 |
| 원클릭 DB 접근 | Adminer 등으로 데이터베이스를 바로 열어볼 수 있음 |
| Blueprint(사이트 템플릿) | 자주 쓰는 플러그인·테마 구성을 저장해뒀다가 새 사이트에 재사용 |
💻 VS Code / AI 바이브코딩과 연결하기
Local에서 사이트를 만들면, 그 사이트의 실제 파일들은 내 PC의 특정 폴더(보통 ~/Local Sites/사이트명/app/public)에 그대로 저장된다. 이 폴더를 VS Code로 열면 일반 로컬 프로젝트를 다루듯 wp-content/themes 안의 테마 파일을 자유롭게 수정할 수 있다.
Claude Code 같은 AI 코딩 도구를 이 폴더에서 실행하면, “카드 클릭 시 상세 페이지로 연결해줘” 같은 자연어 요청만으로 템플릿 파일 수정·신규 페이지 템플릿 생성까지 처리할 수 있다. 이 과정 전체가 로컬 사이트 안에서 일어나기 때문에, 결과를 즉시 브라우저로 확인하면서 몇 번이고 반복 수정해볼 수 있다.
🚀 라이브 서버로 배포
Local 자체에는 “Connect”라는 원클릭 배포 기능도 있지만(WP Engine 호스팅 대상), 그 외의 서버(Bitnami, 일반 SSH 호스팅 등)에 올릴 때는 수정된 파일만 골라 SFTP 클라이언트나 scp 명령으로 직접 전송하는 방식이 일반적이다.
⚡ Laragon — 가볍고 빠른 Windows 전용 개발 환경
Laragon은 Windows 사용자들 사이에서 특히 인기 있는 도구다. Local보다 훨씬 가볍고 실행 속도가 빠르며, PHP 버전을 자유자재로 바꿔 쓸 수 있다는 점이 강점으로 꼽힌다. 워드프레스뿐 아니라 Laravel 등 다른 PHP 프레임워크 개발에도 널리 쓰인다.
📥 설치
laragon.org에서 다운로드
Full 버전(약 170MB, Apache·MySQL·PHP 등 기본 패키지 포함)과 Portable 버전(약 38MB, 필요한 것만 나중에 추가) 중 선택. 처음이라면 Full 버전을 권장한다.
설치 옵션 체크
설치 경로(기본 C:\laragon), Windows 부팅 시 자동 시작 여부, 가상 호스트 사용 여부를 설정한다. 가상 호스트는 체크해두는 편이 편리하다.
“Start All” 클릭
Apache(또는 nginx)와 MySQL이 한 번에 구동된다.
🌐 워드프레스 사이트 원클릭 생성
Laragon 화면에서 마우스 우클릭
팝업 메뉴에서 Quick app → WordPress를 선택한다.
사이트 이름 입력
예를 들어 mysite라고 입력하고 OK. Laragon이 자동으로 워드프레스를 내려받고 DB까지 생성해 연결한다.
가상 호스트 주소로 접속
기본 규칙은 {사이트명}.test다. 즉 http://mysite.test 로 바로 접속되며, 관리자 화면은 /wp-admin을 붙이면 된다.
Laragon의 가상 호스트는 www 폴더(예: C:\laragon\www\mysite) 아래에 폴더를 하나 만드는 것만으로도 자동 생성된다. 폴더명이 곧 {폴더명}.test 주소가 되는 구조라, 이미 갖고 있는 워드프레스 소스를 통째로 이 폴더에 복사해 넣는 것만으로도 사이트를 옮겨올 수 있다.
🔀 PHP 버전 손쉽게 바꾸기
라이브 서버와 로컬의 PHP 버전을 맞춰야 할 때 특히 유용한 기능이다. 마우스 우클릭 메뉴에서 PHP → Version을 선택해 설치된 버전 중 하나를 고르면, 서버 재시작만으로 바로 전환된다. 원하는 버전이 없다면 Tools → Quick add에서 추가로 내려받을 수 있다.
🧰 함께 딸려오는 도구들
| 도구 | 용도 |
|---|---|
| phpMyAdmin | 데이터베이스를 웹 UI로 직접 조회·수정 |
| Composer | PHP 패키지 관리자, 우클릭 메뉴에서 바로 실행 가능 |
| Node.js / Yarn | 워드프레스 테마 빌드 과정에 필요한 프론트엔드 툴체인도 함께 지원 |
| Terminal (cmder 기반) | 우클릭 → Terminal로 해당 프로젝트 폴더에서 바로 명령줄 진입 |
VS Code나 Claude Code 연동 방식은 Local과 동일하다 — C:\laragon\www\사이트명 폴더를 그대로 열어서 작업하면 된다.
⚖️ Local vs Laragon — 뭘 써야 할까
| 기준 | Local | Laragon |
|---|---|---|
| 지원 OS | Windows / Mac / Linux | Windows 전용 |
| 워드프레스 특화도 | 매우 높음 (전용 마법사) | 범용 (WP는 원클릭 앱 중 하나) |
| 실행 속도·용량 | 다소 무거움 | 가볍고 빠름 |
| PHP 버전 전환 | 사이트 생성 시 지정 | 우클릭 메뉴에서 즉시 전환 |
| 비용 | 전체 기능 무료 | 무료 |
| 배포 연동 | WP Engine 호스팅과 원클릭 연동 | 없음 (수동 SFTP/Git) |
워드프레스 사이트 위주로 작업한다면 Local이 훨씬 직관적이고, 여러 개발 환경(Laravel 등)을 넘나들거나 속도·가벼움을 우선한다면 Laragon 쪽이 편하다. 둘 다 결국 하는 일은 같다 — 내 PC 안에 “실패해도 되는 서버”를 하나 마련해주는 것.
결국 이 두 도구가 하는 일을 한 문장으로 정리하면, “라이브 서버를 건드리지 않고도 마음껏 실험할 수 있는 물리적 공간을 내 컴퓨터 안에 만들어주는 것”이다. 실제 사이트 개편 작업도 이 흐름을 그대로 타고 있다 — 로컬에서 카드 클릭 → 상세 페이지 연결을 몇 번이고 테스트해보고, 화면이 마음에 들 때 비로소 실제 서버에 올리는 것. AI 바이브코딩으로 개발 속도가 빨라질수록, 이런 “안전하게 실패할 수 있는 공간”의 가치는 오히려 더 커지는 것 같다.