WordPress에서 "구문 분석 오류: 예기치 않은 구문 오류"를 수정하는 방법

게시 됨: 2023-12-06

WordPress를 사용하여 웹에 자신만의 공간을 구축하는 것은 흥미롭지만 때로는 "구문 분석 오류: 구문 오류, 예상치 못한"이라는 약간의 문제로 인해 작업에 어려움을 겪을 수 있습니다.

이 오류는 코드의 단순한 오타부터 테마 또는 플러그인 내의 보다 복잡한 문제에 이르기까지 다양한 이유로 발생할 수 있습니다.

하지만 두려워하지 마세요!

이 게시물에서는 이 오류를 해결하고 웹사이트를 최상의 상태로 되돌리는 데 도움을 드리겠습니다.

준비 되었나요? 시작하자.

목차

  1. WordPress의 "구문 분석 오류: 구문 오류, 예기치 않은" 오류는 무엇입니까?
  2. WordPress에서 "구문 분석 오류: 구문 오류, 예기치 않은"의 일반적인 원인
  3. WordPress에서 "구문 분석 오류: 예기치 않은 구문 오류"를 수정하는 방법
    • 디버그 모드 활성화
    • 코드 편집
    • 플러그인 및 테마 비활성화
  4. WordPress의 구문 분석 오류 방지 팁
  5. 결론

1 WordPress의 "구문 분석 오류: 구문 오류, 예기치 않은" 오류는 무엇입니까?

"구문 분석 오류: 구문 오류, 예상치 못한"은 WordPress가 PHP 코드 내에서 예상치 못한 또는 유효하지 않은 요소를 발견하여 명령을 성공적으로 해석하고 실행할 수 없을 때 발생하는 오류입니다.

귀하의 웹사이트 기능은 프로그래밍 언어(이 경우 WordPress 테마 및 플러그인에서 널리 사용되는 PHP)로 작성된 지침에 따라 달라집니다. PHP 인터프리터가 이해할 수 없는 명령을 만나거나 작성된 내용과 다른 것을 기대하면 " Parse Error"가 발생합니다.

메시지의 "구문 오류" 부분은 코드 구조에 문제가 있음을 의미합니다. 언어 오해처럼 생각하십시오. 귀하의 지시 사항은 컴퓨터가 이해하는 방식으로 전달되지 않으며 혼란스럽습니다.

"예기치 않은" 요소는 코드 어딘가에 인터프리터가 특정 지점에서 예상하지 못한 명령이나 문자가 있다는 사실을 나타냅니다. 이는 누락된 세미콜론, 잘못 입력된 함수 또는 통역사가 예상한 것과 다른 추가 대괄호일 수 있습니다.

WordPress는 PHP 코드를 구문 분석할 때 특정 구문 규칙과 구조를 찾아 해당 코드가 유효하고 올바르게 실행될 수 있는지 확인합니다.

여기 몇 가지 예가 있어요.

  • 구문 오류, 예상치 못한 파일 끝
  • 구문 에러 : 예기치 않은 토큰
  • 구문 오류, 예상치 못한 변수
  • 구문 에러 : 예기치 않은 식별자

이제 이 구문 분석 오류를 이해했으므로 해당 원인에 대해 논의하겠습니다.

WordPress에서 "구문 분석 오류: 예기치 않은 구문 오류"의 2가지 일반적인 원인

구문 분석 오류

구문 분석 오류는 웹사이트 자체에 나타나지 않습니다. 오히려 다음과 같이 웹사이트 코드에서 발생한 실수의 결과입니다.

  1. 닫히지 않은 따옴표 또는 괄호 : 따옴표나 괄호를 닫지 못하면 PHP 파서가 혼란을 겪을 수 있습니다.
  2. 누락된 문자: 세미콜론, 따옴표, 괄호 등 누락된 문자로 인해 WordPress에서 코드를 잘못 해석하여 오류가 발생할 수 있습니다.
  3. 잘못된 구문: 잘못된 키워드를 사용하거나 문을 잘못된 위치에 배치하는 등 잘못된 구문을 사용하면 오류가 발생할 수도 있습니다.
  4. 호환되지 않는 코드: 이전 버전의 PHP용으로 작성된 코드와 같은 호환되지 않는 코드도 오류를 유발할 수 있습니다.
  5. 손상되거나 수정된 ​​파일: WordPress 코어 파일 또는 플러그인/테마 파일이 의도치 않게 손상되거나 수정된 ​​경우 구문 오류가 발생할 수 있습니다.

이 오류는 WordPress 플러그인 또는 테마 파일 편집기에서 코드를 잘못 편집할 때 자주 나타납니다.

테마 파일 오류

