일반적인 WordPress 문제를 디버깅하는 방법

게시 됨: 2023-01-25

WordPress는 매우 안정적인 CMS 시스템이며 대부분의 경우 문제 없이 작동합니다. 그러나 다용도로 인해 경우에 따라 문제가 발생할 수 있습니다. 이는 여러 가지 이유로 발생할 수 있으므로 문제 해결 및 디버깅이 매우 중요합니다. 다행스럽게도 WordPress에는 작업을 훨씬 쉽게 해주는 필수 도구가 기본 제공됩니다.

이 기사에서는 많은 WordPress 관리자와 웹 사이트 소유자가 직면할 수 있는 가장 일반적인 문제를 살펴보기 전에 WordPress 디버깅 도구를 살펴봅니다. 그런 다음 즉시 백업하고 실행할 수 있도록 원인과 수정 사항을 살펴보겠습니다.

디버깅이란 무엇입니까?

이름에서 알 수 있듯이 디버깅은 소프트웨어 코드에서 버그를 식별하고 제거하는 프로세스입니다. 전부는 아니더라도 대부분의 소프트웨어 개발자는 코드를 실행할 때 일상적으로 실행되는 코드 디버깅을 발견하게 될 것입니다.

그러나 코드가 품질 보증 검사를 통과하더라도 소프트웨어가 설치된 후 새로운 버그가 나타날 수 있습니다.

이는 개발자가 테스트하지 않은 환경에 설치된 소프트웨어를 포함하여 다양한 이유로 발생할 수 있습니다. 소프트웨어 개발자와 테스터가 가능한 모든 환경에서 코드를 테스트하는 것은 불가능합니다. 어떤 소프트웨어도 출시되지 않을 것입니다. 이에 대한 자세한 내용은 이 문서의 뒷부분에서 살펴보겠습니다.

이러한 경우 웹 사이트 관리자와 소유자는 개발자가 문제를 식별하는 데 도움이 되도록 약간의 디버깅을 수행해야 할 수 있습니다. 너무 기술적인 것처럼 들릴 수 있지만 실제로는 매우 쉽습니다. 걱정하지 마세요. 이 기사에서는 방법을 보여줍니다.

버그란 무엇입니까?

버그는 소프트웨어의 예상치 못한 동작입니다. 이 예기치 않은 동작은 오류, 예외, 경고 등을 포함하여 다양한 방식으로 나타날 수 있습니다. 또한 기능과 기능이 예상대로 작동하지 않을 수도 있습니다.

이런 일이 발생하면 소프트웨어(이 경우 WordPress)를 디버깅해야 합니다. 다행스럽게도 WordPress에는 WP_DEBUG라는 디버깅 도구가 바로 제공됩니다.

WordPress 디버깅 – WP_DEBUG 및 WP_DEBUG_LOG

WP_DEBUG는 내장된 WordPress 디버깅 도구입니다. 활성화되면 WordPress를 지원하는 기본 기술인 PHP 코드에서 생성된 모든 오류, 경고 및 알림을 표시합니다.

반면 WP_DEBUG_LOG는 이러한 오류, 경고 및 알림을 로그 파일에 저장하여 타사와 더 쉽게 공유할 수 있도록 합니다. 이것은 WordPress 활동 로그와 매우 다르지만 소프트웨어가 수행하는 모든 작업을 기록하여 개발자가 작동 중인 코드 요소를 식별하는 데 도움을 줍니다.

WP_DEBUG 사용 방법

WP_Debug는 사용하기 매우 쉽고 간단합니다. WordPress 파일 시스템 디렉토리에 대한 SFTP 또는 SSH 액세스 권한이 필요하므로 이를 가지고 있는지 확실하지 않은 경우 호스팅 제공업체에 문의하는 것이 좋습니다.

이제 설정이 텍스트 파일에 있으므로 텍스트 편집기를 사용하여 설정해야 합니다. 좋은 소식은 이 작업이 WordPress 설치의 루트 디렉터리에 있는 wp-config.php 파일에서 수행되어 매우 쉽게 찾을 수 있다는 것입니다.

찾고 있는 설정은 WP_DEBUG라고 하며 아래와 같이 true로 설정해야 합니다.

// WP_DEBUG 모드 활성화
정의( 'WP_DEBUG', 참 );

로깅을 활성화하려면 다음과 같이 WP_DEBUG_LOG 옵션을 활성화해야 합니다.

// /wp-content/debug.log 파일에 대한 디버그 로깅 활성화
정의( 'WP_DEBUG_LOG', 참 );

WP_DEBUG_LOG 옵션을 사용할 수 없는 경우 명령을 복사하여 wp-config.php 파일에 붙여넣기만 하면 됩니다.

WordPress 사이트 프런트 엔드에 오류가 표시되지 않도록 하려면 다음과 같이 WP_DEBUG_DISPLAY 옵션을 false로 설정할 수 있습니다.

정의( 'WP_DEBUG_DISPLAY', 거짓 );

중요 참고 사항: WP_DEBUG는 라이브 웹 사이트가 아닌 테스트 또는 스테이징 환경에서 활성화해야 합니다.

특정 문제를 해결하는 경우 활성화한 옵션에 따라 WP_DEBUG/WP_DEBUG_LOG 옵션이 활성화된 상태에서 문제를 복제해 보십시오. 이렇게 하면 오류가 발생하여 디버깅 도구가 로그 파일에 기록하게 됩니다.

