설치하기

서버 요구사항

XE를 설치하기 위해서는 아래의 요구사항이 만족되어야 합니다.

  • 웹서버(apache, nginx 등)
  • PHP 5.5.9 이상
    • OpenSSL PHP Extension
    • PDO PHP Extension
    • Mbstring PHP Extension
    • Tokenizer PHP Extension
    • GD PHP Extension
    • FileInfo PHP Extension
  • MariaDB or MySQL 5.1 이상
  • 터미널 접속 환경
  • 디스크 300M 이상의 여유 공간
    • 500M 이상 권장

알려진 문제점

  • Cafe24 10G 광아우토반 FullSSD 웹 호스팅 서비스에서 UTF-8 (PHP7.0, mariadb-10.0.x) 옵션만 지원합니다. 10G 광아우토반 FullSSD의 다른 옵션을 신청했을 경우 XE3는 정상 동작하지 않을 수 있습니다.
  • 닷홈 무제한 웹호스팅 서비스에서 PHP7.0 만 지원합니다. 그 외의 버전은 지원하지 않습니다.
  • 고도 호스팅 리눅스 웹 호스팅 서비스에서 UTF8(Mysql5.5) PHP7.0에 테스트 었으며 Apache 설정 이슈로 정상동작 되지 않습니다. 문제 해결을 위해서 배포되는 .htaccess 파일의 하단에 아래 내용을 추가해야 합니다.
php_value default_charset UTF-8
<IfModule mod_url.c>
CheckURL On
ServerEncoding UTF-8
</IfModule>

인스톨러를 이용한 설치

Linux

터미널에서 아래와 같이 명령어를 실행합니다.

$ php -r "copy('http://start.xpressengine.io/download/installer', 'installer');" && php installer install

NOTE: 일부 호스팅 환경에서 작동이 안 될 수 있습니다. 작동이 안 될 경우, 아래 명령어를 실행해보시기 바랍니다.

$ php -d display_errors=1 -d error_reporting=-1 -d allow_url_fopen=1 -r "copy('http://start.xpressengine.io/download/installer', 'installer');" && php installer install

Window

Git 설치
터미널 환경을 위해 Git을 설치합니다. Git(준비중) 다운로드 및 설치를 참고하세요

Git-Bash를 실행하고 아래와 같이 명령어를 실행합니다.

$ php -r "copy('http://start.xpressengine.io/download/installer', 'installer');" && php installer install

위 명령어를 실행하면 설치가 시작됩니다. 안내에 따라 설치 정보를 입력하십시오.

Git 을 이용한 설치

Git을 사용하면 업데이트및 현재 개발중인 코드를 손쉽게 적용할 수 있습니다.
코어 버전 업데이트할 때 FTP 없이 Git 을 통해 업데이트 할 수 있습니다.

Github 저장소 파일을 이용해 설치합니다

$ git clone https://github.com/xpressengine/xpressengine.git
$ cd xpressengine
$ composer install
...
$ php artisan xe:install
...

위 명령어를 실행하면 설치가 시작됩니다. 안내에 따라 설치 정보를 입력하십시오.

설치 정보 입력

1. 데이터베이스, 사이트 정보 입력