위의 예에서는 세미콜론이 없어서 구문 분석 오류가 발생했습니다. 언급된 줄에 누락된 세미콜론을 추가하면 문제가 성공적으로 해결됩니다.

파일이 업데이트되었습니다.

마찬가지로, 특정 문자와 줄 번호가 뒤따르는 "닫히지 않음" 오류가 발생하면 코드에서 누락된 중괄호가 있는지 확인하세요. 아래 예에서는 일치하는 닫는 중괄호가 누락되었습니다.

브래킷 누락

참고: WordPress 파일 편집기에서 코드를 편집하는 동안 오류를 수정하려면 파일의 아무 곳이나 클릭하고 “Ctrl + Z”(Windows) 또는 “Command + Z”(Mac)를 사용하여 최근 변경 사항을 취소한 다음 “업데이트”를 누르십시오. 파일".

그렇게 하지 않더라도 WordPress는 코드가 정확할 때까지 변경 사항을 저장하지 않습니다.

따라서 페이지를 새로 고쳐 이전 변경 사항을 실행 취소하면 문제가 즉시 해결됩니다.

구문 분석 오류는 수정하기 어렵지 않지만 코드 작동 방식과 편집 방법을 이해해야 합니다.

하지만 코딩 지식이 전혀 없다면 이 문제를 해결할 수 있는 좋은 대안을 보여드리겠습니다.

WordPress 대시보드가 ​​잠겨 있는 경우 이 문제를 해결하는 방법에 대해 논의하겠습니다.

3 WordPress에서 "구문 분석 오류: 예기치 않은 구문 오류"를 수정하는 방법

대부분의 경우 이 구문 분석 오류가 공식적으로 발생하면 WordPress 대시보드에서 사용자가 잠길 수 있습니다.

하지만 WordPress 대시보드에서 차단되지 않으면 웹사이트의 이전 백업을 복원해 볼 수 있습니다.

또는 최근에 코드를 변경한 경우 변경 사항을 검토하시기 바랍니다. 코드에서 실수로 인해 오류가 발생했을 수도 있습니다.

코드를 주의 깊게 검토하면서 누락되거나 일치하지 않는 괄호나 대괄호 또는 PHP에서 세미콜론이 있는지 찾아보세요.

또한 코드를 다운로드하여 PHP 구문 검사기나 편집기에 붙여넣어 오류가 발생한 위치를 확인할 수도 있습니다.

이들 중 어느 것도 수행할 수 없거나 작동하지 않는 경우 아래 단계를 진행하여 이 오류를 신속하게 해결하십시오.

3.1 디버그 모드 활성화

WP 디버그 모드는 WordPress 사이트의 오류를 식별하고 디버그하는 데 도움이 되는 진단 도구입니다.

일반적으로 WordPress가 관리 대시보드에서 사용자를 잠그면 다음과 유사한 메시지가 포함된 빈 페이지가 표시됩니다.

WordPress의 심각한 오류

여러 가지 문제로 인해 WordPress에서 이 메시지가 표시될 수 있으므로 이 메시지로는 이 "중요한 오류"의 실제 원인을 확인할 수 없습니다.

WP 디버그 모드가 활성화되면 PHP 오류 메시지, 원인 및 오류가 발생한 방향이 표시됩니다.

cPanel 또는 WordPress 플러그인을 통해 디버깅을 활성화할 수 있습니다. WordPress 대시보드에 로그인할 수 있으면 플러그인을 사용하여 디버그 모드를 활성화할 수 있습니다.

하지만 지금은 호스팅 또는 cPanel 방법을 사용하겠습니다. 따라서 cPanel 또는 DirectAdmin에 로그인하십시오.

따라서 파일 관리자를 선택하고 결과 페이지에서 public_html 로 이동하십시오.

cPanel의 파일 관리자

다음으로 아래로 스크롤하여 wp-config.php 파일을 찾으세요.

wp-config.php 파일로 이동합니다.

표시되면 해당 위에 마우스를 놓고 마우스 오른쪽 버튼을 클릭한 다음 편집 을 선택합니다.

wp-config.php 파일 편집

편집을 클릭하면 디버그 모드를 활성화할 수 있는 페이지로 리디렉션됩니다. 아래로 스크롤하십시오.

/* 그게 다야, 편집을 중지하세요! 행복한 출판이 되세요. */" 부분. "define( 'WP_DEBUG', false );"가 표시되어야 합니다. 아래 그림과 같이.

디버그 모드 변경

아래와 같이 false를 true 로 바꾸고 변경 사항을 저장하십시오.

디버그 모드를 true로 설정

거기에 디버그 코드가 표시되지 않으면 아래 코드를 해당 영역에 복사하여 붙여넣어야 합니다.

 define('WP_DEBUG', true);

