LocalWP(Local by Flywheel)는 간편하게 로컬 환경에서 워드프레스를 실행할 수 있도록 도와주는 도구입니다. 초보자부터 개발자까지 쉽게 워드프레스 환경을 설정할 수 있습니다.
1. LocalWP란
LocalWP(Local by Flywheel)는 다음과 같은 장점을 갖춘 로컬 개발 환경 도구입니다.
- 간편한 설치 – PHP, MySQL, 웹 서버(Apache/Nginx)를 자동으로 구성
- 멀티사이트 지원 – 워드프레스 멀티사이트(Network) 기능을 쉽게 활성화
- HTTPS 지원 – 로컬에서도 SSL을 적용하여 보안 환경 테스트 가능
- 빠른 데이터베이스 접근 – 내장된 Adminer 또는 TablePlus를 사용해 DB관리
- 간편한 백업 및 복사 – 사이트를 쉽게 복제하고 설정을 공유할 수 있음
- Windows, macOS 지원
2. Local 설치하기
LocalWP 공식 사이트 접속, 우측 상단 DOWNLOAD 버튼을 클릭합니다.
OS를 선택하고, 설치를 진행합니다.
3. 워드프레스 사이트 생성하기
Create a new site버튼을 클릭합니다.
사이트 이름을 입력합니다.
환경 설정 선택
“Preferred”를 선택하면 LocalWP가 자동으로 최적화된 환경을 구성합니다.
“Custom”을 선택하면 PHP, 웹 서버(Apache/Nginx), 데이터베이스 버전을 직접 선택할 수 있습니다.
PHP-version: php 버전을 설정합니다.
Web Server는 Apache와 Nginx 2가지 옵션을 제공합니다.
Database는 MySql과 MariaDB 2가지 옵션을 제공합니다.
워드프레스 설정
사용자 이름 및 비밀번호를 입력하여 관리자 계정을 설정합니다.
다 입력한 후 “Add Site” 버튼을 클릭하면 설치가 완료됩니다.
4. LocalWP 개발환경 활용하기
워드프레스 대시보드 접속
LocalWP에서 방금 생성한 사이트를 선택한 후 “Open Site” 또는 “WP Admin” 버튼을 클릭하면 워드프레스 관리자 화면으로 이동할 수 있습니다.
데이터베이스 관리
LocalWP는 기본적으로 Adminer를 제공하며, DB를 쉽게 관리할 수 있습니다.
- LocalWP에서 “Database” 탭 클릭 → “Open Adminer” 버튼을 누르면 DB 관리 페이지로 이동합니다.
- 직접 SQL 쿼리를 실행하거나 데이터를 확인할 수 있습니다.
SSL 활성화 (HTTPS 적용)
Overview 탭에 “SSL” 에서 “Trust” 버튼 클릭하여 적용할 수 있습니다.
사이트 복제 및 백업
사이트를 마우스 오른쪽 클릭 → “Clone Site” 선택하면 사이트를 쉽게 복사할 수 있습니다.
사이트를 다른 개발자와 공유하려면 “Export” 기능을 사용하여 백업 가능합니다.
5. 플러그인/테마 개발 환경 세팅
LocalWP에서 워드프레스 프로젝트 폴더를 직접 열어 코드 편집이 가능합니다.
1. LocalWP에서 사이트를 선택한 후 “Go to Site Folder” 클릭
2. wp-content/themes/ 또는 wp-content/plugins/ 폴더에서 직접 개발 진행
wp-config.php 디버깅 활성화
플러그인/테마 개발 시 디버깅 기능을 활성화하면 오류 메시지를 확인할 수 있습니다.
wp-config.php 파일에서 다음 설정을 추가합니다.
define('WP_DEBUG', true); // 디버깅 활성화
define('WP_DEBUG_LOG', true); // debug.log 파일에 오류 기록
define('WP_DEBUG_DISPLAY', false); // 화면에 오류 표시 안 함
// @ini_set('display_errors', 0); // PHP 오류 메시지 출력하지 않음, 해당 옵션 사용하는 이유 PHP 오류 메시지가 브라우저 화면에 출력되지 않고, WP_DEBUG_LOG를 활성화했기 때문에 모든 오류 로그는 wp-content/debug.log 파일에 저장됩니다.이제 wp-content/debug.log 파일에서 오류 로그를 확인할 수 있습니다.