如何修復 WordPress 中的“解析錯誤：語法錯誤，意外”

已發表: 2023-12-06

「解析錯誤：語法錯誤，意外」是 WordPress 中經常遇到的錯誤，它可能會讓網站所有者感到沮喪並且不確定下一步要採取的步驟。

此錯誤通常是由於 PHP 程式碼中的語法錯誤而引起的，WordPress 利用 PHP 程式碼來建立和操作其動態網頁。

如果您遇到過這條令人困惑的消息，請不要擔心 - 您並不孤單。在這篇文章中，我們將解釋各種解析錯誤並引導您完成如何修復它們。

你準備好了嗎？讓我們開始吧。

1 WordPress 中的「解析錯誤：語法錯誤，意外」錯誤是什麼？

「解析錯誤：語法錯誤，意外」是當 WordPress 在 PHP 程式碼中遇到意外或無效元素時發生的錯誤，導致其無法成功解釋和執行指令。

當WordPress解析PHP程式碼時，它會尋找特定的語法規則和結構，以確保程式碼有效並且可以正確執行。

如果 WordPress 在 PHP 程式碼中遇到錯誤，它將停止程式碼的執行並顯示錯誤訊息。

現在，讓我們分解這個錯誤，以便您能夠理解它：

語法錯誤：問題與程式碼的語法有關，這可能導致違反編碼規則，導致解析器混亂。
意外：解析器無法找到它實際要查找的內容，並且不知道如何處理它。

該訊息通常包含行號和檔案路徑等附加訊息，這有助於找出有問題的程式碼片段。根據導致錯誤的原因，WordPress 中實際的「解析錯誤語法錯誤，意外」錯誤可能有不同的結局。

這裡有些例子：

文法錯誤，意外的文件結尾
文法錯誤，意外的標記
語法錯誤，意外變數
語法錯誤，意外的標識符

現在您已經了解了這個解析錯誤是什麼，讓我們討論一下它的原因。

WordPress 中「解析錯誤：語法錯誤，意外」的2 個常見原因

解析錯誤本身不會出現在您的網站上；相反，這是您網站程式碼上發生錯誤的結果，例如：

未閉合的引號或括號：未能閉合引號或括號可能會使 PHP 解析器感到困惑。
缺少字元：缺少字元（例如分號、引號或括號）可能會導致 WordPress 錯誤解釋程式碼並觸發錯誤。
不正確的語法：使用不正確的語法，例如使用錯誤的關鍵字或將語句放在錯誤的位置，也可能導致錯誤。
不相容的程式碼：不相容的程式碼（例如為舊版的 PHP 編寫的程式碼）也可能會觸發該錯誤。
檔案損壞或修改：如果 WordPress 核心檔案或外掛程式/主題檔案意外損壞或修改，則可能會引入語法錯誤。

當您在 WordPress 外掛程式或主題文件編輯器中錯誤地編輯程式碼時，也經常會看到此錯誤。

在上面的範例中，由於true)後面缺少分號而發生解析錯誤。將缺少的分號加到上述行將成功解決該問題。

同樣，如果遇到“未閉合”錯誤，後面跟著特定字元和行號，請檢查程式碼是否缺少花括號。在下面的範例中，缺少匹配的右大括號。

注意：要在WordPress 檔案編輯器中編輯程式碼時修復錯誤，只需按一下檔案中的任何位置，使用「Ctrl + Z」(Windows) 或「Command + Z」(Mac) 撤銷最近的更改，然後單擊“更新”檔案。”

即使您不這樣做，WordPress 仍然不會儲存更改，直到程式碼正確為止。因此，您仍然可以刷新頁面以撤消先前的更改，這將立即解決問題。

修正解析錯誤並不難，但您必須了解程式碼的工作原理以及如何編輯它。但是，如果您沒有任何編碼知識，我們將向您展示一個解決此問題的好方法。

如果您被鎖定在 WordPress 儀表板之外，我們將介紹如何解決此問題。

3如何修復 WordPress 中的“解析錯誤：語法錯誤，意外”

大多數情況下，當發生此錯誤時，它可能會將您鎖定在 WordPress 儀表板之外。在這種情況下，請繼續執行以下步驟以確定此錯誤的來源並快速解決。

3.1啟用調試模式

通常，當 WordPress 將您鎖定在管理儀表板之外時，您會看到一個空白頁面，其中包含與此類似的訊息。

