Kliknąłeś „Aktualizuj” przy wtyczce, motywie albo samym WordPressie i zamiast strony masz biały ekran albo komunikat o błędzie krytycznym. Wygląda to groźnie, a zwykle schodzi w kilkanaście minut, jeśli wiadomo, gdzie zajrzeć. Przy stronach, którymi się opiekuję, idę zawsze w tej samej kolejności i opisuję ją niżej: od maila, który WordPress wysyła sam, przez wyłączenie wtyczek bez wchodzenia do panelu, po powrót do kopii, gdy nic innego nie pomaga.
Co się właściwie stało
Biały ekran i komunikat „wystąpił błąd krytyczny” znaczą zwykle to samo: kod PHP którejś wtyczki albo motywu zatrzymał się na błędzie i WordPress nie może złożyć strony. Po aktualizacji najczęściej winna jest nowa wersja wtyczki, która gryzie się z inną wtyczką albo z motywem, wtyczka wymagająca nowszego PHP, niż ma serwer, przerwana aktualizacja albo za mało pamięci. Dobra wiadomość jest taka, że treści, zamówienia i zdjęcia są zwykle całe. Zepsuty jest tylko kod, który je wyświetla.
Zaczynam od skrzynki administratora
Od kilku lat WordPress przy błędzie krytycznym sam wysyła na adres administratora maila z informacją, która wtyczka albo który motyw zawinił, i z linkiem do trybu odzyskiwania. Dokumentacja WordPressa o typowych błędach też każe zacząć od sprawdzenia, czy taki mail przyszedł. Link pozwala wejść do panelu z wyłączoną wadliwą wtyczką, a potem ją zaktualizować, zamienić albo usunąć. Zaglądam też do spamu. Bywa, że adres administratora to skrzynka byłego pracownika albo agencji i mail poszedł właśnie tam, a wtedy po awarii zmieniam ten adres na firmowy.
Wtyczki wyłączam bez panelu
Gdy maila nie ma, wchodzę na serwer przez menedżer plików w panelu hostingu albo przez FTP. Dokumentacja radzi zmienić nazwę folderu wp-content/plugins, na przykład na plugins_old. WordPress nie znajdzie wtyczek i uruchomi się bez nich. Jeśli strona wróciła, przywracam nazwę folderu i wyłączam wtyczki po jednej, zmieniając nazwy ich folderów, aż trafię na winną. Prawie zawsze jest to ta aktualizowana jako ostatnia, więc od niej zaczynam.
Potem motyw
Jeśli wtyczki są niewinne, zostaje motyw. Zmieniam nazwę folderu aktywnego motywu w wp-content/themes i WordPress przełącza się na motyw domyślny, o ile jest zainstalowany. Strona wygląda wtedy inaczej, ale panel działa i można przywrócić poprzednią wersję motywu albo go zaktualizować. Przy stronach w Elementorze sprawdzam jeszcze, czy wersje Elementora i Elementora Pro do siebie pasują, bo aktualizacja tylko jednego z nich potrafi rozsypać wygląd.
Co mówi log błędów
Kiedy dalej nie wiem, co jest przyczyną, włączam zapisywanie błędów. W pliku wp-config.php ustawienie WP_DEBUG razem z zapisem do pliku sprawia, że WordPress zapisuje błędy do wp-content/debug.log i nie pokazuje ich odwiedzającym, co krok po kroku opisuje dokumentacja o debugowaniu. W logu jest nazwa wtyczki i linia, w której kod się wysypał. Wiele hostingów ma też własny log błędów PHP w panelu. Po naprawie wyłączam zapisywanie, żeby plik nie rósł i nie zdradzał szczegółów serwera.
Wersja PHP i pamięć
Część awarii bierze się z serwera, a nie z samej aktualizacji. Hosting podniósł wersję PHP i stara wtyczka jej nie obsługuje albo nowa wersja wtyczki chce nowszego PHP, niż masz. W panelu hostingu sprawdzam, jaka wersja jest ustawiona dla strony, i porównuję z wymaganiami wtyczki. Komunikat o wyczerpaniu pamięci w logu znaczy z kolei, że trzeba podnieść limit pamięci dla PHP albo pożegnać ciężką wtyczkę.
Strona zawieszona na „przerwie technicznej”
Osobny przypadek to komunikat, że strona jest chwilowo niedostępna z powodu prac. WordPress na czas aktualizacji tworzy w głównym katalogu plik .maintenance i usuwa go po zakończeniu. Wystarczy zamknąć kartę przeglądarki w złym momencie i plik zostaje, a strona stoi. Usuwam go przez menedżer plików i powtarzam przerwaną aktualizację.
Powrót do kopii
Gdy nic nie pomaga albo sklep traci zamówienia z każdą minutą, przywracam kopię sprzed aktualizacji. Dlatego kopię plików i bazy robię tuż przed każdą większą zmianą, a nie raz w tygodniu, bo kopia sprzed godziny nie kasuje zamówień i wiadomości z całego tygodnia. W sklepie przed przywróceniem spisuję zamówienia, które przyszły już po zrobieniu kopii. Jak robić kopie, z których da się odtworzyć stronę, opisałem we wpisie o kopii strony WordPress.
Awaria, której nie widać od razu
Nie każda awaria wtyczki kończy się białym ekranem. Bywa, że wtyczka koszyka gryzie się z pamięcią podręczną strony. Jej zapytania kończą się błędem i na całej stronie zostaje kursor ładowania, więc strona działa, a wygląda na zawieszoną. W takim przypadku wtyczkę usuwam, a koszyk przejmuje funkcja motywu. Dlatego po każdej aktualizacji przechodzę po stronie jak klient, także na telefonie, i dodaję coś do koszyka albo wysyłam formularz.
Notatka po awarii
Po naprawie zapisuję w kilku zdaniach, co było aktualizowane, jaki był objaw, która wtyczka zawiniła i co pomogło. Przy następnej awarii taka notatka skraca szukanie do minuty, a gdy stroną zaczyna opiekować się ktoś inny, przekazuje wiedzę, której nie ma nigdzie indziej. Jeśli winna była konkretna wersja wtyczki, po kilku dniach sprawdzam, czy autor wydał poprawkę, i dopiero wtedy aktualizuję ponownie. Zgłoszenie na forum wtyczki też pomaga, bo autorzy często nie wiedzą o konflikcie z inną popularną wtyczką.
Jak aktualizuję, żeby strona stała
- Kopia tuż przed aktualizacją, z bazą i plikami.
- Aktualizacje po jednej, żeby było wiadomo, która zepsuła stronę.
- Przy dużym sklepie najpierw na kopii testowej.
- Nigdy w piątek wieczorem ani tuż przed kampanią reklamową.
- Po każdej aktualizacji przejście po stronie: główna, formularz, koszyk, kasa.
- Wtyczki, z których strona nie korzysta, usuwam, bo każda to kolejna rzecz do aktualizowania.
Aktualizacje automatyczne
WordPress potrafi sam instalować aktualizacje bezpieczeństwa i drobne poprawki. Przy prostej stronie wizytówce z kilkoma popularnymi wtyczkami zostawiłbym to włączone, bo luka bez poprawki jest groźniejsza niż rzadka awaria po aktualizacji. Przy sklepie i stronie z wieloma wtyczkami wolę, żeby duże aktualizacje instalował człowiek, który od razu sprawdzi, czy wszystko działa. W obu przypadkach kopia ma się robić sama, codziennie.
Kiedy oddać to komuś
Jeśli po kwadransie dalej nie wiadomo, co się stało, jeśli nie masz dostępu do serwera albo to sklep i każda godzina to stracone zamówienia, przerwałbym eksperymenty na żywej stronie. Zapisz, co było aktualizowane i co już zostało zrobione, bo osobie, która przejmie naprawę, oszczędza to połowę czasu. Aktualizacje i naprawy po nich to część opieki nad stroną, którą opisałem na stronie pomoc IT dla firm.