WordPress에서 구문 오류를 수정하는 방법 : 원인 및 솔루션

구문 오류 메시지와 함께 WordPress 사이트 충돌을 보는 것보다 더 공황이 발생하는 것은 거의 없습니다. 귀하의 웹 사이트는 신중하게 설계된 페이지 대신 흰색 화면 또는 오류 메시지를 갑자기 표시합니다. 우리는이 상황이 얼마나 스트레스가 될 수 있는지 이해합니다. 특히 개발자 나 코딩 전문가가 아닌 경우.

WordPress의 구문 오류는 사이트의 PHP 코드에 실수가있을 때 발생합니다. 이 오류는 웹 사이트가 제대로 작동하는 것을 효과적으로 중지합니다. 좋은 소식은 대부분의 구문 오류가 간단한 원인과 솔루션을 가지고 있다는 것입니다.

이 안내서에서는 WordPress 구문 오류의 일반적인 원인을 안내하고이를 해결하기위한 명확하고 단계별 솔루션을 제공합니다. 지금이 문제에 직면하든 미래를 준비하고 싶든, 무슨 일이 일어나고 있는지, 어떻게 빠르게 해결하는지 이해하도록 도와 드리겠습니다.

WordPress의 구문 오류는 무엇입니까?

WordPress의 구문 오류는 사이트의 PHP 코드에 실수가있어 WordPress가 올바르게 실행되는 것을 방지하는 경우 발생합니다. 언어 컴퓨터가 이해하는 문법 오류로 생각하십시오. WordPress가 구문 오류가 발생하면 일반적으로 해당 시점에서 코드 처리를 중지하여 전체 사이트가 다운 될 수 있습니다.

이러한 오류는 일반적으로 사이트 코드를 변경하거나 변경 한 후에 나타납니다. 테마의 functions.php 파일을 편집하거나 새 플러그인을 설치하거나 웹 사이트에 사용자 정의 할 때 발생할 수 있습니다.

구문 오류의 가장 일반적인 증상은 다음과 같은 보이는 메시지를받는 것입니다.

구문 분석 오류 : 구문 오류, 예상치 못한 ')'in /public_html/wp-content/themes/your-theme/functions.php 123

이 오류 메시지는 세 가지 중요한 정보를 제공합니다.

• 오류 유형 (구문 분석 오류/구문 오류)
• 오류가 발생한 파일 위치
• 문제가있는 특정 줄 번호

이 정보를 이해하는 것은 문제를 해결하기위한 첫 번째 단계입니다. 이러한 오류가 발생하는 이유와 해결 방법을 살펴 보겠습니다.

WordPress 구문 오류의 일반적인 원인

구문 오류는 무작위로 발생하지 않습니다. 일반적으로 특정 코딩 실수로 인해 발생합니다. WordPress 웹 사이트에서 구문 오류의 가장 일반적인 원인을 살펴 보겠습니다.

누락 또는 추가 구두점

구문 오류의 가장 빈번한 원인 중 하나는 PHP 코드의 구두점이 잘못된 것입니다. 모든 세미콜론, 브래킷 및 견적 마크는 코드의 특정 목적을 제공합니다. PHP 문의 끝에 세미콜론 (`;`)이 없으면 구문 오류로 이어지는 일반적인 실수입니다. (출처 : WPMU DEV)

구문 오류를 일반적으로 유발하는 다른 구두점 문제는 다음과 같습니다.

• 타의 추종을 불허하는 곱슬 괄호`{}`
• 괄호 안장`()`
• 누락되거나 불일치 된 사각형 괄호`[]`
• 단일 따옴표```및 Double Quotes```부적절하게 혼합

단일 누락 된 캐릭터조차도 전체 웹 사이트를 깨뜨릴 수 있습니다. 이것이 신중한 코드 편집이 매우 중요한 이유입니다.

코드 오타와 실수

코드의 간단한 타이핑 오류로 인해 사이트가 충돌하는 구문 오류가 발생할 수 있습니다. 틀린 함수 또는 가변 이름은 WordPress에서 구문 오류를 유발하는 가장 일반적인 코딩 실수 중 하나입니다. (출처 : 우아한 테마)

다른 일반적인 오타 관련 문제는 다음과 같습니다.

• 포함/요구 사항의 잘못된 파일 경로
• 배열 또는 기능 매개 변수의 쉼표가 누락되었습니다
• 잘못된 PHP 연산자 사용 (== 대신 =)