인스톨러 캡쳐 이미지(database, site 정보 입력 / 엔터)
인스톨러는 Database에 필요한 테이블을 생성하고, 기본적인 설정 파일을 생성합니다. 이 작업은 시간이 오래 걸릴 수 있습니다.

  • Host [localhost] : Database 주소. 기본 localhost
  • Port [3306] : Database prot. 기본 3306
  • Database name : Database name
  • UserId [root] : Database user id. 기본 root
  • Password [] : Database user password
  • site url [http://mysite.com] : 홈페이지 주소 입력.

    하위 디렉토리에 설치 할 경우 하위 디렉토리까지 입력해야 합니다.

  • Timezone [Asia/Seoul] : 타임존 정보를 입력합니다. 기본 Asia/Seoul

    타임존 에서 원하는 지역의 시간대를 입력하세요.

  • locale [] : 언어를 입력합니다. 영어, 한국어 두가지 언어를 지원합니다.

    다른 언어의 설치는 인스톨 후에 언어팩을 업로드해서 사용가능합니다. RC 버전에서 지원할 예정입니다.

2. 관리자 정보 입력

인스톨러 캡쳐 이미지(관리자 정보 입력)

  • Email : 관리자 이메일
  • Name [admin] : 관리자 이름. 기본 admin
  • Password : 관리자 비밀번호
  • Password again : 관리자 비밀번호 확인

3. 디렉토리 권한 및 서버 정보 수집 동의

인스톨러 캡쳐 이미지(설정)

  • ./storage directory permission [0707] : /storage 디렉토리 권한 설정. 기본 0707
  • ./bootstrap/cache directory permission [0707] : /bootstrap/cache 디렉토리 권한 설정. 기본 0707
  • Do you agree to collect your system environmental information? [yes] : 서버 환경 정보 수집 동의. 기본 yes

    더나은 서비스 제공을 위해 설치된 서버의 환경을 수집하고 있습니다. 서버, 웹서버, PHP, Database 등의 정보를 수집합니다.

설정 파일을 이용한 설치

설정파일을 사용하면 더욱 쉽게 설치할 수 있습니다. 설치하기 전에 아래와 같이 커맨드를 실행하여 설정파일을 생성합니다.

$ php -r "copy('http://start.xpressengine.io/download/installer', 'installer');" && php installer make

xe_install_config.yaml 파일이 생성됩니다. 파일을 열고 설치 정보를 입력하세요.
설치 커맨드를 실행합니다. --config 및 --no-interact 옵션을 사용하십시오.

$ php installer install --config=.xe_install_config.yaml --no-interact

설치옵션

  • --config=< configfile> 설정파일을 지정합니다.
  • --no-interact 대화형입력을 사용하지 않고 설정파일의 정보를 사용하여 자동으로 설치합니다. 이 옵션을 --config옵션과 같이 사용해야 합니다.
  • --install-dir 설치경로를 지정합니다. 지정하지 않을 경우 현재 디렉토리에 설치합니다.

웹 인스톨러로 설치하기

Composer나 Console 접속을 어려워하는 사용자를 위해 웹 브라우져에서 설치할 수 있도록 웹 인스톨러를 제공합니다.

웹 인스톨러로 설치 후 사이트 운영에서 권한관련 문제가 발생할 수 있습니다.

설치 동영상

이해를 돕기 위해 설치 영상을 마련했습니다. 바로가기

FileZila

FTP는 FileZila 를 사용해서 설명합니다. FileZila 는 무료로 사용이 가능한 프로그램 입니다. 다운로드

설치 파일 다운로드

디렉토리 권한 설정

웹 서버가 파일을 쓸 수 있도록 권한을 설정합니다.

권한 설정할 때 하위 디렉터리로 이동, 모든 파일과 디렉터리에 적용 을 반드시 체크해 주세요.

  1. bootstrap/cache 디렉토리 권한 설정
  2. config/production 디렉토리 권한 설정
  3. plugins 디렉토리 권한 설정
  4. storage 디렉토리 권한 설정
  5. vendor 디렉토리 권한 설정
  6. composer.lock 파일 권한 설정

웹 인스톨러 실행

설치할 사이트에 접속하면 인스톨 화면으로 이동됩니다.

만약 하위 디렉토리에 설치할 경우는 해당 디렉토리로 접속해 주세요.

알려진 문제점

  • FTP의 파일 업로드 오류

    파일 업로드 및 디렉토리 설정을 완료하고 웹 인스톨러 접근할 때 오류가 발생하는 경우가 있습니다. 이 문제는 FTP 파일 업로드 중 누락된 있어 발생할 수 있는 문제 입니다.
    해결하기 위해서 FTP로 다시 업로드 해야합니다. 동일 조건을 업로드할 경우 비슷한 오류가 계속해서 발생할 수 잇으므로 중복파일 건너뛰기 옵션으로 업로드 해보는걸 권장합니다.
    이미지

  • 웹 서버 타임아웃

    서버 성능에 따라 웹 서버 타임아웃 설정에 의해 설치에 실패할 가능성이 있습니다. 이 문제는 웹서버 설정을 변경해야하는 아주 복잡한 문제 입니다.

윈도우 개발환경

영상보기

results matching ""

    No results matching ""