Przejdź do treści

Jak naprawić błąd składni (syntax error) w WordPress?

Błąd składni (syntax error) to jeden z najbardziej frustrujących problemów, które mogą spotkać użytkowników WordPress. Ten błąd zwykle pojawia się, gdy istnieje problem z PHP – językiem programowania, na którym oparty jest WordPress. W tym artykule podam kilka prostych metod, które pomogą Ci naprawić błąd składni w WordPress.

1. Edycja plików PHP przy użyciu SFTP

Najpowszechniejszą przyczyną błędów składni w WordPress jest edycja plików PHP, takich jak wp-config.php czy functions.php. Zazwyczaj wystarczy zidentyfikować i poprawić błąd w kodzie, aby strona znowu zaczęła działać prawidłowo.

Najbezpieczniej jest edytować pliki PHP przy użyciu SFTP (Secure File Transfer Protocol). Do tego celu potrzebny jest klient SFTP, takie jak FileZilla czy WinSCP. Logujemy się na serwer, następnie przechodzimy do katalogu z plikami WordPress i otwieramy plik z błędem.

Komunikat o błędzie zazwyczaj podaje, w którym pliku i w którym wierszu znajduje się błąd. Przykładowy komunikat mógłby wyglądać tak:

"Parse error: syntax error, unexpected '}' in /public_html/wordpress/wp-content/themes/my-theme/functions.php on line 278".

W takim przypadku otwieramy plik functions.php i przechodzimy do wiersza 278, aby zidentyfikować i poprawić błąd.

2. Wykorzystanie wtyczki “WP Debug”

Jedną z opcji, które mogą pomóc w naprawie błędu składni, jest wtyczka “WP Debug”. Wtyczka ta umożliwia wyświetlanie informacji o błędach PHP bezpośrednio na Twojej stronie WordPress.

Aby skorzystać z tej wtyczki, musisz ją najpierw zainstalować i aktywować. Następnie, w panelu administracyjnym WordPress, przejdź do ustawień wtyczki “WP Debug”. Włącz tryb debugowania, a informacje o błędach będą wyświetlane na Twojej stronie.

Pamiętaj jednak, że ta metoda ma swoje ograniczenia. Jeśli błąd składni powoduje, że strona nie ładuje się w ogóle, nie będziesz mógł zainstalować ani aktywować wtyczki.

3. Użycie narzędzia “PHP Error Log”

Inną możliwością jest użycie narzędzia “PHP Error Log”. To narzędzie znajduje się w panelu administracyjnym serwera (np. cPanel) i pozwala na przeglądanie logów błędów PHP.

Za pomocą “PHP Error Log” możemy sprawdzić, które pliki PHP generują błędy. Informacje te mogą pomóc w identyfikacji i naprawie błędów składni.

4. Skorzystanie z trybu debugowania WordPress

W WordPress istnieje wbudowany tryb debugowania, który pozwala na identyfikowanie błędów PHP. Aby go włączyć, musimy edytować plik wp-config.php.

Przy użyciu klienta SFTP otwieramy plik wp-config.php i szukamy linii: “// That’s all, stop editing! Happy blogging.”. Tuż powyżej tej linii dodajemy:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Te linie włączają tryb debugowania i zapisują informacje o błędach do pliku debug.log, który znajduje się w katalogu /wp-content.

5. Przywrócenie poprzedniej wersji pliku

Jeżeli błąd składni pojawił się po wprowadzeniu zmian do pliku PHP, najprostszym rozwiązaniem może być przywrócenie poprzedniej wersji tego pliku. Jeżeli korzystasz z systemu kontroli wersji, takiego jak Git, możesz łatwo cofnąć ostatnie zmiany.

Jeżeli nie korzystasz z takiego systemu, warto regularnie tworzyć kopie zapasowe plików WordPress. Wówczas w razie problemów zawsze będziesz mógł przywrócić działającą wersję strony.

Wszystkie te metody powinny pomóc Ci naprawić błąd składni w WordPress. Pamiętaj jednak, że zawsze warto zwrócić się o pomoc do profesjonalistów, zwłaszcza jeżeli nie czujesz się pewnie przy edycji plików PHP.

Sprawdź ofertę 1500+ wtyczek i szablonów Premium WordPress!