일반적인 WordPress 문제

워드프레스 문제

앞에서 언급했듯이 WordPress는 매우 안정적인 CMS입니다. 많은 개발자가 각 릴리스에 무수한 시간을 투자하고 많은 사람들이 문제 없이 실행합니다. 평판이 좋은 개발자의 테마와 플러그인도 마찬가지입니다. 그러나 환경 변화로 인해 문제와 갈등이 발생할 수 있습니다. 이는 다른 소프트웨어와 마찬가지로 WordPress 관련 소프트웨어에 해당됩니다. 따라서 때때로 문제가 발생할 수 있습니다.

WordPress, 테마 또는 플러그인과 직접 관련이 있는 WordPress 문제가 반드시 소프트웨어에 문제가 있음을 의미하지는 않습니다. 대부분 구성 문제입니다. 어느 쪽이든 WP_Debug는 무슨 일이 일어나고 있는지 알아내는 데 도움이 될 것입니다.

죽음의 하얀 화면

징후

약어 WSOD로도 알려진 White Screen of Death는 WordPress 웹 사이트에 나타나 완전히 빈 흰색 화면을 표시합니다.

원인

많은 요인이 WSOD에 기여할 수 있지만 일반적인 원인은 플러그인 및 테마와의 호환성 문제입니다. 최근에 플러그인을 설치했거나 업데이트한 경우 플러그인 또는 테마를 수동으로 비활성화하는 것이 첫 번째 호출 포트여야 합니다.

고치다

디버그 로그 파일을 통해 어떤 플러그인과 어떤 코드 줄이 문제를 일으키는지 더 잘 파악할 수 있습니다. 플러그인이나 테마가 원인이라고 판단되면 개발자에게 연락하여 수정을 요청할 수 있습니다. 문제가 다른 곳에 있는 경우 로그 파일을 통해 문제의 원인을 더 잘 파악할 수 있습니다.
데이터베이스 연결 문제

징후

WordPress 데이터베이스 연결 문제는 다양한 이유로 발생할 수 있으며 다양한 방식으로 나타납니다. 보다 일반적인 증상 중 하나는 웹사이트에 '데이터베이스 연결 설정 오류' 메시지가 표시되는 것입니다.

원인

WordPress는 MySQL을 사용하여 설정 및 게시물과 같은 데이터를 저장하고 읽습니다. WordPress 데이터베이스에 연결하지 않으면 웹사이트가 작동하지 않습니다. 연결 또는 자격 증명 문제를 포함하여 여러 가지 이유로 데이터베이스 연결 오류가 발생할 수 있습니다.

고치다

MySQL 서버가 실행 중이고 WordPress가 연결할 수 있는지 확인하십시오. 특히 변경했거나 처음 설치하는 경우 방화벽 규칙과 구성 파일을 확인해야 합니다. 다음으로 WordPress 데이터베이스 사용자에게 필요한 테이블에 대한 충분한 권한이 있고 데이터베이스 쿼리를 실행할 수 있는지 확인합니다.

WordPress를 유지 관리 모드에서 해제하려면 FTP 또는 SSH를 통해 로그인하고 .maintenance 파일을 삭제하십시오. 웹 사이트가 정상으로 돌아가려면 캐시를 삭제해야 할 수도 있습니다. WP_DEBUG는 문제를 해결하는 데 도움이 될 수 있지만 웹 사이트가 다운되지 않도록 스테이징 또는 테스트 환경에서 시도하는 것이 좋습니다.

내 오류가 위에 나열되지 않았습니다.

WordPress 환경은 서로 크게 다를 수 있으며 때때로 모호한 오류가 발생할 수 있습니다. 이러한 경우 WordPress 디버그 모드를 활성화하는 것이 가장 좋은 방법 중 하나입니다.

위협적으로 들릴 수 있지만 WordPress의 작동 방식을 더 잘 이해하고 더 잘할 수 있도록 도와줍니다. WordPress 테스트 또는 스테이징 환경이 있으면 큰 도움이 될 수 있습니다. 이러한 환경은 라이브 웹 사이트를 위험에 빠뜨리지 않고 문제를 해결하는 데 큰 도움이 됩니다.

워드프레스 문제 해결

WordPress는 웹 사이트 실행을 보장하기 위해 함께 작동하는 여러 기술에 의존합니다. MySQL과 PHP에 대해 꽤 많이 다루었지만 HTML, CSS, Javascript와 같은 다른 기술은 웹사이트가 표시되고 작동하는 방식에 매우 중요합니다.
평판이 좋은 개발자를 선택하는 한 괜찮을 것입니다. 그러나 많은 경우 다른 요인이 WordPress 오류에 기여할 수 있습니다. 이것은 WordPress 디버그가 당신의 친구임을 증명할 수 있는 곳입니다. 플러그인 및 테마 개발자에 대해 말하자면, 문제가 발생했을 때 도움을 줄 누군가가 있다는 사실을 알고 안심할 수 있도록 지원을 제공하는 데 도움이 됩니다.

문제 해결은 가지고 있으면 좋은 기술이며 수많은 방법으로 당신을 도울 수 있습니다. 가동 중지 시간을 최소화할 수 있을 뿐만 아니라 보다 안전하고 안전한 웹 사이트를 위해 WordPress 보안 연습을 수행할 때도 유용합니다.