디버깅

디버깅¶

디버그 모드 설정¶

Rhymix/XE에서 개발 중 문제가 발생했을 때 디버그 모드를 활성화하여 상세한 오류 정보를 확인할 수 있습니다.

설정 방법¶

/config/config.user.inc.php 파일에 다음 코드를 추가합니다:

<?php
// 디버그 모드 활성화
define('__DEBUG__', 1);

// 디버그 출력 레벨 설정 (0: 없음, 1: 파일, 2: 화면)
define('__DEBUG_OUTPUT__', 2);

// 특정 IP에서만 디버그 정보 표시 (보안상 권장)
define('__DEBUG_PROTECT__', '123.456.789.0');
?>

디버그 레벨 옵션¶

• __DEBUG__: 디버그 모드 on/off
• 0: 비활성화 (기본값)

• 1: 활성화

• __DEBUG_OUTPUT__: 디버그 정보 출력 위치

• 0: 출력하지 않음
• 1: 파일로 저장 (files/_debug/ 디렉토리)

• 2: 화면에 직접 출력

• __DEBUG_PROTECT__: 보안 설정

• IP 주소 지정 시 해당 IP에서만 디버그 정보 표시
• 운영 서버에서는 반드시 설정 권장

주의사항¶

1. 성능 영향: 디버그 모드 활성화 시 CSS/JS minify 기능이 비활성화되어 성능이 저하될 수 있습니다.

2. 보안 주의: 운영 서버에서는 절대 디버그 모드를 활성화하지 마세요. 민감한 정보가 노출될 수 있습니다.

3. 파일 권한: 파일로 디버그 정보를 저장할 경우 files/_debug/ 디렉토리에 쓰기 권한이 필요합니다.

일반적인 디버깅 방법¶

1. 변수 확인¶

// Rhymix 디버그 함수
debug('변수 내용 확인');
debugPrint($variable);

// XE 레거시
debugPrint($variable, $title = null);

2. 쿼리 디버깅¶

// 쿼리 실행 전 디버그 모드 설정
$output = executeQuery('module.getModuleInfo', $args);
if (!$output->toBool()) {
    debugPrint($output);
}

3. 에러 로그 확인¶

에러 로그는 다음 위치에서 확인할 수 있습니다:
- PHP 에러 로그: 서버 설정에 따라 다름
- Rhymix 에러 로그: files/_debug/ 디렉토리

4. 브라우저 개발자 도구 활용¶

• F12를 눌러 개발자 도구 열기
• Console 탭에서 JavaScript 에러 확인
• Network 탭에서 요청/응답 확인

문제 해결 팁¶

1. 화면이 백지로 나올 때
   - 디버그 모드를 활성화하여 에러 확인
   - PHP 에러 로그 확인
   - 파일 권한 문제 확인

2. 쿼리가 실행되지 않을 때
   - XML 쿼리 파일 문법 확인
   - 테이블명, 컬럼명 확인
   - 조건절 문법 확인

3. 모듈이 작동하지 않을 때
   - 모듈 설치 상태 확인
   - 권한 설정 확인
   - 캐시 파일 삭제 (files/cache/)

유용한 디버깅 도구¶

• XE/Rhymix Profiler: 실행 시간, 메모리 사용량, 쿼리 분석
• Xdebug: PHP 디버깅 확장
• Chrome DevTools: 프론트엔드 디버깅
• Postman: API 테스트