워드프레스 에러 내용을 확인하고 싶습니다 – Help Center

워드프레스 내부에서 소스상의 문제, 또는 서버 설정의 영향으로 에러가 발생하는 경우가 있으나 브라우저에서는 직접적으로 확인이 불가능한 경우가 있습니다.

500 에러가 발생하여 메인 페이지 또는 관리자 페이지 접근에 문제가 있는 경우 어떤 원인인지 확인 하는 절차가 필요합니다.
WP_DEBUG 설정을 통한 확인 방법과 .htaccess 파일을 통한 php 어플리케이션 처리상의 에러를 출력하는 방법을 안내 합니다.

WP_DEBUG 모드 사용 방법

FTP / SSH 프로토콜로 서버에 접속합니다.
편집기로 전역 설정 파일인 wp-config.php 파일을 엽니다.
```
# vi wp-config.php
```

WP_DEBUG 항목을 활성화 합니다.

## edit wp-config.php
define( 'WP_DEBUG', false );
>
define( 'WP_DEBUG', true );

저장후 브라우저로 에러 내용을 확인 합니다.
사용중인 테마의 functions.php 파일에 php 구문 오류가 있음을 확인 할 수 있습니다.
확인된 문제점을 수정후 홈페이지 접근에 문제가 없는지 접속해 봅니다.

FTP/SFTP, SSH, MYSQL 접속 방법은 아래 가이드 문서를 참고 바랍니다.
1. FTP / SFTP 접속 방법
2. SSH 접속 방법
3. MYSQL 접속 방법

WP_DEBUG 모드의 옵션 설정

에러 로그 남기기

wp-config.php 파일의 WP_DEBUG 설정 밑에 설정 값을 추가 합니다.
```
define('WP_DEBUG_LOG', true);
```

브라우저에서 에러 확인시 /wp-content/debug.log 경로로 에러 내용을 로깅 합니다.

# cat wp-content/debug.log 
[17-Apr-2022 07:55:09] PHP Parse error: syntax error, unexpected 'asdasdasasasd' (T_STRING) in /USERID/www/wp-content/themes/twentytwentytwo/functions.php on line 152
[17-Apr-2022 07:55:11] PHP Parse error: syntax error, unexpected 'asdasdasasasd' (T_STRING) in /USERID/www/wp-content/themes/twentytwentytwo/functions.php on line 15

true 대신 경로/파일명 입력시 해당 파일명으로 로깅 합니다.

## USERID 계정의 최상단에 error.log파일로 로깅
define('WP_DEBUG_LOG', 'USERID/error.log' );

WP_DEBUG 모드에서 에러 출력 안하기

에러 로그만 남기도록 하고 브라우저에서는 에러 출력을 하지 않습니다. 서비스중인 사이트에서 로그파일로만 확인을 원할 경우 설정 합니다.
1. wp-config.php 파일의 WP_DEBUG 설정 밑에 설정 값을 추가 합니다.
```
define( 'WP_DEBUG_DISPLAY', false )
```

WP_DEBUG 옵션은 wp-config.php 파일의 WP_DEBUG 설정 정의 밑에 추가 되어야 동작 합니다.

플러그인을 통한 디버깅도 가능합니다.
DB에서 발생하는 QUERY 모니터링을 하거나 디버깅 바를 추가하거나, 호환성 체크 로그를 생성하는등의 추가 작업이 가능한 플러그인도 참고 바랍니다.
A. Query Monitor
B. Debug Bar
C. Log Deprecated Notices

.htaccess 파일을 통해 PHP DISPLAY ERROR 활성화 시키기

워드프레스 WP_DEBUG 모드설정이 아닌 .htaccess파일을 통해서도 활성화가 가능합니다.
카페24 서버는 기본적으로 php error display 설정이 브라우저에 직접적으로 출력되지 않도록 설정되어 있습니다. 최상단 .htaccess파일에 아래 설정을 추가하여 WP_DEBUG 모드와 동일한 효과를 얻을 수 있습니다.

FTP / SSH를 통해 서버에 접속합니다.
www 폴더와 같은 위치에 있는 .htaccess 파일을 vi 편집기로 오픈합니다.
설정 값을 추가합니다.
1. php_value error_reporting 6135
  어떤 에러 유형을 리포팅할지 결정 합니다. 6135는 모든 에러 케이스에 대해 모두 로깅 하도록 합니다.
  ( https://www.php.net/manual/en/function.error-reporting.php )
2. php_flag display_errors on
  php 에러를 클라이언트 브라우저로 출력할지를 선택합니다.
3. php_flag log_errors on
  에러 로그를 로깅하도록 합니다.
4. php_value error_log /USERID/php_error.log
  에러로그가 생성될 위치/파일명을 지정 합니다.
5. 설정 후 브라우저로 에러 확인, 에러 로그 생성 여부 등을 확인 합니다.
```
## 최상단의 .htaccess파일에 설정 추가
# cat .htaccess 
php_value error_reporting 6135
php_flag display_errors on
php_flag  log_errors on
php_value error_log  /USERID/php_error.log

## php_error.log 파일을 통해 로그 확인
# cat php_error.log 
[17-Apr-2022 17:33:36] PHP Parse error: syntax error, unexpected 'aaaaaa' (T_STRING) in /USERID/www/info.php on line 2
[17-Apr-2022 17:37:08] PHP Parse error: syntax error, unexpected 'aaaaaa' (T_STRING) in /USERID/www/info.php on line 2
```

.htaccess 파일 수정상에 구문 오류나 허용되지 않는 설정을 추가하는 경우 internal server error가 발생 할 수 있습니다.
직접 수정후에는 반드시 브라우저로 서비스 정상 여부를 체크 바랍니다.

WP_DEBUG 모드 사용 방법

WP_DEBUG 모드의 옵션 설정

.htaccess 파일을 통해 PHP DISPLAY ERROR 활성화 시키기

관련 문서