변경 사항을 저장한 후 WordPress 웹사이트를 다시 로드하세요.

심각한 오류가 다시 표시되고 웹 사이트에 영향을 미치는 오류에 대한 세부 정보가 제공됩니다.

구문 분석 오류

위 이미지에 표시된 오류, 특히 첫 번째 줄을 주의 깊게 살펴보세요. 여기에서 오류에 대한 주요 정보를 찾을 수 있습니다.

사용자의 편의를 위해 파일에서 오류가 발생한 행도 제공됩니다. 해당 위치에서 오류를 해결하겠습니다.

3.2 코드 편집

문제를 해결하기 위해 위 이미지에 지정된 위치를 사용하겠습니다. 위치는 140행의 /home/sitefolder/public_html/wp-content/plugins/litespeed-cache/litespeed-cache.php입니다.

그러나 제공된 Parse 오류에 따라 오류가 플러그인이 아닌 테마와 관련되어 있을 수도 있습니다.

Parse 오류에서 제공하는 지침을 따르는 것이 중요합니다. 제공된 오류 예시에서 오류 메시지는 특정 플러그인을 문제의 원인으로 식별합니다.

따라서 FTP 또는 호스팅 패널을 사용하여 사이트에 연결하고 아래와 같이 public_html 페이지로 이동하여 wp-content 를 선택한 다음 플러그인을 선택하십시오.

플러그인 섹션으로 이동

Parse 오류로 표시된 플러그인을 선택했는지 확인하세요.

플러그인을 선택하세요

플러그인이나 테마를 선택하면 해당 플러그인이나 테마와 관련된 파일 위치로 리디렉션됩니다.

플러그인 파일을 다운로드하려면 해당 파일을 마우스 오른쪽 버튼으로 클릭하고 다운로드를 클릭한 후 다운로드된 후 편집을 선택하세요.

플러그인 파일 다운로드

플러그인 파일의 백업을 유지하는 것은 파일 코드에서 직접 실수를 방지하는 데 중요하며 전용 코드 편집기를 사용하여 별도의 코드 편집을 허용합니다.

편집을 클릭한 후 구문 분석 오류가 표시된 특정 줄을 찾아야 합니다.

이 예에서는 "라인 140"을 지정합니다. 따라서 오류를 식별하고 해결하려면 140행까지 아래로 스크롤해야 합니다.

오류를 찾아라

위 이미지에서 라인 140 옆에 빨간색 시간 아이콘이 있습니다. 그 위로 마우스를 가져가면 "구문 오류, 예상치 못한 '}', ';'이 필요합니다."라는 메시지가 표시됩니다.

확인한 후 ';'이 필요하다는 오류 메시지가 표시됩니다. .

오류를 해결하려면 "true)" 문자열 뒤에 올바른 위치에 세미콜론을 추가하세요.

이 문제를 해결하려면 "true)" 뒤에 올바른 위치에 세미콜론을 추가하고 변경 사항 저장 버튼을 클릭하세요.

오류가 수정되었습니다.

따라서 변경 사항을 저장한 후 WordPress 웹사이트로 돌아가서 페이지를 다시 로드하세요.

페이지가 제대로 로드되기 시작하는 것을 확인할 수 있습니다.

웹사이트가 올바르게 로드되었습니다.

따라서 일단 오류가 수정되고 웹사이트 페이지가 제대로 로드되기 시작합니다. wp-config.php 파일로 돌아가서 truefalse 설정으로 변경하거나 아래와 같이 이 코드를 복사하여 붙여넣으세요.

 define('WP_DEBUG', false);
디버그 모드를 false로 설정

이 WP_DEBUG를 false로 변경하는 것은 웹사이트에서 보안 위험으로 이어질 수 있는 민감한 정보의 노출을 방지하는 데 도움이 되기 때문에 매우 중요합니다. 또한 웹사이트 성능이 저하될 수도 있습니다.

프로그래머가 아니거나 코딩 지식이 부족하여 이 문서에 제공된 솔루션 지침을 따를 수 없는 경우 이 마지막 방법을 시도해야 합니다.

3.3 플러그인 및 테마 비활성화

이전 방법이 효과가 없거나 그렇게 할 수 없는 경우에만 이 방법을 사용해야 한다는 점을 명심하세요.

그러나 이 방법을 시도하기 전에 이 섹션의 첫 번째 방법에 표시된 대로 디버그 모드를 활성화하여 이 오류를 일으키는 정확한 플러그인이나 테마를 식별하는 것이 좋습니다.

여전히 WordPress 대시보드에 액세스할 수 있는 경우 플러그인을 하나씩 비활성화하여 문제를 일으키는 플러그인을 확인해야 합니다.

