자주자주 공지를 확인하세요!

XpressEngine/쉬운 설치: 두 판 사이의 차이

최근 수정 시각: 2026년 10월 17일 (토) 20:58
< XpressEngine
주시 편집 토론 문서 역사
← 이전 편집
시각위키텍스트
Gaon12 (토론 / 기여)
4,665 편집
비권장 내용, 커스텀 자료실 연동 등 추가
Gaon12 (토론 / 기여)
4,665 편집
라이믹스 2.1.34 공식 쉬운 설치 반영, XE1·XE3 구분과 백업·오류 진단 연결
 
1번째 줄: 1번째 줄:
{{인용문|XE 코어는 쉬운설치로 업데이트하지 마세요|기진곰,
== 개요 ==
[https://xetown.com/topics/11553 XE 코어는 쉬운설치로 업데이트하지 마세요]}}
'''쉬운 설치'''는 관리자 화면에서 확장 기능을 내려받아 설치·업데이트하는 기능이다. [[XpressEngine|XE1]], [[라이믹스]], [[XpressEngine 3|XE3]]는 배포 체계가 다르므로 같은 안내를 적용해서는 안 된다.
 
{| class="wikitable"
! 대상 !! 자료와 설치 방식
|-
| XE1 || XE1 자료실과 기존 쉬운 설치 체계. 오래된 자료는 PHP 및 코어 호환성을 별도로 확인
|-
| 라이믹스 2.1.34 이상 || 공식 자료실과 연동되는 쉬운 설치 지원. 대상 자료·쓰기 권한 등 조건 있음
|-
| XE3 || 플러그인과 Composer 기반 의존성 관리. XE1 쉬운 설치 모듈과 별개
|}
 
== 라이믹스 공식 쉬운 설치 ==
2026년 6월 26일 공개된 [[라이믹스/릴리즈 노트/2.1.34|2.1.34]]부터 공식 자료실의 대상 자료를 관리자 화면에서 설치할 수 있다.<ref name="official">[https://rhymix.org/news/1948052 라이믹스 공식: 쉬운설치 지원을 시작합니다.]</ref> 따라서 라이믹스에서 쉬운 설치를 사용하려면 반드시 [[Rhymix Auto Install Repository]]를 설치해야 한다는 과거 안내는 현재의 공식 기능에 적용되지 않는다.


== 개요 ==
공식 도입 공지의 조건은 공개 무료 자료, 릴리즈 시스템으로 등록·변환된 자료, 일정한 설치 경로 등이다. 테마 패키지와 기타 분류는 도입 당시 대상에서 제외됐다. 개별 자료의 현재 지원 표시는 자료실에서 확인한다. 도입 공지의 코어 업데이트·유료 자료 지원은 '''향후 계획'''으로 제시된 내용이므로, 서드파티 쉬운 설치와 혼동하지 않는다.
쉬운설치 기능은 [[XpressEngine]] 및 라이믹스에서 제공하는 도구로, FTP 프로그램 없이 웹 브라우저의 클릭만으로 애드온, 모듈, 위젯 등을 설치, 업데이트, 삭제할 수 있는 기능입니다. 다만, 현재는 기본 설정 상태에서는 쉬운설치 페이지에 아무런 내용도 표시되지 않으며, 이는 [[Rhymix Auto Install Repository]]와 같은 별도의 쉬운설치 서버를 연동해야 정상적으로 사용이 가능합니다.


다만 [[라이믹스]] 개발진들은 쉬운설치의 사용을 [https://rhymix.org/qna/1455526#comment_1455577 권장하지] [https://rhymix.org/qna/1455526#comment_1455596 않습니다.]
신규 배포가 즉시 목록에 보이지 않을 수 있다. 공식 공지에서는 API·중간 캐시·사이트 자체 갱신을 합쳐 최대 약 4시간 30분이 걸릴 수 있다고 설명한다.<ref name="official" />


== 문제점 및 주의사항 ==
== 설치·업데이트 전후 점검 ==
=== 서버 불안정 문제(구 XE 저장소) ===
# [[라이믹스/매뉴얼/백업과 복원|파일과 DB를 함께 백업]]한다. 직접 수정한 스킨이나 소스는 업데이트로 덮어써질 수 있다.
XE 자료실 서버가 불안정할 경우 파일 누락이나 업데이트 중 오류가 발생할 수 있습니다. 특히 웹서버가 해외에 위치한 경우, 자료실 서버에서 파일을 가져오는 도중 누락이 발생할 가능성이 있으며, 국내 서버에서도 가끔씩 오류가 발생할 수 있습니다.
# 제작자, 변경 기록, 필요한 PHP·코어 버전, 의존 자료를 확인한다. 공식 자료실의 배포 여부만으로 코드의 안전성이 보장되지는 않는다.
# 시험 환경에서 설치하고 설치·DB 업데이트 안내를 처리한다.
# 캐시를 정리한 뒤 로그인·권한·글쓰기·파일 업로드·모바일 화면을 확인한다.


=== 퍼미션(권한) 오류 ===
코어 업데이트는 [[라이믹스/매뉴얼/라이믹스 업데이트]]의 절차와 해당 릴리즈 공지를 따른다. 쉬운 설치 화면에 표시된 서드파티 업데이트와 코어 업데이트를 구별한다.
일반적인 웹호스팅 환경에서는 xe가 설치된 부모 폴더는 제한된 권한을 가지며, files 폴더만 777 권한으로 설정되어 있는 경우가 많습니다. 이로 인해 애드온, 모듈, 위젯 등 별도의 폴더에 위치하는 파일들이 퍼미션 문제로 정상적으로 설치되지 않거나 동작에 문제가 생길 수 있습니다. 특히 수많은 코어 파일에서 하나라도 권한 오류가 발생하면 사이트 접속 불능 등의 치명적인 문제가 발생할 위험이 있습니다.


=== 오토 로드 문제 ===
== 오류가 발생할 때 ==
XE 1.8.3 버전부터 도입된 오토 로드 기능은 필요할 때마다 클래스를 자동으로 로딩하는 기능입니다. 그러나 쉬운설치로 코어 파일을 업데이트할 경우, 이미 메모리에 로딩된 클래스는 이전 버전으로 남고 아직 로딩되지 않은 클래스만 새 버전으로 덮어써지게 되어, 두 버전이 혼재하는 상황이 발생할 수 있습니다. 이로 인해 런타임 시 버전 불일치로 인한 오류가 발생할 가능성이 있습니다.
* '''자료가 목록에 없음''': 대상 자료 여부와 갱신 간격을 확인한다. 지원하지 않는 자료는 제작자의 수동 설치 절차를 따른다.
* '''파일을 쓸 수 없음''': 실제 설치 경로의 소유자·그룹·쓰기 권한을 점검한다. 모든 경로를 일괄적으로 777로 변경하지 않는다.
* '''설치 후 오류''': [[라이믹스/매뉴얼/서드파티 자료 호환성 체크리스트|호환성]], 의존성, 오류 로그를 확인하고 필요하면 직전 파일·DB 백업으로 함께 복구한다.
* '''전송·압축 해제 실패''': 서버의 외부 HTTPS 연결과 PHP 확장 기능, 디스크 여유 공간을 확인한다. [[라이믹스/매뉴얼/업로드 오류와 서버 진단]] 참고.


=== FTP 업데이트 대비 위험성 ===
== 관련 문서 ==
쉬운설치는 FTP 정보를 입력해 자동으로 업데이트를 수행하지만, 파일 수가 매우 많고 각 파일에 대해 개별 오류 처리가 미흡한 경우 한 파일이라도 에러가 발생하면 이전 버전과 새 버전의 파일이 혼재되어 사이트가 심각하게 망가질 위험이 있습니다.
* [[XpressEngine/모듈]] · [[XpressEngine/애드온]]
* [[라이믹스/매뉴얼/확장 기능 보안 점검]]
* [[라이믹스/매뉴얼/설치 환경]] · [[라이믹스/매뉴얼/라이믹스 업데이트]]


=== 워드프레스 플러그인 설치와의 비교 ===
== 출처 ==
워드프레스는 플러그인들이 하나의 전용 폴더 내에서 관리되므로 설치, 업데이트, 삭제 작업이 상대적으로 간편하고 안정적입니다. 반면, XE/라이믹스는 애드온, 모듈, 위젯 등이 각기 다른 루트 폴더에 분산되어 있어 퍼미션 설정이나 경로 관리 등의 문제가 발생하기 쉽습니다. 이 구조적 차이로 인해 XE의 쉬운설치 기능은 워드프레스의 플러그인 설치 방식에 비해 오류 발생 가능성이 높습니다.
<references />
* [https://github.com/xpressengine/xe-core XE1 공식 저장소]
* [https://github.com/xpressengine/xpressengine XE3 공식 저장소]


== 라이믹스용 커스텀 자료실 연동 ==
{| class="wikitable" style="width:100%"
라이믹스 1.9.9.9 이상 버전<에서는 관리자 페이지 > 고급 > 쉬운설치 > 설정 메뉴를 통해 커스텀 자료실 연동이 지원됩니다. 대표적인 예로 [[Rhymix Auto Install Repository]]가 있으며, 이 기능을 활성화하면 기본 쉬운설치 페이지에 자료가 정상적으로 노출되어 애드온, 모듈 등의 설치가 가능해집니다.
! colspan="2" | [[XpressEngine]] · [[XpressEngine 3]] · [[라이믹스]]
|-
! 확장 기능
| [[XpressEngine/모듈|모듈]] · [[XpressEngine/애드온|애드온]] · [[XpressEngine/쉬운 설치|쉬운 설치]] · [[라이믹스/매뉴얼/서드파티 자료 호환성 체크리스트|호환성 점검]]
|}


<!-- 분류 -->
[[분류:XpressEngine]]
[[분류:XpressEngine]] [[분류:라이믹스]]
[[분류:라이믹스/매뉴얼/사이트 운영|쉬운 설치]]

2026년 10월 17일 (토) 20:58 기준 최신판

개요[편집 / 원본 편집]

쉬운 설치는 관리자 화면에서 확장 기능을 내려받아 설치·업데이트하는 기능이다. XE1, 라이믹스, XE3는 배포 체계가 다르므로 같은 안내를 적용해서는 안 된다.

대상 자료와 설치 방식
XE1 XE1 자료실과 기존 쉬운 설치 체계. 오래된 자료는 PHP 및 코어 호환성을 별도로 확인
라이믹스 2.1.34 이상 공식 자료실과 연동되는 쉬운 설치 지원. 대상 자료·쓰기 권한 등 조건 있음
XE3 플러그인과 Composer 기반 의존성 관리. XE1 쉬운 설치 모듈과 별개

라이믹스 공식 쉬운 설치[편집 / 원본 편집]

2026년 6월 26일 공개된 2.1.34부터 공식 자료실의 대상 자료를 관리자 화면에서 설치할 수 있다.[1] 따라서 라이믹스에서 쉬운 설치를 사용하려면 반드시 Rhymix Auto Install Repository를 설치해야 한다는 과거 안내는 현재의 공식 기능에 적용되지 않는다.

공식 도입 공지의 조건은 공개 무료 자료, 릴리즈 시스템으로 등록·변환된 자료, 일정한 설치 경로 등이다. 테마 패키지와 기타 분류는 도입 당시 대상에서 제외됐다. 개별 자료의 현재 지원 표시는 자료실에서 확인한다. 도입 공지의 코어 업데이트·유료 자료 지원은 향후 계획으로 제시된 내용이므로, 서드파티 쉬운 설치와 혼동하지 않는다.

신규 배포가 즉시 목록에 보이지 않을 수 있다. 공식 공지에서는 API·중간 캐시·사이트 자체 갱신을 합쳐 최대 약 4시간 30분이 걸릴 수 있다고 설명한다.[1]

설치·업데이트 전후 점검[편집 / 원본 편집]

  1. 파일과 DB를 함께 백업한다. 직접 수정한 스킨이나 소스는 업데이트로 덮어써질 수 있다.
  2. 제작자, 변경 기록, 필요한 PHP·코어 버전, 의존 자료를 확인한다. 공식 자료실의 배포 여부만으로 코드의 안전성이 보장되지는 않는다.
  3. 시험 환경에서 설치하고 설치·DB 업데이트 안내를 처리한다.
  4. 캐시를 정리한 뒤 로그인·권한·글쓰기·파일 업로드·모바일 화면을 확인한다.

코어 업데이트는 라이믹스/매뉴얼/라이믹스 업데이트의 절차와 해당 릴리즈 공지를 따른다. 쉬운 설치 화면에 표시된 서드파티 업데이트와 코어 업데이트를 구별한다.

오류가 발생할 때[편집 / 원본 편집]

  • 자료가 목록에 없음: 대상 자료 여부와 갱신 간격을 확인한다. 지원하지 않는 자료는 제작자의 수동 설치 절차를 따른다.
  • 파일을 쓸 수 없음: 실제 설치 경로의 소유자·그룹·쓰기 권한을 점검한다. 모든 경로를 일괄적으로 777로 변경하지 않는다.
  • 설치 후 오류: 호환성, 의존성, 오류 로그를 확인하고 필요하면 직전 파일·DB 백업으로 함께 복구한다.
  • 전송·압축 해제 실패: 서버의 외부 HTTPS 연결과 PHP 확장 기능, 디스크 여유 공간을 확인한다. 라이믹스/매뉴얼/업로드 오류와 서버 진단 참고.

관련 문서[편집 / 원본 편집]

출처[편집 / 원본 편집]

  1. ↑ 1.0 1.1 라이믹스 공식: 쉬운설치 지원을 시작합니다.
XpressEngine · XpressEngine 3 · 라이믹스
확장 기능 모듈 · 애드온 · 쉬운 설치 · 호환성 점검
원본 주소 "https://www.gaonwiki.com/w/index.php?title=XpressEngine/쉬운_설치&oldid=109813"

최근 바뀜

더 보기