WordPress prikazuje belo stran: preberite napako, preden kar koli spremenite

„Kritična napaka“ ali bela stran: ista okvara

Prazna stran je skoraj vedno usodna napaka PHP (fatal error): datoteka na strani je zahtevala nekaj nemogočega in izvajanje se je ustavilo, preden se je kar koli prikazalo. Od različice 5.2 WordPress te napake prestreže: namesto prazne strani prikaže „Na spletišču je prišlo do kritične napake.“ in pošlje e-poštno sporočilo na naslov skrbnika strani.

Stran ostane povsem bela v nekaj primerih: starejša različica WordPressa, napaka, ki nastane, preden se ta varovalka naloži, konstanta WP_DISABLE_FATAL_ERROR_HANDLER, nastavljena na true, ali vtičnik za predpomnjenje, ki streže prazno stran, shranjeno med okvaro. Spodnji postopek deluje v vseh teh primerih.

Trije koraki lahko počakajo, dokler ne preberete napake: ponovna namestitev WordPressa, brisanje vtičnikov, obnovitev stare varnostne kopije. Vsak lahko izbriše nastavitve ali nedavne podatke, sporočilo o napaki pa vam navadno natančno pove, kateri sestavni del izklopiti, brez kakršne koli izgube.

Bližnjica: obnovitveni način

Ko WordPress napako prestreže, na naslov skrbnika strani pošlje sporočilo z zadevo „[Ime strani] Vaše spletišče ima tehnične težave“. Sporočilo navede vtičnik ali temo, ki napako povzroča, in vsebuje povezavo, ki nadzorno ploščo odpre v obnovitvenem načinu.

• V tem načinu je okvarjeni sestavni del začasno ustavljen samo za vas: vaši obiskovalci še vedno vidijo napako.
• V Vtičniki ali Videz > Teme deaktivirajte sestavni del, naveden v sporočilu, nato v skrbniški vrstici kliknite „Izhod iz obnovitvenega načina“.
• Povezava velja 24 ur, WordPress pa pošlje največ eno takšno sporočilo na dan. Če ne pride, preverite mapo vsiljene pošte, nato preidite na naslednji postopek.

Preberite napako: dnevnik razhroščevanja

Povežite se s stranjo prek SFTP ali z upraviteljem datotek vašega ponudnika gostovanja, v korenski mapi odprite wp-config.php in vrstico define( 'WP_DEBUG', false ); zamenjajte s temi štirimi vrsticami:

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

Sodijo nad vrstico /* That's all, stop editing! Happy publishing. */. Znova naložite okvarjeno stran, nato odprite wp-content/debug.log. Nastavitev WP_DEBUG_DISPLAY na false sporočila zadrži v datoteki, na strani, ki jo vidijo obiskovalci, pa se ne prikažejo.

Če debug.log ostane prazen ali se ne pojavi, je napako zabeležil PHP sam: poiščite datoteko error_log v korenski mapi strani ali v wp-admin ali razdelek z dnevniki napak na nadzorni plošči gostovanja.

Kaj pove sporočilo in kateri popravek sodi zraven

Usodna napaka je zapisana v eni vrstici: vrsta napake, njen opis, nato in, ki mu sledita celotna pot do datoteke in številka vrstice. Pot je najuporabnejši del: wp-content/plugins/ime/ kaže na vtičnik, wp-content/themes/ime/ na temo.

define( 'WP_MEMORY_LIMIT', '256M' );

Okvarjeni sestavni del izklopite brez nadzorne plošče

Prek SFTP ali z upraviteljem datotek

Preimenujte mapo vtičnika, navedenega v sporočilu, na primer wp-content/plugins/ime-vticnika v ime-vticnika.off. WordPress vtičnika ne najde več in ga preneha nalagati; njegove nastavitve ostanejo shranjene v podatkovni zbirki, WordPress pa ga deaktivira, ko naslednjič odprete zaslon Vtičniki.

Pri temi preimenovanje njene mape v wp-content/themes vrne dostop do nadzorne plošče, vendar obiskovalci vidijo prazno stran, dokler ni aktivna nobena tema. Takoj odprite Videz > Teme: WordPress zazna, da je aktivna tema poškodovana, in preklopi na nameščeno privzeto temo.

Z WP-CLI

wp plugin list --status=active
wp plugin deactivate ime-vticnika
wp theme list
wp theme activate twentytwentyfive

Prvi ukaz zabeleži, kateri vtičniki so aktivni, kar je koristno imeti pred vsakim množičnim deaktiviranjem. Če se tudi WP-CLI ustavi na napaki, ukazu dodajte --skip-plugins --skip-themes, da se zažene brez nalaganja vtičnikov in teme. Vtičniki v wp-content/mu-plugins se vseeno naložijo; če napako povzroča eden od njih, preimenujte njegovo datoteko.

Kadar sporočilo ne navaja nobenega sestavnega dela, wp plugin deactivate --all izklopi vse vtičnike. Če stran spet deluje, jih aktivirajte enega za drugim in vmes znova naložite stran: zadnji, ki ste ga aktivirali, preden se napaka vrne, je krivec.

Ko stran spet deluje

1. V wp-config.php znova nastavite define( 'WP_DEBUG', false ); in odstranite WP_DEBUG_LOG.
2. Izbrišite wp-content/debug.log: ker je v mapi, dostopni s spleta, ga lahko prebere kdor koli, vsebuje pa poti na strežniku.
3. Posodobite ali zamenjajte sestavni del, ki je napako povzročil, potem ko ste prebrali njegov dnevnik sprememb.
4. Izpraznite predpomnilnik vtičnika za predpomnjenje in predpomnilnik ponudnika gostovanja, če ga ima.
5. Za naslednjič: posodobitve preizkusite na kopiji strani, preden jih uveljavite na živi strani.