Windows 환경에서 valet + XE3 설치하기

LuisK
LuisK
Sep 16 · 10 min read

#그 무엇보다 쉬워요, 같이 설치하는 valet + XE3 for windows.

모든지 개발 서버가 있다면 좋지만, 그렇지 못한 경우가 있을 수 있습니다.
그렇다고 사비를 들여 언제 쓸지도 모르는, 장시간 사용하지 않는 개발 서버를 위해서 한달에 몇만원을 사용하기에는 또 아까운 느낌이 들기도 하죠.

Windows 환경에서 간단히 개발 환경을 설정하기 위한 방법과, XE3를 사용하는 방법을 공유합니다.

시작하기 전에

포트확인

가장먼저 80번 포트가 사용되는 곳은 없는지 확인 해야 합니다.
Windows powershell을 열어netstat -ano 명령어를 사용하여 80번 포트에 바인딩된 프로세스가 있는지 확인 합니다.
만약, 바인딩 된 프로세스가 있다면, 해당 작업을 저장 & 백업하고 kill -9 PID 를 실행하여 해당 프로세스를 종료해줍니다.

환경 구성하기

PHP 다운로드 / 설치

현재 설치되어 있는 Windows의 비트수에 맞는 php를 다운로드 합니다.
일반적으로는 4GB이상의 램(메모리)를 사용하고 있는 PC라면 64비트를 사용합니다.

PHP 다운로드

파일은 source code가 아닌 VC** x(64 or 32)의 네이밍이 되어 있는 파일을 다운로드 받아야 합니다.
예) VC15 x64 Non Thread Safe

그 이후 개발하기 편한 개발 디렉토리에 PHP를 업로드 합니다.
C:\php 에 업로드 하면 더욱 관리하기 편해집니다.

꼭 이 경로가 아니어도 되지만, 추후 안내하는 경로에서는 PHP를 옮겨놓은 디렉토리로 바꿔주세요 :)

그 이후 환경변수 등록을 해야 합니다.
Windows10 기준으로 탐색기 > 내 PC(우클릭) > 속성 > 고급 시스템 설정 > 환경 변수(N) 클릭 하여 환경변수를 아래와 같이 추가합니다.

환경 변수 설정이 끝났다면, php 폴더에 들어가 php.ini-development 파일을 복사하여 php.ini 로 만들어줍니다.

그리고 아래의 변경사항을 반영해줍니다.

그리고 하단의 extension 을 아래를 복사 붙여넣기 해줍니다.

저장하고 파워쉘 에서php -m 명령어를 실행해 모듈이 잘 불러와지는지 확인합니다.

PHP Modules가 정상적으로 출력되는 모습.

Composer 다운로드 / 설치

XE3를 사용하기 위해서는 composer가 설치되어 있어야 합니다.
여기를 클릭해 composer를 다운로드 받고 아까 다운로드 받아 옮겨두었던 php의 위치를 지정하여 설치해줍니다.

셀렉트 박스를 클릭하여 올바른 php위치를 선택해주세요 :)

설치 이후 파워쉘에서 composer 명령어가 작동하는지 확인합니다.
만약 작동하지 않거나 찾을 수 없는 명령어라고 나오는 경우 재부팅을 해줍시다.

만약, Composer 설치 이후 파워쉘에서 작동하지 않는다면 재부팅 하면 OK!

MariaDB 다운로드 / 설치

이제 거의 다 왔습니다. XE3를 설치하고 게시판 등의 데이터를 저장하기 위한 MariaDB는 여기를 클릭해서 .msi 으로 된 설치형 파일을 다운로드 하여 설치해줍니다.

root패스워드를 입력하고, 하단의 Service Name을 꼭 MySQL로 바꿔줍니다.

root 계정의 패스워드를 입력하고, 확인해줍니다.
원래 Service Name은 MariaDB지만, MySQL로 변경하여 설치해줍니다.

Valet 다운로드 / 설치

드디어 막바지인 Valet을 설치할 차례입니다.
Valet은 PHP 기반 프로젝트를 빠르게 로컬 개발 환경에서 서비스할수 있도록 하는 프로그램입니다.

파워쉘에서 composer global require cretueusebiu/valet-windows 명령어를 실행합니다.

명령어를 실행하고 모두 완료된 모습

맨 하단에 초록색 글자와 함께 설치가 끝나면 정상적으로 설치된 것입니다.
그 이후 %APPDATA%\Roaming\Composer\vendor\bin 경로로 가면 valet 명령어가 모여있습니다. 이를 path 환경 변수에 등록해줍니다.

Valet 명령어가 모여있는 bin폴더.

이제 파워쉘을 관리자 권한으로 실행한 뒤 valet install 명령어를 실행하여 valet을 인스톨합니다.

