WP_DEBUG 설정 도구

운영 중인 사이트를 망가뜨리지 않고 디버그 로그 켜기

브라우저 안에서 돌아갑니다. 아무것도 업로드되지 않습니다.

Where is this site?

This changes the recommendation, not just the wording. The safe configuration on a live site is genuinely different from the useful one on your laptop.

Live site Local / staging

Verdict

—

Options

WP_DEBUG — turn debugging onMakes WordPress report PHP notices, warnings and deprecations it would otherwise swallow. WP_DEBUG_LOG — write to a fileErrors go to wp-content/debug.log instead of the screen. This is the constant that makes debugging on a live site safe. WP_DEBUG_DISPLAY false — hide errors from visitorsWithout this, WP_DEBUG prints PHP errors into your pages. Turning it off is the single most important line on this page. Write the log outside the web rootwp-content/debug.log is publicly readable on many hosts — anyone can just fetch it. Moving it above the web root fixes that. Adjust the path to match your server. SAVEQUERIES — log every database queryUseful for hunting a slow page. Costs memory on EVERY request, so turn it off again afterwards. SCRIPT_DEBUG — load unminified core JS/CSSOnly useful if you are debugging the block editor or core scripts.

wp-config.php

Paste these ABOVE the line that says /* That's all, stop editing! */ — anything below it is ignored, which is why so many people report that WP_DEBUG 'does nothing'.

WP_DEBUG 설정 도구 소개

오류를 방문자에게 그대로 노출하는 대신 로그 파일에 기록하는 WP_DEBUG 상수를 생성합니다. 대부분의 사이트가 복사해 쓰는 기본 WP_DEBUG 스니펫은 PHP 오류를 공개적으로 표시하지만, 이 도구가 만든 코드는 그렇지 않습니다.

필요할 만한 다른 도구

WordPress PHP 치명적 오류 해독기

오류를 붙여넣으세요. 원인 플러그인을 알려드립니다.

wp-config.php 생성기

2014년 블로그 글에서 복사·붙여넣기 하지 않고도 올바른 wp-config.php 만들기

FAQ

질문

운영 중인 사이트에서 WP_DEBUG를 켜도 안전한가요?

WP_DEBUG_DISPLAY를 false로 설정했을 때만요. WP_DEBUG는 혼자서는 PHP 알림과 경고를 — 서버의 절대 파일 경로를 포함해 — 방문자가 여는 페이지에 그대로 출력합니다. 거의 모든 튜토리얼이 그 한 줄만 던져주고 끝냅니다. WP_DEBUG_LOG와 WP_DEBUG_DISPLAY false를 함께 짝지으면 안전합니다.

워드프레스 디버그 로그는 어디에 저장되나요?

기본적으로 wp-content/debug.log입니다. 알아둘 점: 많은 호스트에서 그 파일은 공개적으로 가져올 수 있습니다 — 누구나 브라우저에서 요청할 수 있죠. WP_DEBUG_LOG에 경로를 넘겨서 웹 루트 위에 로그를 쓸 수도 있는데, 이 도구가 그것을 생성해 드립니다.

WP_DEBUG를 true로 설정했는데 아무 일도 없었습니다. 왜죠?

거의 항상 그 상수가 wp-config.php에서 "That's all, stop editing!"라고 적힌 줄 아래에 추가되었기 때문입니다. 그 줄 뒤의 모든 것은 무시됩니다. 위로 옮기세요.