WP 偵錯模式可協助您識別和偵錯 WordPress 網站中的錯誤。啟用 WP 偵錯模式時，它將顯示 PHP 錯誤訊息以及錯誤來源。

您可以透過 cPanel 或 FTP 啟用調試。如果您使用的是 cPanel，請在檔案總管中開啟public_html資料夾。

在這裡，向下滾動查找wp-config.php 。右鍵單擊它，然後選擇“編輯” 。

在程式碼編輯器中，搜尋WP_DEBUG ，如下所示。

確保將其設為true 。如果您的 wp-config.php 檔案中缺少程式碼，請複製以下程式碼並將其貼上到此處。最後，不要忘記點擊“儲存變更”按鈕。

 define('WP_DEBUG', true);

您會注意到，它不僅會再次顯示嚴重錯誤，還會向您提供有關影響您網站的錯誤的詳細資訊。

啟動偵錯模式後顯示解析錯誤

現在，轉到錯誤頁面並重新載入它。錯誤訊息將顯示更多詳細信息，您可以在此處獲取有關錯誤來源的信息。

3.2編輯程式碼

現在轉到錯誤通知中指定的檔案並在程式碼編輯器中開啟該檔案。

注意：如果您需要還原到此版本，我們建議您保留此檔案的備份。

在程式碼編輯器中，轉到錯誤中提到的行。然後驗證語法並修復它。如果您不熟悉程式碼，則需要開發人員的協助或聯絡 Rank Math 支援專家以獲得進一步指導。

完成更改後，返回您的 WordPress 網站並重新加載頁面。如果您已修復錯誤，您會發現頁面將開始正確載入。

修復錯誤後，打開wp-config.php檔案並恢復WP_DEBUG設置，如下所示。

 define('WP_DEBUG', false);

停用偵錯模式至關重要，因為它可以幫助防止網站上敏感資訊的暴露，從而導致安全風險。

3.3停用外掛程式/主題

如果您無法遵循本文提供的解決方案，可能是因為您不熟悉編碼，您應該嘗試最後一種方法。

透過執行運行狀況檢查或偵錯模式來識別導致問題的外掛程式/主題，然後您可以透過停用導致問題的外掛程式/主題來快速還原網站。

如果您仍然可以存取 WordPress 儀表板，則應該停用您的外掛程式/主題。

但是，如果您被鎖定在 WordPress 儀表板之外，請導覽至public_html → wp-content ，然後在檔案管理器中選擇外掛程式/主題。

在這裡，重命名導致問題的外掛程式/主題的資料夾名稱，如下所示。

重新命名時，您只需將-old新增至資料夾名稱中，儲存後，外掛程式/主題將在您的網站上停用。

完成後，只需返回您的網站並刷新頁面即可。您會注意到您的網站將開始正常運作。

防止將來出現解析錯誤的4 個技巧

以下是一些簡單的預防提示，可幫助您避免將來發生錯誤。

讓您的外掛程式和主題保持最新：這將有助於確保它們與最新版本的 WordPress 相容，並且不包含任何可能導致錯誤的錯誤。

從可信任來源安裝插件：僅從信譽良好的來源安裝插件，以最大限度地降低安裝包含不相容程式碼的插件的風險。

徹底測試程式碼變更：在部署程式碼變更之前，請在暫存環境中對其進行徹底測試，以識別並修復任何潛在問題。

利用程式碼檢查器和驗證器：使用程式碼檢查器和驗證器來偵測潛在的語法錯誤並確保程式碼遵循最佳實務。

定期備份您的網站：定期備份您的 WordPress 網站，以便在出現問題時輕鬆將其還原到工作狀態。

透過遵循這些預防提示，我們希望您的網站不會出現解析語法錯誤。

5結論

編寫程式碼可能很脆弱，這意味著任何錯誤都可能導致重大問題。

這也適用於編輯 WordPress 主題或外掛程式檔案。如果您不是程式設計師，我們建議您聘請專業人士。

如果您擅長編碼，請避免直接在外掛程式或主題文件編輯器中進行編輯。相反，下載程式碼檔案並使用配備程式碼驗證器的整合開發環境 (IDE)。這使您能夠快速找到並修復任何程式碼錯誤。

然後，在將程式碼上傳到您的網站之前，在暫存網站上測試程式碼。請務必備份您的網站，以便在發生 Parse 錯誤時可以輕鬆恢復先前的備份。

我們希望您已成功解決網站上的解析錯誤，並且我們相信本文對您有所幫助。如果是這樣，請透過推文@rankmathseo 告知我們。