이러한 사소한 실수는 귀하의 웹 사이트 기능에 큰 결과를 초래할 수 있습니다.

플러그인 및 테마 충돌

WordPress 구문 오류는 종종 플러그인 및 테마에 대한 업데이트 중 또는 후에 발생합니다. 플러그인 충돌은 이전 플러그인이 더 이상 새로운 WordPress 버전과 호환되지 않는 더 이상 사용되지 않은 코드를 사용하는 경우 특히 일반적입니다. (출처 : WordPress.org 지원)

테마 관련 구문 오류는 특히 테마의 functions.php 파일에서 업데이트 후 발생합니다. 이것은 가장 일반적으로 편집되는 파일 중 하나이므로 구문 오류의 빈번한 소스입니다.

또한 프로세스를 설치하거나 업데이트하는 동안 플러그인 파일이 손상 될 수있어 WordPress가 손상된 코드를 실행하려고 할 때 구문 오류가 발생할 수 있습니다.

이 표는 WordPress 사이트에서 가장 일반적인 구문 오류 소스를 강조합니다. 구두점 오류 및 코드 오타는 대부분의 사례를 구성하며 일반적으로 더 복잡한 플러그인 및 테마 충돌에 비해 수정하기가 더 쉽습니다.

구문 오류 메시지 이해

구문 오류를 수정하기 전에 오류 메시지가 말하는 내용을 이해하는 것이 중요합니다. WordPress 구문 오류 메시지에는 문제를 신속하게 찾아 내고 해결하는 데 도움이되는 귀중한 정보가 포함되어 있습니다.

구문 오류 메시지의 해부학

구문 오류에 대한 기본 WordPress 오류 메시지는 오류가 발생한 파일 경로와 줄 번호를 보여줍니다. 이 중요한 정보는 문제 해결 노력에 집중 해야하는 위치를 정확하게 찾는 데 도움이됩니다. (출처 : wpbeginner)

일반적인 구문 오류 메시지에는 다음이 포함됩니다.

• 오류 유형 : 일반적으로 "구문 분석 오류"또는 "구문 오류"
• 특정 문제 : "예상치 못한"), "예상치 못한 '$ variable'"또는 "예상치 못한 파일 끝"
• 파일 위치 : 오류가 포함 된 파일의 경로
• 줄 번호 : WordPress가 문제가 발생한 특정 줄

이러한 일반적인 오류 메시지를 이해하면 코드에서 잘못된 내용을 신속하게 식별하여 귀중한 문제 해결 시간을 저장하는 데 도움이 될 수 있습니다.

더 나은 오류보고를 가능하게합니다

기본 WordPress 오류 메시지가 도움이되지만 WP-Config.php 파일에`wp_debug` 모드를 추가하여보다 자세한 오류보고를 활성화 할 수 있습니다. 이 향상된 디버깅은 오류에 대한 자세한 정보를 보여주고 정확한 문제를 더 빨리 식별하는 데 도움이 될 수 있습니다.

WP_DEBUG 모드를 활성화하려면이 코드를 wp-config.php 파일에 추가하십시오.

 define( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true ); define( 'WP_DEBUG_DISPLAY', true );

이러한 설정을 활성화하면 WordPress는보다 자세한 오류 정보를 표시하고 WP-Content 디렉토리의 Debug.log 파일에 오류를 기록합니다. 복잡한 구문 오류 문제를 해결할 때 엄청나게 도움이 될 수 있습니다.

WordPress 구문 오류를 수정하는 방법

구문 오류의 원인과 오류 메시지를 해석하는 방법을 이해 했으므로 이러한 문제를 해결하고 사이트를 온라인으로 되 찾는 실제 방법을 살펴 보겠습니다.

방법 1 : FTP/SFTP 액세스를 통해 수정

WordPress 사이트에 구문 오류가 표시되면 관리 대시 보드가 종종 액세스 할 수 없습니다. 이 경우 FTP 또는 SFTP를 통해 사이트 파일에 액세스하는 것이 가장 신뢰할 수있는 솔루션입니다.

단계별 프로세스는 다음과 같습니다.

1. FileZilla와 같은 FTP 클라이언트를 사용하여 사이트에 연결
2. 오류 메시지에 언급 된 파일로 이동하십시오
3. 컴퓨터에 파일을 다운로드하십시오
4. 코드 편집기 (Notepad ++, Visual Studio Code 또는 Sublime Text와 같은)에서 열립니다.
5. 오류 메시지에 언급 된 줄 번호로 이동
6. 구문 문제를 수정하십시오 (세미콜론 누락, 미세한 괄호 등).
7. 파일을 저장하고 서버에 다시 업로드하고 문제가있는 파일을 덮어 씁니다.