Valet installed successfully! 문구가 나온다면 성공!

.test 도메인으로 연결하기 위한 DNS 설정

IPv4 설정을 바꿀경우 외부와의 연결이 되지 않습니다.
현재는 많이 사용하지 않는 IPv6 의 설정만으로 .test 도메인으로 접속할 수 있게끔 합니다.

Windows 설정 > 네트워크 및 인터넷 > 어댑터 옵션 변경 > 이더넷 우클릭 > 속성 에서 DNS 설정을 할 수 있습니다.

인터넷 프로토콜 버전 6(TC/IPv6)를 우클릭하여 속성을 눌러 아래처럼 설정해줍니다.

꼭 다음 DNS 서버 주소 사용을 클릭 후 설정해주세요 :)

기본 DNS 서버 주소를 ::1 로 바꾼 다음 확인 버튼을 누르면 끝!

이 작업이 진행되지 않는다면, valet laralvel 을 설치하더라도 접속할 수 없습니다.

Valet용 Laravel 설치

파워쉘에서 composer global require "laravel/installer" 명령어를 입력하여 발렛용 라라벨을 설치합니다.

그 이후, 내가 관리하기 편한 디렉토리로 이동하여 새로운 프로젝트를 만듭니다. 프로젝트를 만드는 명령어는 laravel new 프로젝트명 으로 만들 수 있습니다.

새로운 프로젝트를 만드는 모습

중요!

꼭 프로젝트는 바탕화면 등이 아닌 바탕화면\web과 같은 폴더여야 오류가 나지 않습니다.

그 이후 web과 같은 프로젝트 root 폴더에서 valet park 명령어를 실행하여 Park Path 설정하면 끝!

아까 만든 프로젝트명.test 를 입력하여 웹 브라우저에서 접속이 된다면 끝 개발 환경 구성 끝!

테스트로 만든 x3.test 도메인으로 접속한 결과 성공! 기본 세팅시 laralvel 디폴트 페이지가 세팅됩니다.

XE3 설치 및 구성

XE3 Core 다운로드

XE3는 공식 홈페이지( https://www.xpressengine.io/) 에서 다운로드 할 수 있으며, 방금 만든 프로젝트의 폴더로 압축을 풀어 올려놓으면 설치 준비 끝!

DB 사용자 설정

DB를 사용하려면 root계정에 db를 만들어주어야 합니다.
터미널은 너무 어려울 수 있으니, 조금 더 쉬운 adminer를 다운로드 받아, 적절한 이름 (db.php 또는 dbdb.php) 으로 바꿔줍니다.

프로젝트명.test/db.php 와 같이 변경한 파일명으로 접속하여 root계정으로 로그인 합니다.

Adminer에서 root 계정으로 로그인 하는 모습.

데이터베이스 선택창에서 데이터베이스 만들기 를 클릭합니다.

그 이후 원하는 DB이름으로 이름을 지은 다음 오른쪽의 utf8mb4_general_ci 를 선택하여 저장합니다.

게시판 제목 또는 내용의 이모지 지원을 위해서 utf8mb4_general_ci 를 선택합니다.

아래와 같이 데이터베이스를 만들었다면, DB 설정도 끝!

축하드려요! 성공적으로 데이터베이스를 만들었습니다!

XE3 설치

DB사용자 설정까지 해주었다면, 이제 XE3를 본격적으로 설치할 때입니다.
웹 프로젝트 폴더로 이동하여 기본 생성된 라라벨 파일들을 모두 삭제합니다.

프로젝트 폴더에 있는 기본 파일들을 컨트롤 + A를 눌러 전체 선택한 다음 삭제해주세요.

그 이후 XE3 최신 버전을 다운로드 받아 압축 해제하여 프로젝트 폴더에 옮겨줍니다.

프로젝트명.test로 접속한 다음 XE3 공식 홈페이지의 매뉴얼의 내용중 “최신버전 다운로드 (웹/FTP 환경)” 항목을 참고하여 설치하면 끝!

Windows 환경에서는 테스트하거나 개발하기 위한 개발환경을 만들기가 까다롭다는 이야기들이 많았습니다.

이 개발팁 공유를 통해 많은 창작자 분들이 XE3로 더 멋진 프로젝트를 이어나갈 수 있도록 응원하겠습니다.

지금 까지 Windows 환경에서 Valet + XE3 개발환경 만들기에 대해서 알아보았습니다!

창작자를 위한 XE 플러그인 장터가 준비되어 있어요!
XE Store 바로가기

XE 공식 홈페이지 바로가기
XE CAMPUS 바로가기

XEHub

Stories and tips for XE, the best platform for web page building.

LuisK

Written by

LuisK

Content Director At XEHub

XEHub

XEHub

Stories and tips for XE, the best platform for web page building.

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade