#그 무엇보다 쉬워요, 같이 설치하는 valet + XE3 for windows.
모든지 개발 서버가 있다면 좋지만, 그렇지 못한 경우가 있을 수 있습니다.
그렇다고 사비를 들여 언제 쓸지도 모르는, 장시간 사용하지 않는 개발 서버를 위해서 한달에 몇만원을 사용하기에는 또 아까운 느낌이 들기도 하죠.
Windows 환경에서 간단히 개발 환경을 설정하기 위한 방법과, XE3를 사용하는 방법을 공유합니다.
시작하기 전에
포트확인
가장먼저 80번 포트가 사용되는 곳은 없는지 확인 해야 합니다.
Windows powershell을 열어netstat -ano 명령어를 사용하여 80번 포트에 바인딩된 프로세스가 있는지 확인 합니다.
만약, 바인딩 된 프로세스가 있다면, 해당 작업을 저장 & 백업하고 kill -9 PID 를 실행하여 해당 프로세스를 종료해줍니다.
환경 구성하기
PHP 다운로드 / 설치
현재 설치되어 있는 Windows의 비트수에 맞는 php를 다운로드 합니다.
일반적으로는 4GB이상의 램(메모리)를 사용하고 있는 PC라면 64비트를 사용합니다.
파일은 source code가 아닌 VC** x(64 or 32)의 네이밍이 되어 있는 파일을 다운로드 받아야 합니다.
예) VC15 x64 Non Thread Safe
그 이후 개발하기 편한 개발 디렉토리에 PHP를 업로드 합니다.C:\php 에 업로드 하면 더욱 관리하기 편해집니다.
그 이후 환경변수 등록을 해야 합니다.
Windows10 기준으로 탐색기 > 내 PC(우클릭) > 속성 > 고급 시스템 설정 > 환경 변수(N) 클릭 하여 환경변수를 아래와 같이 추가합니다.
환경 변수 설정이 끝났다면, php 폴더에 들어가 php.ini-development 파일을 복사하여 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 -m 명령어를 실행해 모듈이 잘 불러와지는지 확인합니다.
Composer 다운로드 / 설치
XE3를 사용하기 위해서는 composer가 설치되어 있어야 합니다.
여기를 클릭해 composer를 다운로드 받고 아까 다운로드 받아 옮겨두었던 php의 위치를 지정하여 설치해줍니다.
설치 이후 파워쉘에서 composer 명령어가 작동하는지 확인합니다.
만약 작동하지 않거나 찾을 수 없는 명령어라고 나오는 경우 재부팅을 해줍시다.
MariaDB 다운로드 / 설치
이제 거의 다 왔습니다. XE3를 설치하고 게시판 등의 데이터를 저장하기 위한 MariaDB는 여기를 클릭해서 .msi 으로 된 설치형 파일을 다운로드 하여 설치해줍니다.
root패스워드를 입력하고, 하단의 Service Name을 꼭 MySQL로 바꿔줍니다.
Valet 다운로드 / 설치
드디어 막바지인 Valet을 설치할 차례입니다.
Valet은 PHP 기반 프로젝트를 빠르게 로컬 개발 환경에서 서비스할수 있도록 하는 프로그램입니다.
파워쉘에서 composer global require cretueusebiu/valet-windows 명령어를 실행합니다.
맨 하단에 초록색 글자와 함께 설치가 끝나면 정상적으로 설치된 것입니다.
그 이후 %APPDATA%\Roaming\Composer\vendor\bin 경로로 가면 valet 명령어가 모여있습니다. 이를 path 환경 변수에 등록해줍니다.
이제 파워쉘을 관리자 권한으로 실행한 뒤 valet install 명령어를 실행하여 valet을 인스톨합니다.
Valet installed successfully! 문구가 나온다면 성공!
.test 도메인으로 연결하기 위한 DNS 설정
IPv4 설정을 바꿀경우 외부와의 연결이 되지 않습니다.
현재는 많이 사용하지 않는 IPv6 의 설정만으로 .test 도메인으로 접속할 수 있게끔 합니다.
Windows 설정 > 네트워크 및 인터넷 > 어댑터 옵션 변경 > 이더넷 우클릭 > 속성 에서 DNS 설정을 할 수 있습니다.
인터넷 프로토콜 버전 6(TC/IPv6)를 우클릭하여 속성을 눌러 아래처럼 설정해줍니다.
기본 DNS 서버 주소를 ::1 로 바꾼 다음 확인 버튼을 누르면 끝!
이 작업이 진행되지 않는다면, valet laralvel 을 설치하더라도 접속할 수 없습니다.
Valet용 Laravel 설치
파워쉘에서 composer global require "laravel/installer" 명령어를 입력하여 발렛용 라라벨을 설치합니다.
그 이후, 내가 관리하기 편한 디렉토리로 이동하여 새로운 프로젝트를 만듭니다. 프로젝트를 만드는 명령어는 laravel new 프로젝트명 으로 만들 수 있습니다.
중요!
꼭 프로젝트는 바탕화면 등이 아닌 바탕화면\web과 같은 폴더여야 오류가 나지 않습니다.
그 이후 web과 같은 프로젝트 root 폴더에서 valet park 명령어를 실행하여 Park Path 설정하면 끝!
아까 만든 프로젝트명.test 를 입력하여 웹 브라우저에서 접속이 된다면 끝 개발 환경 구성 끝!
XE3 설치 및 구성
XE3 Core 다운로드
XE3는 공식 홈페이지( https://www.xpressengine.io/) 에서 다운로드 할 수 있으며, 방금 만든 프로젝트의 폴더로 압축을 풀어 올려놓으면 설치 준비 끝!
DB 사용자 설정
DB를 사용하려면 root계정에 db를 만들어주어야 합니다.
터미널은 너무 어려울 수 있으니, 조금 더 쉬운 adminer를 다운로드 받아, 적절한 이름 (db.php 또는 dbdb.php) 으로 바꿔줍니다.
프로젝트명.test/db.php 와 같이 변경한 파일명으로 접속하여 root계정으로 로그인 합니다.
데이터베이스 선택창에서 데이터베이스 만들기 를 클릭합니다.
그 이후 원하는 DB이름으로 이름을 지은 다음 오른쪽의 utf8mb4_general_ci 를 선택하여 저장합니다.
아래와 같이 데이터베이스를 만들었다면, DB 설정도 끝!
XE3 설치
DB사용자 설정까지 해주었다면, 이제 XE3를 본격적으로 설치할 때입니다.
웹 프로젝트 폴더로 이동하여 기본 생성된 라라벨 파일들을 모두 삭제합니다.
그 이후 XE3 최신 버전을 다운로드 받아 압축 해제하여 프로젝트 폴더에 옮겨줍니다.
프로젝트명.test로 접속한 다음 XE3 공식 홈페이지의 매뉴얼의 내용중 “최신버전 다운로드 (웹/FTP 환경)” 항목을 참고하여 설치하면 끝!
Windows 환경에서는 테스트하거나 개발하기 위한 개발환경을 만들기가 까다롭다는 이야기들이 많았습니다.
이 개발팁 공유를 통해 많은 창작자 분들이 XE3로 더 멋진 프로젝트를 이어나갈 수 있도록 응원하겠습니다.
지금 까지 Windows 환경에서 Valet + XE3 개발환경 만들기에 대해서 알아보았습니다!
창작자를 위한 XE 플러그인 장터가 준비되어 있어요!
XE Store 바로가기