그러나 WordPress 대시보드가 ​​잠겨 플러그인 섹션에 액세스할 수 없는 경우 파일 관리자에서 감지된 플러그인이나 테마를 비활성화해야 합니다.

따라서 파일 관리자를 사용하는 동안 아래와 같이 public_html → wp-content → 플러그인 섹션으로 이동하세요.

플러그인 섹션으로 이동

테마가 문제의 원인이라는 오류가 표시되면 테마 옵션만 선택할 수 있습니다. 플러그인 옵션 아래.

우리는 플러그인 옵션을 계속 사용할 것이지만 WordPress 테마 비활성화에 대한 가이드를 참조하여 사이트의 테마를 비활성화할 수 있습니다.

따라서 플러그인 페이지에서 아래로 스크롤하여 문제를 일으키는 구문 분석 오류에 언급된 플러그인을 찾아야 합니다.

플러그인이 보이면 아래와 같이 마우스 오른쪽 버튼을 클릭하고 이름 바꾸기 옵션을 클릭 하세요.

플러그인 이름 바꾸기

이제 새 파일 이름을 입력하라는 메시지가 표시됩니다. 아래와 같이 플러그인 이름에 "-old"를 추가할 수 있습니다.

플러그인 이름 바꾸기

완료되면 이름 바꾸기 버튼을 클릭하세요.

이제 웹사이트로 돌아가서 페이지를 새로 고치세요. 귀하의 웹사이트가 제대로 작동하기 시작한다는 것을 알게 될 것입니다.

WordPress에서 구문 분석 오류를 방지하기 위한 4가지

이러한 팁은 간단하지만 일부 웹사이트 소유자는 구현하기 어렵다고 생각합니다. 우리 모두는 이러한 팁을 알고 있지만 어떤 이유로든 효과적으로 사용하는 것을 잊어버릴 수 있습니다.

향후 "구문 분석 오류: 구문 오류, 예기치 않은" 오류를 방지하는 데 도움이 되는 몇 가지 예방 조치만 검토하겠습니다.

  1. 플러그인과 테마를 최신 상태로 유지하세요. 이렇게 하면 최신 버전의 WordPress와 호환되고 오류를 일으킬 수 있는 버그가 없는지 확인하는 데 도움이 됩니다.
  1. 신뢰할 수 있는 소스의 플러그인 설치: 호환되지 않는 코드가 포함된 플러그인 설치 위험을 최소화하려면 평판이 좋은 소스의 플러그인만 설치하세요.
  1. 코드 변경 사항을 철저히 테스트합니다. 코드 변경 사항을 배포하기 전에 준비 환경에서 철저하게 테스트하여 잠재적인 문제를 식별하고 수정합니다.
  1. 코드 린터 및 유효성 검사기 활용: 코드 린터 및 유효성 검사기를 사용하여 잠재적인 구문 오류를 감지하고 모범 사례에 대한 코드 준수를 보장합니다.
  1. 웹사이트를 정기적으로 백업하세요. 문제가 쉽게 발생할 경우 WordPress 웹사이트를 정기적으로 백업하여 작동 상태로 복원하세요.

이러한 예방 팁을 따르면 귀하의 웹사이트에 구문 분석 오류가 없기를 바랍니다. 하지만 나중에 오류가 발생한다면 앞서 언급한 몇 가지 팁을 간과했기 때문일 수 있습니다.

이 경우 이 문서에 설명된 문제 해결 단계를 수행하여 문제를 해결하는 것이 좋습니다.

5. 결론

코드 작성은 취약할 수 있습니다. 즉, 실수가 있으면 심각한 문제가 발생할 수 있습니다.

이는 WordPress 테마 또는 플러그인 파일 편집에도 적용됩니다. 프로그래머가 아닌 경우 전문가를 고용하는 것이 좋습니다.

코딩에 능숙하다면 플러그인이나 테마 파일 편집기에서 직접 편집하는 것을 피하세요. 대신 코드 파일을 다운로드하고 코드 유효성 검사기가 장착된 IDE(통합 개발 환경)를 사용하세요. 이를 통해 코드 오류를 신속하게 찾아 수정할 수 있습니다.

그런 다음 웹사이트에 업로드하기 전에 준비 사이트에서 코드를 테스트하세요. 구문 분석 오류가 발생할 경우 이전 백업을 쉽게 복원할 수 있도록 항상 웹사이트를 백업하세요.

이 게시물에 언급된 방법을 사용하여 웹사이트에서 직면하고 있는 구문 분석 오류를 해결할 수 있었기를 바랍니다.

그렇다면 @rankmathseo를 트윗하여 알려주세요.