WordPress bijeli ekran: pročitajte grešku prije nego što išta mijenjate

„Kritična greška” ili bijeli ekran: isti kvar

Prazna stranica najčešće je fatalna greška PHP-a: datoteka stranice zatražila je nešto nemoguće, a izvršavanje je stalo prije nego što je išta prikazano. Od inačice 5.2 WordPress presreće takve greške: umjesto prazne stranice prikazuje „Pojavila se kritična greška na vašoj web-stranici.” i šalje e-poruku na administratorsku adresu e-pošte stranice.

Stranica ostaje potpuno bijela u nekoliko slučajeva: starija inačica WordPressa, greška nastala prije učitavanja tog mehanizma, konstanta WP_DISABLE_FATAL_ERROR_HANDLER postavljena na true ili dodatak za predmemoriju koji poslužuje praznu stranicu spremljenu za vrijeme kvara. Postupak koji slijedi vrijedi za sve te slučajeve.

Tri koraka mogu pričekati dok ne pročitate grešku: ponovna instalacija WordPressa, brisanje dodataka i vraćanje stare sigurnosne kopije. Svaki od njih može izbrisati postavke ili nedavne podatke, dok poruka o grešci obično kaže koju komponentu treba isključiti, bez ikakvog gubitka.

Prečac: režim oporavka

Kada WordPress presretne grešku, na administratorsku adresu e-pošte stranice šalje poruku s naslovom „[Naziv stranice] Vaša web-stranica ima tehničku poteškoću”. Poruka imenuje dodatak ili temu o kojoj je riječ i sadrži poveznicu koja administraciju otvara u režimu oporavka.

• U tom je režimu neispravna komponenta pauzirana samo za vas: vaši posjetitelji i dalje vide grešku.
• U izborniku Dodaci ili Izgled > Teme deaktivirajte navedenu komponentu, a zatim u alatnoj traci administracije kliknite „Izlaz iz režima oporavka”.
• Poveznica vrijedi 24 sata, a WordPress šalje najviše jednu takvu e-poruku dnevno. Ako e-poruka ne stigne, pogledajte neželjenu poštu, a zatim prijeđite na sljedeći postupak.

Pročitajte grešku: zapis za otklanjanje grešaka

Spojite se na stranicu putem SFTP-a ili upravitelja datoteka pružatelja hostinga, otvorite wp-config.php u korijenskoj mapi i redak define( 'WP_DEBUG', false ); zamijenite ovim četirima redcima:

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

Redci se postavljaju iznad komentara koji zatvara dio datoteke namijenjen izmjenama (/* That's all, stop editing! Happy publishing. */). Ponovno učitajte stranicu s greškom, a zatim otvorite wp-content/debug.log. Postavka WP_DEBUG_DISPLAY na false zadržava poruke u datoteci, izvan stranice koju vide vaši posjetitelji.

Ako debug.log ostane prazan ili se ne pojavi, PHP je grešku zapisao izravno: potražite datoteku error_log u korijenskoj mapi stranice ili u wp-admin, ili odjeljak sa zapisima grešaka u upravljačkoj ploči pružatelja hostinga.

Što poruka kaže i koji korak joj odgovara

Fatalna greška stane u jedan redak: vrsta greške, njezin opis, zatim in i puna putanja datoteke te broj retka. Putanja je najkorisnija informacija: wp-content/plugins/naziv/ označava dodatak, a wp-content/themes/naziv/ temu.

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

Isključite neispravnu komponentu bez administracije

Putem SFTP-a ili upravitelja datoteka

Preimenujte mapu dodatka navedenog u poruci, na primjer wp-content/plugins/naziv-dodatka u naziv-dodatka.off. WordPress više ne pronalazi dodatak i prestaje ga učitavati; njegove postavke ostaju spremljene u bazi podataka, a WordPress ga deaktivira pri sljedećem otvaranju zaslona s dodacima.

Kod teme preimenovanje njezine mape u wp-content/themes ponovno otvara administraciju, ali posjetitelji vide praznu stranicu dok nijedna tema nije aktivna. Odmah otvorite Izgled > Teme: WordPress javlja „Aktivna tema je oštećena. Povratak na izvornu temu.” i vraća se na instaliranu zadanu temu.

S WP-CLI-jem

wp plugin list --status=active
wp plugin deactivate naziv-dodatka
wp theme list
wp theme activate twentytwentyfive

Prva naredba bilježi popis aktivnih dodataka, koristan prije svake skupne deaktivacije. Ako se i sam WP-CLI zaustavi na grešci, naredbi dodajte --skip-plugins --skip-themes: tada se pokreće bez učitavanja dodataka i teme. Dodaci iz mape wp-content/mu-plugins svejedno se učitavaju; ako greška dolazi od jednog od njih, preimenujte njegovu datoteku.

Kada poruka ne imenuje nijednu komponentu, wp plugin deactivate --all deaktivira sve dodatke. Ako se stranica vrati, ponovno ih aktivirajte jedan po jedan i nakon svakog ponovno učitajte stranicu: posljednji aktiviran prije povratka greške upravo je onaj koji je uzrokuje.

Kada se stranica vrati

1. Vratite define( 'WP_DEBUG', false ); i uklonite WP_DEBUG_LOG iz wp-config.php.
2. Izbrišite wp-content/debug.log: smješten u mapi dostupnoj s weba, može ga pročitati svatko, a sadrži putanje poslužitelja.
3. Ažurirajte ili zamijenite komponentu o kojoj je riječ, nakon što pročitate njezin popis izmjena.
4. Ispraznite predmemoriju dodatka za predmemoriju, kao i predmemoriju pružatelja hostinga ako je ima.
5. Za sljedeći put: ažuriranja isprobajte na kopiji stranice prije nego što ih primijenite na živoj stranici.