백업과 복원

백업에 들어가는 것

전체 수동 백업에는 코어 DB, 설치 레지스트리의 확장 테이블, 첨부·에디터·프로필 등 업로드와 설정, 확장의 영속 상태가 포함됩니다. 배포 PHP 소스와 vendor는 별도 완성 배포본으로 보관합니다. 잠금·임시 파일과 확장 런타임 캐시는 백업 대상에서 제외됩니다.

관리 화면에서 백업

설정 → 유지보수(/admin/settings/maintenance)를 엽니다.
전체 백업 만들기를 실행합니다. zip을 쓸 수 없으면 TAR 대체 형식을 사용합니다.
완료 후 파일 이름·크기·검증 결과를 확인하고 백업을 내려받습니다.
업그레이드 직전 백업과 정기 운영 백업을 구분해 보관합니다.
기존 백업을 삭제할 때는 별도 보관본이 있는지 확인합니다. 파일 삭제는 복구되지 않습니다.

CLI 백업

셸

php bin/backup.php create --format=zip
php bin/backup.php list
php bin/backup.php verify gnucms-mysql-날짜.zip

CLI는 기존 config/config.php를 사용합니다. 서버 PHP 실행 계정이 저장소를 읽고 백업 폴더에 쓸 수 있어야 합니다. 명령에 DB 비밀번호를 넣을 필요가 없습니다. 검증은 백업 형식·파일 체크섬을 확인하며 실제 서비스 복구까지 자동 보장하는 것은 아닙니다.

복원 절차

새 주문·회원 변경·외부 발송을 멈추고 진행 중 PG 승인과 예약 문자를 확인합니다.
복원할 백업과 같은 시점의 소스·vendor·사용자 테마·확장을 준비합니다.
관리 화면에서 보관 백업을 올리고 검증한 뒤 복원 대상을 확인합니다.
현재 데이터가 교체되는 것을 확인하고 복원합니다. 복원 직전 안전 백업도 보관합니다.
외부 실행 허용값·토큰 캐시를 정리하고 설정, 기존 주문과 미완료 발송을 확인한 뒤 운영합니다.