이 메소드는 오류로 인해 관리 영역을 사용할 수없는 경우에도 WordPress 파일에 직접 액세스 할 수 있습니다. 구문 오류, 특히 사이트를 완전히 파괴하는 더 심각한 경우에 가장 신뢰할 수있는 방법입니다.

방법 2 : WordPress 테마/플러그인 편집기 사용

WordPress Admin 영역에 여전히 액세스 할 수있는 경우 내장 코드 편집기를 통해 구문 오류를 수정할 수 있습니다.

1. WordPress 관리 영역에 로그인하십시오
2. 오류가 테마 파일에 있으면 모양 → 테마 편집기로 이동하십시오.
3. 오류가 플러그인 파일에 있으면 플러그인 → 플러그인 편집기로 이동하십시오.
4. 오류가 포함 된 테마 또는 플러그인을 선택하십시오
5. 오류 메시지에서 언급 된 파일을 찾고 열립니다.
6. 오류 메시지에 언급 된 줄을 찾으십시오
7. 구문 문제를 수정하십시오
8. "파일 업데이트"를 클릭하여 변경 사항을 저장하십시오

이 방법은 관리 영역에 대한 액세스를 완전히 방해하지 않는 작은 구문 오류에 적합합니다. 그러나 많은 심각한 구문 오류로 인해 관리자 대시 보드가 접근 할 수 없게되므로 위에서 설명한 FTP 방법을 사용해야합니다.

방법 3 : 플러그인 및 테마 충돌 해결

플러그인 또는 테마를 설치하거나 업데이트 한 후 구문 오류가 발생한 경우 문제가있는 구성 요소를 비활성화하여 해결할 수 있습니다.

플러그인 관련 구문 오류 :

효과적인 문제 해결 방법 중 하나는 모든 플러그인을 효과적으로 비활성화하는 플러그인 폴더의 이름을 바꾸는 것입니다. 이것은 플러그인이 구문 오류를 유발하는지 여부를 빠르게 결정하는 방법입니다. (출처 : WP 로켓)

다음 단계를 따르십시오.

1. FTP/SFTP를 통해 사이트에 연결하십시오
2. WP-Content 디렉토리로 이동하십시오
3. "플러그인"폴더를 찾으십시오
4. "Plugins_old"또는 "Plugins_Disabled"와 같은 이름을 바꿉니다.
5. 이것은 모든 플러그인을 비활성화하므로 플러그인이 원인이면 오류를 해결해야합니다.
6. 사이트가 다시 작동하면 폴더 이름을 "플러그인"으로 다시 바꾸십시오.
7. 그런 다음 플러그인을 하나씩 비활성화하여 (개별 플러그인 폴더를 바꾸어) 문제가있는 것을 식별하십시오.

테마 관련 구문 오류 :

구문 오류가 테마와 관련이있는 경우 기본 WordPress 테마로 전환하면 문제를 해결하는 데 도움이 될 수 있습니다.

1. FTP/SFTP를 통해 사이트에 연결하십시오
2. WP-Content/테마로 이동//
3. 기본 WordPress 테마 (예 : 204)가 설치되어 있는지 확인하십시오.
4. 이 코드를 사용하여 WP-Content 디렉토리에서 "Theme_switch.php"라는 파일을 작성하거나 편집하십시오.

 <?php update_option('template', 'twentytwentyfour'); update_option('stylesheet', 'twentytwentyfour'); ?>

5. /wp-content/theme_switch.php가 추가로 사이트 URL을 방문하십시오.
6. 이것은 당신의 테마를 224로 전환하여 문제가있는 테마를 우회합니다.
7. 관리자 영역에 대한 액세스를 회복하면 문제가있는 테마를 수정하거나 교체 할 수 있습니다.

이 방법은 WordPress에서 구문 오류를 수정할 때 발생할 대부분의 시나리오를 다룹니다. 최상의 접근법은 오류의 심각성과 WordPress 관리 영역에 여전히 액세스 할 수 있는지 여부에 따라 다릅니다.

방법 4 : 준비 환경 사용

복잡한 구문 오류 또는 상당한 코드 변경시 WP 스테이징과 같은 스테이징 플러그인을 사용하면 라이브 사이트에 영향을 미치지 않고 문제를 테스트하고 수정할 수있는보다 안전한 환경을 제공 할 수 있습니다. 이 접근 방식을 사용하면 사이트 사본에서 작업 한 다음 올바르게 작동하는지 확인하면 생산 사이트에서 고정 코드를 구현할 수 있습니다.

