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

LuisK
LuisK
Sep 16, 2019 · 10 min read

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

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

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

시작하기 전에

포트확인

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

환경 구성하기

PHP 다운로드 / 설치

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

PHP 다운로드

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

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

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

그 이후 환경변수 등록을 해야 합니다.
Windows10 기준으로 하여 환경변수를 아래와 같이 추가합니다.

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

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

date.timezone = Asia/Seoul
extension_dir = "C:\php\ext" #해당 dir주소는 꼭 내 php위치로!

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

extension=bz2
extension=curl
extension=fileinfo
extension=gd2
extension=gettext
;extension=gmp
extension=intl
;extension=imap
;extension=interbase
;extension=ldap
extension=mbstring
;extension=exif ; Must be after mbstring as it depends on it
extension=mysqli
;extension=oci8_12c ; Use with Oracle Database 12c Instant Client
;extension=odbc
extension=openssl
;extension=pdo_firebird
extension=pdo_mysql
;extension=pdo_oci
;extension=pdo_odbc
extension=pdo_pgsql
extension=pdo_sqlite
;extension=pgsql
;extension=shmop

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

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 기반 프로젝트를 빠르게 로컬 개발 환경에서 서비스할수 있도록 하는 프로그램입니다.

파워쉘에서 명령어를 실행합니다.

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

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

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

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

문구가 나온다면 성공!

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

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

에서 DNS 설정을 할 수 있습니다.

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

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

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

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

Valet용 Laravel 설치

파워쉘에서 명령어를 입력하여 발렛용 라라벨을 설치합니다.

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

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

중요!

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

그 이후 web과 같은 프로젝트 root 폴더에서 명령어를 실행하여 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 를 선택합니다.

아래와 같이 데이터베이스를 만들었다면, 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…

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store