DSc T2Editor Developers
DocumentationAdministration
Administration

관리자 기능 유지보수

관리자 인증·설정·캐시·업데이트·마켓 상태의 점검과 복구 절차입니다.

관리자 기능 유지보수

점검 대상

  • admin_auth.php: 비밀번호 해시와 최초 설정 완료 상태
  • admin_settings.php: 활성 플러그인, 우선순위와 UI 설정
  • third_party_markets.php, third_party_installed.php: 마켓과 설치 소유권
  • runtime.php: 현재·이전 release 포인터와 성공 상태
  • t2pack/cache: runtime index와 locale cache
  • update·third-party backup 디렉토리

모두 기본적으로 T2EDITOR_PRIVATE_PATH 아래에 있고 직접 웹 접근이 차단되어야 한다. 권한은 디렉토리 0700을 우선하며 공유 호스팅에서는 PHP 실행 계정만 읽고 쓰게 한다.

장애 분류

  • 설정만 반영 안 됨: admin_settings.php 읽기 권한과 설정 로더 확인
  • 플러그인·번역 누락: 설치 레지스트리와 runtime index 확인 후 캐시 재생성
  • 업데이트 직후 흰 화면: pending runtime shutdown guard와 이전 포인터 확인
  • 마켓 제거 실패: 설치 소유권과 대상 경로가 수동 파일과 충돌하는지 확인
  • 로그인 문제: 세션 쿠키, HTTPS, 비밀번호 파일과 서버 시간 확인

복구 원칙

비공개 상태 파일을 텍스트 편집기로 부분 수정하지 않는다. 검증된 백업을 복원하거나 관리자 API의 reset·rollback 경로를 사용한다. 캐시는 언제든 다시 만들 수 있지만 설치 레지스트리와 실제 파일은 한 쌍이므로 한쪽만 복구하지 않는다.

기술 기준

T2Editor 10.4.0을 기반으로 작성되었으며, 동일한 구조와 계약을 유지하는 이후 버전에도 적용됩니다.

T2Editor 홈으로