디버그 모드를 활성화하려면 WordPress 설치 내의 한 파일을 수정해야 합니다. 간단하지만, 사이트가 손상되지 않도록 주의 깊게 진행해야 합니다. 아래에서 올바르게 설정하는 단계별 방법을 확인할 수 있습니다.
활성화 후에는 오류를 기록하고, 방문자에게는 보이지 않게 하며, WordPress가 디버그 정보를 처리하는 방식을 제어할 수 있습니다. 이는 오류는 기록하되 공개적으로는 표시하고 싶지 않은 운영 중인 사이트에서 특히 중요합니다.
wp-config.php 파일 찾기
디버그 모드를 켜는 첫 번째 단계는 wp-config.php 파일을 찾는 것입니다. 이 파일은 WordPress 설치의 루트 폴더에 있으며, wp-content, wp-includes, wp-admin과 같은 위치에 있습니다. FTP 프로그램, 호스팅 제어판의 파일 관리자, 또는 개발 서버에서 작업하는 경우 로컬 접근을 통해 열 수 있습니다.
변경하기 전에 이 파일을 백업하는 것이 좋습니다. 단 하나의 누락된 문자로도 사이트가 중단될 수 있으므로, 백업을 통해 즉시 복원할 수 있습니다. 파일을 찾았다면 텍스트 편집기에서 열어 설정을 변경할 준비를 합니다.
WP_DEBUG 활성화하기
wp-config.php 파일 안에서 다음과 같은 줄을 찾으세요: define( 'WP_DEBUG', false );. 이 줄은 디버그 모드가 켜져 있는지 여부를 제어합니다. 기본적으로 WordPress는 보안과 성능상의 이유로 디버깅을 비활성화합니다. 활성화하려면 값 false를 true로 변경하면 됩니다.
올바른 줄은 다음과 같아야 합니다: define( 'WP_DEBUG', true );. 파일을 저장하면 WordPress는 즉시 사이트 전반에 걸쳐 PHP 경고, 알림 및 오류 메시지를 표시하기 시작합니다. 이를 통해 문제 있는 플러그인, 테마 또는 사용자 지정 코드를 식별할 수 있습니다.
오류 기록을 위한 WP_DEBUG_LOG 사용
화면에 오류를 표시하는 것은 개발 중에 유용할 수 있지만 항상 실용적인 것은 아닙니다. 장기적인 모니터링을 위해 WP_DEBUG_LOG를 활성화할 수 있습니다. 이를 위해 WP_DEBUG 상수 바로 아래에 다음 줄을 추가합니다: define( 'WP_DEBUG_LOG', true );. 그러면 모든 오류가 wp-content 디렉토리 내의 debug.log 파일에 저장됩니다.
로그 파일은 특정 시점에 발생하는 오류를 추적하거나 화면에서 직접 재현할 수 없는 오류를 기록할 때 특히 유용합니다. 또한 사이트에 직접 접근 권한을 부여하지 않고도 개발자나 지원 팀과 파일을 공유할 수 있습니다.
방문자에게 오류 숨기기
WordPress 사이트가 운영 중이라면 방문자가 원시 오류 메시지를 보는 것을 원하지 않을 것입니다. 이 경우 프런트엔드에서 오류 표시를 비활성화하기 위해 다음 설정을 추가할 수 있습니다: define( 'WP_DEBUG_DISPLAY', false );. 이렇게 하면 오류는 기록되지만 사용자에게는 보이지 않습니다.
또한 @ini_set( 'display_errors', 0 );를 추가하여 이 동작을 강화할 수 있습니다. 이 조합은 사이트를 전문적이고 안전하게 유지하면서 관리자와 개발자에게 필요한 정보를 디버그 로그로 제공합니다.
SCRIPT_DEBUG를 이용한 고급 디버깅
JavaScript와 CSS로 작업하는 개발자를 위해 WordPress는 추가 상수를 제공합니다: define( 'SCRIPT_DEBUG', true );. 기본적으로 WordPress는 축소된(minified) 버전의 스크립트와 스타일을 불러옵니다. 스크립트 디버깅을 활성화하면 WordPress는 전체 비축소 버전을 불러와 검토와 디버깅이 더 쉬워집니다.
이 설정은 테마나 플러그인을 개발하면서 스크립트와 스타일이 어떻게 동작하는지 추적해야 할 때 특히 유용합니다. 일반 사용자에게는 필요하지 않지만, 프런트엔드 문제를 해결하는 개발자에게는 큰 도움이 될 수 있습니다.
정리하자면, WordPress에서 디버그 모드를 활성화하는 것은 웹사이트를 진단하고 유지 관리하는 간단하면서도 강력한 방법입니다. wp-config.php 파일을 편집하면 오류를 표시하고, 로그에 저장하며, 문제 발생 시에도 사이트를 전문적으로 보이게 유지할 수 있습니다. 올바르게 사용하면 디버그 모드는 WordPress를 안전하고 안정적이며 개발자 친화적으로 유지하는 데 가장 중요한 도구 중 하나입니다.
