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

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

최근 수정 시각: 2026년 10월 17일 (토) 20:58
< XpressEngine
주시 편집 토론 문서 역사
← 이전 편집
시각위키텍스트
Gaon12 (토론 / 기여)
4,667 편집
m 순번 제거
Gaon12 (토론 / 기여)
4,667 편집
라이믹스 2.1.34 공식 쉬운 설치 반영, XE1·XE3 구분과 백업·오류 진단 연결
 
(같은 사용자의 중간 판 하나는 보이지 않습니다)
1번째 줄: 1번째 줄:
{{인용문|XE 코어는 쉬운설치로 업데이트하지 마세요|기진곰,
== 개요 ==
[https://xetown.com/topics/11553 XE 코어는 쉬운설치로 업데이트하지 마세요]}}
'''쉬운 설치'''는 관리자 화면에서 확장 기능을 내려받아 설치·업데이트하는 기능이다. [[XpressEngine|XE1]], [[라이믹스]], [[XpressEngine 3|XE3]]는 배포 체계가 다르므로 같은 안내를 적용해서는 안 된다.


==이 기능은==
{| class="wikitable"
[[XpressEngine]]에 있는 기능으로, XE 공식 홈페이지에 있는 자료실에 있는 애드온/모듈 등을 클릭으로 설치 할 수 있다.
! 대상 !! 자료와 설치 방식
|-
| XE1 || XE1 자료실과 기존 쉬운 설치 체계. 오래된 자료는 PHP 및 코어 호환성을 별도로 확인
|-
| 라이믹스 2.1.34 이상 || 공식 자료실과 연동되는 쉬운 설치 지원. 대상 자료·쓰기 권한 등 조건 있음
|-
| XE3 || 플러그인과 Composer 기반 의존성 관리. XE1 쉬운 설치 모듈과 별개
|}


FTP를 사용하지 않고 웹성에서 클릭만으로 쉽게 설치 할 수 있지만 쉬운설치 기능을 권장하지는 않는다. 그 이유는 아래에서 알아보자.
== 라이믹스 공식 쉬운 설치 ==
2026년 6월 26일 공개된 [[라이믹스/릴리즈 노트/2.1.34|2.1.34]]부터 공식 자료실의 대상 자료를 관리자 화면에서 설치할 수 있다.<ref name="official">[https://rhymix.org/news/1948052 라이믹스 공식: 쉬운설치 지원을 시작합니다.]</ref> 따라서 라이믹스에서 쉬운 설치를 사용하려면 반드시 [[Rhymix Auto Install Repository]]를 설치해야 한다는 과거 안내는 현재의 공식 기능에 적용되지 않는다.


==권장하지 않는 이유==
공식 도입 공지의 조건은 공개 무료 자료, 릴리즈 시스템으로 등록·변환된 자료, 일정한 설치 경로 등이다. 테마 패키지와 기타 분류는 도입 당시 대상에서 제외됐다. 개별 자료의 현재 지원 표시는 자료실에서 확인한다. 도입 공지의 코어 업데이트·유료 자료 지원은 '''향후 계획'''으로 제시된 내용이므로, 서드파티 쉬운 설치와 혼동하지 않는다.
===서버 불안정===
XE 자료실 서버가 불안정하기 때문에 파일 누락이 일어 날 수 있다. 특히 웹서버가 해외에 있는 경우에는 자료실 서버에서 가져올 때 파일 누락이 있을 수 있다.


해외 서버 뿐만 아니라 국내 서버에서도 가끔씩 오류가 날 수 있다.
신규 배포가 즉시 목록에 보이지 않을 수 있다. 공식 공지에서는 API·중간 캐시·사이트 자체 갱신을 합쳐 최대 약 4시간 30분이 걸릴 수 있다고 설명한다.<ref name="official" />


===퍼미션 오류===
== 설치·업데이트 전후 점검 ==
보통의 웹 호스팅에서는 xe가 설치된 부모 폴더가 아닌 files 폴더에 퍼미션을 777로 두기 때문에 별도의 폴더가 있는 애드온/모듈 등은 꼬일 수 있다.
# [[라이믹스/매뉴얼/백업과 복원|파일과 DB를 함께 백업]]한다. 직접 수정한 스킨이나 소스는 업데이트로 덮어써질 수 있다.
# 제작자, 변경 기록, 필요한 PHP·코어 버전, 의존 자료를 확인한다. 공식 자료실의 배포 여부만으로 코드의 안전성이 보장되지는 않는다.
# 시험 환경에서 설치하고 설치·DB 업데이트 안내를 처리한다.
# 캐시를 정리한 뒤 로그인·권한·글쓰기·파일 업로드·모바일 화면을 확인한다.


거기다가 코어 파일은... 말을 하지 않아도 상상이 가지요?
코어 업데이트는 [[라이믹스/매뉴얼/라이믹스 업데이트]]의 절차와 해당 릴리즈 공지를 따른다. 쉬운 설치 화면에 표시된 서드파티 업데이트와 코어 업데이트를 구별한다.
===오토 로드===
1.8.3 이후에 오토 로드 기능이 추가 되었는데, 코어를 쉬운 설치로 업그레이드시 특정 클래스만 최신이고 나머지 파일은 예전 버전이 될 수도 있다.


물론 오토 로드로 인해 다른 애드온/모듈 등의 설치가 더 빨라졌긴 했지만 말이다.
== 오류가 발생할 때 ==
* '''자료가 목록에 없음''': 대상 자료 여부와 갱신 간격을 확인한다. 지원하지 않는 자료는 제작자의 수동 설치 절차를 따른다.
* '''파일을 쓸 수 없음''': 실제 설치 경로의 소유자·그룹·쓰기 권한을 점검한다. 모든 경로를 일괄적으로 777로 변경하지 않는다.
* '''설치 후 오류''': [[라이믹스/매뉴얼/서드파티 자료 호환성 체크리스트|호환성]], 의존성, 오류 로그를 확인하고 필요하면 직전 파일·DB 백업으로 함께 복구한다.
* '''전송·압축 해제 실패''': 서버의 외부 HTTPS 연결과 PHP 확장 기능, 디스크 여유 공간을 확인한다. [[라이믹스/매뉴얼/업로드 오류와 서버 진단]] 참고.


==결국==
== 관련 문서 ==
특히 코어 파일은 FTP로 덮어 쓰거나 git을 이용해 업데이트를 하자. 코어 파일이 손상되면 접속이 불가능 할 수도 있다.
* [[XpressEngine/모듈]] · [[XpressEngine/애드온]]
* [[라이믹스/매뉴얼/확장 기능 보안 점검]]
* [[라이믹스/매뉴얼/설치 환경]] · [[라이믹스/매뉴얼/라이믹스 업데이트]]


애드온/모듈 등도 왠만하면 FTP로 사용하자. 쉬운 설치 기능 존재를 기억속에서 없애고 FTP로 업로드 하는 것을 일상화 하자.
== 출처 ==
<references />
* [https://github.com/xpressengine/xe-core XE1 공식 저장소]
* [https://github.com/xpressengine/xpressengine XE3 공식 저장소]
 
{| class="wikitable" style="width:100%"
! colspan="2" | [[XpressEngine]] · [[XpressEngine 3]] · [[라이믹스]]
|-
! 확장 기능
| [[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"

최근 바뀜

더 보기