워드프레스 입문자나 배경 지식이 상대적으로 부족할 때, 테마나 플러그인 설치 또는 특정한 작업 시 오류가 발생하면 원인을 파악하기 어려울 때가 있습니다. 워드프레스는 PHP 에러, 경고 메시지, 워드프레스 시스템 오류 메시지 등을 볼 수 있는 기능(상수)을 제공합니다.
워드프레스 오류 메시지 출력 설정
워드프레스 wp-config.php 파일을 열어 보면 다음 1번 줄 코드처럼 오류를 사이트에 출력하지 않도록 기본 설정되어 있습니다.
define( 'WP_DEBUG', false );
/* That's all, stop editing! Happy blogging. */다음으로 변경하면 오류가 있을 때 사이트에 출력합니다. 물론, 관리페이지에도 나옵니다.
define( 'WP_DEBUG', true);
/* That's all, stop editing! Happy blogging. */사이트 공개 전 구성할 때 위와 같은 설정은 기본 사항입니다. 그런데, 사이트를 운영하고 있을 때 내부적으로 발생하는 오류를 알고 싶을 때가 있습니다.
파일에서 오류 로그 확인
다음 코드는 워드프레스 사이트에 오류 메시지를 출력하지 않고, 파일에 저장하는 설정입니다.
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true ); // /wp-content/debug.log 파일이 자동 생성됨
define( 'WP_DEBUG_DISPLAY', false ); // 디버그 모드를 사용하지만, 오류 메시지를 출력하지 않음
@ini_set( 'display_errors', 0 ); // 활성화하지 않아도 대부분 문제가 없음
/* That's all, stop editing! Happy blogging. */위의 코드에서 6번 줄은 wp-config.php 파일에서 위의 6번 줄과 같은 코멘트 위에 추가하라는 뜻으로 코덱스에서 안내하는 것이므로 따르면 됩니다.
이렇게 설정하면 오류 발생 시 로그와 함께 wp-content/debug.log 파일이 생성됩니다. 편집기나 FTP 애플리케이션으로 원격 저장소에 접근하고 확인하여 파일이 있다면 오류 로그가 있다는 것입니다.
로그를 확인하여 문제를 해결했다면 파일은 그대로 두거나 삭제하면 됩니다. 되도록 삭제하는 것이 좋습니다. 그리고 wp-config.php 파일의 설정은 초기 상태로 돌려야 합니다.
저장소 플러그인을 설치하여 사용하고 있다면, 많은 메시지가 로그 파일에 기록될 수 있습니다. 대부분 경고나 알림의 오류 레벨 메시지로 사이트 작동이나 특정 기능에 문제가 없다면 무시해도 됩니다. 물론, 오류가 나지 않는 플러그인으로 대체하는 것이 더 좋습니다.
정리
워드프레스 사이트의 오류 메시지와 특정 정보를 출력하여 사이트 구성과 개선에 도움을 주는 플러그인은 많습니다. ‘Debug’ 키워드로 검색하면 쉽게 찾을 수 있습니다. 모든 플러그인의 기능을 알 수 없지만, 반복해서 알리는 다음 설정일 때 사용 가능한 플러그인이 대부분이므로 기억해야 합니다.
define( 'WP_DEBUG', true);
/* That's all, stop editing! Happy blogging. */이 포스트 내용 정도의 코드 추가는 프로그래밍 지식 보유 여부나 수준에 관련이 없으므로 무작정 멀리하면 조금 더 유연한 워드프레스 사용이 어렵습니다.