게시물이 늘어날수록 홈페이지속도는 점점느려지고 게시물을 지워도 에디터로 올린이미지는 잘 삭제되지 않습니다.

이를 개선하기 위해 이미지 클리너를 플러그인 형태로 개발하여 올려드리오니 많은 다운로드 해주세요.

이미지클리너를 실행하는 순간 당신의 홈페이지 속도는 빨라집니다.

[주요 기능]
1) Dry-run 분석
- 실제 삭제 없이 고아 이미지 개수/용량/목록을 먼저 확인
- CSV/JSON 리포트 자동 생성

2) 안전 정리
- 즉시 삭제하지 않고 data/_trash 배치 폴더로 이동
- 서비스 점검 후 선택적으로 최종 삭제 가능

3) 복구 가능 구조
- 휴지통 경로를 유지하므로 경로 단위 복구가 쉬움
- 운영 중 문제 시 빠른 롤백 가능

4) 게시물 참조 정밀 분석
- 첨부파일 + 에디터 본문 img src 동시 수집
- 프로토콜/도메인 차이를 정규화해 참조 판정

5) 운영 옵션
- 최근 N일 파일 보존
- thumb-* 썸네일 캐시 제외
- 댓글 이미지 포함/제외 선택

[지원 환경]
- 그누보드5 순정
- 아미나빌더(APMS) 기반 사이트
- PHP 5.6 이상

[권장 사용 순서]
1. mode=dry 실행 후 리포트 검토
2. keep_days 옵션 보정
3. mode=move로 휴지통 이동
4. 사이트 확인 후 휴지통 정리

[주의사항]
- 실행 전 전체 백업(파일+DB)을 권장합니다.
- 초회 실행은 일부 게시판 대상으로 테스트 후 전체 적용하세요.

# Image Cleaner PRO 설치 가이드

## 1. 설치 전 확인
- PHP 버전: `5.6 이상` (7.x, 8.x 지원)
- 그누보드5 관리자(super) 계정 접근 가능
- `data` 디렉토리 쓰기 권한 확인
- 설치 전 파일/DB 백업 권장

## 2. 파일 업로드
배포 압축 해제 후 아래 경로가 유지되도록 업로드합니다.

- `plugin/imgcleaner/*`
실제 서버 기준으로는 `plugin/imgcleaner/` 폴더가 사이트 루트 하위에 위치해야 합니다.

## 3. 설치 실행
브라우저에서 아래 주소를 호출합니다.

- `/plugin/imgcleaner/install.php`

동작:
- 필수 테이블 생성
- 기본 설정값 입력
- 설치 완료 후 관리자 페이지로 이동

## 4. 업데이트 실행(기존 버전 사용 중일 때)
버전 업그레이드 시 아래 주소를 호출합니다.

- `/plugin/imgcleaner/update.php`

동작:
- 신규 컬럼/구조 반영
- 기존 설정/데이터 유지

## 5. 관리자 화면 진입
아래 파일을 관리자 메뉴 또는 바로가기로 연결합니다.

- `/plugin/imgcleaner/adm/imgcleaner_admin.php`

## 6. 최초 실행 권장 순서
1) `Dry-run` 실행  
2) 리포트(JSON/CSV) 확인  
3) 제외 규칙/보존일(`keep_days`) 조정  
4) `휴지통 이동` 실행  
5) 사이트 점검 후 휴지통 정리

## 7. 자주 발생하는 문제

### 7-1. 설치 페이지에서 권한 오류
- super 관리자 로그인 여부 확인
- 파일/폴더 권한 확인

### 7-2. 정리 실행 시 엔진 없음 메시지
- `lib/apms.image.cleanup.lib.php` 존재 여부 확인
- 해당 라이브러리가 없으면 본문/첨부 분석 엔진을 먼저 배포해야 함

### 7-3. PHP 8에서 경고 노출
- 템플릿 최신본(`compat.php` 포함)으로 교체
- 운영환경 `display_errors` 비활성화 권장

## 8. 롤백
- 정리 작업은 즉시 삭제가 아닌 휴지통 이동 방식입니다.
- `data/_trash/.../data/*`를 원래 `data/*`로 되돌리면 복구됩니다.