메뉴 건너뛰기

Help Center

안녕하세요, XE 헬프센터입니다.
무엇이 궁금하신가요?

설치하기(5)

5개의 도움말이 있습니다.

  • 플러그인을 설치하는데 문제가 발생했어요, 어떻게 해야 하나요?

    플러그인을 설치하는 도중 생기는 문제는 다양합니다.
    하지만, 아래의 몇가지 사항에 해당된다면, 간단한 점검을 통해 해결할 수 있습니다.

    composer.lock 파일에 접근할 권한이 없다는 메시지를 확인하는 경우,
    일부 폴더에 대한 제대로 된 파일 권한, 또는 부모 폴더에 대한 권한이 제대로 제공되지 않은 상태에서 플러그인을 설치할 경우 마주할 수 있는 에러메시지입니다.
    /storage 아래 하위폴더, 파일과, composer.lock 파일, /plugins, /vendor 폴더의 권한에 707이 부여되어 있는지 확인 후, FTP에서 해당 설정을 한 후 재시도 해보시기 바랍니다.

     

    open_basedir restriction in effect 에러 메시지를 확인하는 경우 &
    COMPOSER_HOME environment variable must be set for composer to run correctly 를 확인하는 경우,

    설치에 필요한 Composer의 홈 디렉토리 설정이 잘못되었을때 나오는 에러 메시지 입니다.
    관리자 사이트에서 설정 > 기본설정 > Composer 홈 디렉토리 항목에서 기본 XE3의 컴포저 경로를 입력하거나, 별도로 설치한 Composer가 있는 경우 해당 디렉토리 항목을 입력 후 재 시도 해보시기 바랍니다.

     

    Class 'Phar' not found 에러 메시지를 확인하는 경우,
    플러그인 설치시에 composer.phar를 사용하게 됩니다.
    PHP 모듈중 하나인 phar를 로드할 수 없을때 생기는 문제입니다.

    이 문제를 해결하기 위해서는 서버 관리자 또는 호스팅사에 'php phar extension'의 활성화를 요청해야 합니다.

     

    Your requirements could not be resolved to an installable set of packages 를 확인하는경우,
    설치에 필요한 XE3 코어의 버전이 잘못되었을때 나오는 에러 메시지 입니다.
    XE3의 업데이트를 시도하시거나, 플러그인 제작자에게 버전 업데이트를 요청해야합니다.

     

    cURL error 6: Could not resolve host 를 확인하는경우,
    설치할때 접속하는 store의 주소가 예전버전이거나, DNS등 기타 이유로 인해 서버를 찾지 못하는 문제입니다.
    에러로그를 확인하여 연결되는 주소가 올바른지, DNS 등의 이유로 차단된 것은 아닌지 확인해야 합니다.

  • 설치를 진행중에 문제가 발생했어요, 어떻게 해결할 수 있나요?

    SQLSTATE[42000] 에러가 확인되는 경우,
     

    XE3 3.0.1 배포 이후 이모지 지원을 위해 Mysql의 Charset이 UTF8MB4로 변경되었습니다.
    mysql 또는 MaraiDB 구 버전에서 index길이의 문제가 발생될 수 있습니다.
    설치시 문제가 있는 경우 mysql 설정파일(my.cnf) 에 다음 옵션을 추가 후 재시작하여 주시기 바랍니다.

    innodb_file_format=barracuda 
    innodb_large_prefix=on

    기존 utf8 을 그대로 사용하고자 하는 경우에는
    app/Console/Commands/XeInstall.php 파일에 501, 502 라인을 다음 내용으로 변경 후 설치하시기 바랍니다.
    'charset' => 'utf8', 'collation' => 'utf8_unicode_ci',

     

     

    Base table or view already exists: 1050 에러가 확인되는 경우,

    이미 한번 XE3를 설치하였거나, 설치 실패가 누적되는 경우 이미 설치 진행중 쌓여있는 데이터가 있어 생기는 문제입니다.
    한번 XE3를 설치하여 사용해보신 경우, prefix를 변경하여 설치해주시면 정상적으로 진행할 수 있습니다.

    그리고, 한번도 사용하지 않았으며, 설치 실패 누적으로 인한 경우, DB에서 xe3_ 로 시작하는 prefix의 데이터를 삭제해주시기 바랍니다.

  • 설치를 시작하지 못하고 있어요, 어떻게 해결할 수 있나요?

    SQLSTATE[28000] 에러가 확인되는 경우,

    입력한 DB사용자의 이름이 올바르지 않거나, 패스워드가 정확하지 않은 경우 입니다.
    호스팅을 사용하는 경우 호스팅사 또는 담당자로부터 전달받은 사용자 아이디와 패스워드를 이용하여 DB계정 접속을 시도해보세요.
    만약 그래도 해결되지 않는다면, 호스팅사 또는 담당자에게 문의해주세요.

     

    도메인 접속시(사이트 접속시) 흰 화면의 HTTP 500(프로그래밍 에러)가 확인되는 경우,

    디렉토리 권한에 문제가 있습니다.
    bootstrap/cache, config/production, storage, vendor, plugins 각각의 폴더들을 707로 권한을 변경해주세요. 
    변경하는 방법은 XE3 가이드의 디렉토리 권한 설정 항목에 있습니다.

  • XE3의 요구 사양은 어떻게 되나요?

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

     

    • 웹서버(apache, nginx 등)

    • PHP 7 이상(XE3.0.0-beta.24 부터)

      • PDO PHP Extension

      • cURL PHP Extension

      • FileInfo PHP Extension

      • GD PHP Extension

      • Mbstring PHP Extension

      • OpenSSL PHP Extension

      • Zip PHP Extension

    • MariaDB or MySQL 5.1 이상

    • 터미널 접속 환경

    • 디스크 300M 이상의 여유 공간

      • 500M 이상 권장

  • XE3를 설치하기 위해 준비해야 하는 것들에는 무엇이 있나요?

    XE3를 선택해주셔서 감사합니다.
    XE3를 사용하기 위해서는 아래의 항목들이 필요합니다.

     

    가급적 사이트의 안정적인 운영과 관리를 위해 다소 여유로운 용량과 트래픽을 가진 플랜으로 이용해주시기 바랍니다.
    일부 호스팅사의 환경에서는 XE3가 설치되지 않거나, 정상작동 하지 않을 수 있습니다.
    호스팅사를 통해 이용 가능 여부를 미리 확인해보시기 바랍니다.

원하시는 답변을 찾지 못하셨다면, Q&A에 문의하여 주세요.

Q&A 문의하기