WordPress 구문 오류를 방지하는 방법

구문 오류를 수정하는 방법을 아는 것이 중요하지만, 처음에는 방지하는 것이 더 좋습니다. 다음은 WordPress 사이트의 구문 오류를 피하기위한 입증 된 전략입니다.

코드 편집을위한 모범 사례

이러한 모범 사례에 따라 구문 오류의 위험을 크게 줄일 수 있습니다.

• 적절한 코드 편집기 사용 : Visual Studio Code, Sublime Text 또는 Atom과 같은 도구는 구문 강조 표시 및 오류 확인이 있습니다.
• 브래킷 일치 활성화 : 대부분의 코드 편집기는 일치하는 브래킷 및 괄호를 강조 할 수 있습니다.
• 증분 변경 : 한 번에 코드의 작은 부분을 편집하고 테스트하십시오.
• 백업 유지 : 변경하기 전에 항상 원본 파일을 복사하십시오.
• 코드 형식 : 적절한 압축은 구문 문제를 쉽게 찾을 수 있도록합니다.

권장 도구 및 플러그인

여러 도구가 구문 오류를 방지하고 신속하게 해결하는 데 도움이 될 수 있습니다.

정규 WordPress 유지 보수 루틴의 일부로 이러한 도구를 구현하면 구문 오류의 위험이 크게 줄어들고 발생할 때 더 빨리 복구 할 수 있습니다.

정기적 인 유지 보수 모범 사례

사전 유지 관리 접근 방식은 구문 오류 및 기타 WordPress 문제에 대한 최선의 방어입니다.

• WordPress Core, 테마 및 플러그인을 업데이트하십시오
• 변경하기 전에 정기적 인 백업을 만듭니다
• 관리 유지 보수를 위해 WordPress Care Plans를 사용하십시오
• 생산에 적용하기 전에 스테이징 사이트에 대한 업데이트를 테스트합니다
• 정기적으로 플러그인을 감사 하고 사용하지 않은 플러그인을 제거하십시오

이러한 예방 조치에 따라 WordPress 사이트에서 구문 오류가 발생할 가능성을 크게 줄일 수 있습니다. 정기적 인 유지 보수는 구문 오류를 방지 할뿐만 아니라 사이트의 전반적인 보안 및 성능을 향상시킵니다.

WordPress 오류에 대한 도움이 필요하십니까?

지속적인 구문 오류 또는 기타 WordPress 문제로 어려움을 겪고 있다면 전문가 팀이 도울 수 있습니다. 우리는 WordPress 오류를 빠르고 효율적으로 문제 해결 및 해결하는 데 전문화됩니다 . fixmysite.com 에서 전문적인 지원을 받으십시오 .

결론

WordPress의 구문 오류는 특히 전체 사이트를 오프라인으로 가져갈 때 놀라 울 수 있습니다. 그러나 올바른 접근 방식과 도구를 사용하면 이러한 오류는 빠르고 효과적으로 해결 될 수 있습니다.

이러한 주요 요점을 기억하십시오.

• 대부분의 구문 오류는 구두점 누락, 코드 오타 또는 플러그인/테마 충돌과 같은 간단한 문제로 인해 발생합니다.
• 오류 메시지에는 문제를 찾아서 해결할 위치에 대한 귀중한 정보가 포함되어 있습니다.
• FTP 액세스에서 WordPress 편집기 사용에 이르기까지 구문 오류 수정을위한 여러 메소드가 존재합니다.
• 예방은 최상의 전략입니다 - 적절한 도구를 사용하고, 백업을하고, 코딩 모범 사례를 따르십시오.

구문 오류와 같은 일반적인 WordPress 웹 사이트 문제를 해결하는 방법을 이해하면 사이트를 유지하고 문제가 발생할 때 빠르게 문제를 해결할 수있는 장비를 더 잘 갖추게됩니다.

구문 오류에 갇히지 않으면 해결할 수 없거나 전문가가 문제를 처리하는 것을 원한다면 주저하지 말고 전문적인 도움을 청하십시오. 적절한 보안 조치, 정기적 인 유지 보수 및 일반적인 오류를 고치는 방법에 대한 이해를 잘 알고 있으면 WordPress 사이트를 원활하게 실행할 수 있습니다.