Prazna stran ne pove, ali napako povzroča vtičnik, predloga ali PHP. Odpravljanje napak WordPress (debug mode) pomaga ugotoviti, kje je vredno iskati težavo, pri napačni nastavitvi pa se lahko tehnične podrobnosti prikažejo tudi obiskovalcem. Zato napake beleži, ne prikazuj jih na spletni strani.

Ni vedno jasno, kaj je treba spremeniti v datoteki wp-config.php in kje je dnevnik. V tem vodniku po korakih prikažemo varno nastavitev WP_DEBUG in WP_DEBUG_LOG, iskanje datoteke debug.log in razumevanje vnosov. Pokažemo tudi, kdaj je vredno preveriti dnevnik napak PHP na gostovanju, na primer če se WordPress sploh ne zažene. Na koncu pregledamo, kako način za odpravljanje napak izklopiš in zakaj je pomembno datoteko dnevnika odstraniti s produkcijske strani. Način debug napake ne popravi, pomaga pa najti njen vir.

Kaj pomeni odpravljanje napak WordPress v načinu debug in kdaj ga uporabiti?

WP_DEBUG je ena od konstant PHP v WordPressu. Ko jo vklopiš, postanejo dostopne informacije za odpravljanje napak, ki pomagajo razumeti, kaj se dogaja med delovanjem spletnega mesta. Odpravljanje napak WordPress (debug mode) je koristno izhodišče, če po napaki ni jasno, ali je prizadet WordPress, predloga ali kateri od vtičnikov.

Vnose v dnevniku obravnavaj kot sled, ne kot dokončno diagnozo. Ime datoteke ali vrstica kode lahko pokaže, kje se je težava pojavila, ne pa nujno, kaj jo je sprožilo. Pri razumevanju sporočila upoštevaj, katero dejanje je bilo pred napako, ali je bila posodobitev in ali je pojav mogoče ponoviti.

Cilj odpravljanja napak je metodično razkriti vir napake. Ta diagnostični postopek prikazujejo tudi osnove razhroščevanja. Ta vodnik se osredotoča na lastno možnost odpravljanja napak WordPressa. Napake povezave s podatkovno bazo in analiza dnevnikov spletnega strežnika sta ločeni temi. Dnevnik napak PHP na gostovanju je lahko koristen, če WordPress še ne pride do točke, ko bi pisal lasten dnevnik.

Pri katerih napakah lahko pomaga WP_DEBUG?

WP_DEBUG lahko pomaga razkriti napake PHP, opozorila in sporočila o zastarelih funkcijah. Ta se lahko pojavijo po posodobitvi ali ob uporabi določene strani, obrazca ali skrbniškega dejanja. Pot do datoteke v dnevniku lahko kaže na vtičnik, predlogo ali datoteko WordPressa.

• Napaka PHP: lahko pomeni, da se je izvajanje kode prekinilo.
• Opozorilo: lahko opozori na del kode, ki lahko pozneje povzroči težave.
• Sporočilo o zastareli funkciji: lahko kaže, da komponenta uporablja starejšo programsko rešitev.

Sporočilo samo po sebi ne dokazuje, da je napako povzročila imenovana komponenta. Lahko se zgodi, da koda vtičnika teče napačno zaradi napake druge komponente. Zapiši, kdaj se je sporočilo pojavilo, katero dejanje mu je predhodilo in katero datoteko natančno imenuje.

Kakšna je razlika med načinom za odpravljanje napak in popravljanjem napak?

WP_DEBUG naredi informacije o napakah vidne, kode pa ne popravi. Odpravljanje napak služi razkrivanju težave. Popravilo je ločen korak, ki pomeni spremembo prizadete kode ali nastavitve. Nato preveri, ali je sprememba odpravila napako in ali ni povzročila nove težave v delovanju.

1. Diagnoza: zabeleži sporočilo o napaki in okoliščine, v katerih se je pojavilo.
2. Sprememba: spreminjaj na podlagi razkritega vzroka, po možnosti v testnem okolju.
3. Preverjanje: ponovi prizadeto dejanje in preveri, ali je napaka izginila.

Pred spremembo datotek ali nastavitev naredi varnostno kopijo, da lahko ob napaki obnoviš prejšnje stanje. Če imaš na voljo testno okolje, spremembo preveri tam, ne neposredno na produkcijskem spletnem mestu, ki ga uporabljajo obiskovalci.

Kako vklopiš način debug WordPress v datoteki wp-config.php?

Nastavitve je treba vnesti v datoteko wp-config.php v glavni mapi WordPressa. Pred spremembo naredi varnostno kopijo datoteke, tako lahko po tipkarski napaki ali napačni nastavitvi obnoviš izvirno različico.

1. Naredi varnostno kopijo. Prenesi trenutno datoteko wp-config.php ali jo kopiraj na varno mesto.
2. Odpri datoteko. V upravitelju datotek gostovanja poišči mapo namestitve WordPressa. V vmesniku cPanel lahko datoteko odpreš in urejaš z upraviteljem datotek. Pri upravljanju gostovanja cPanel pazi, da delaš v mapi pravega spletnega mesta.
3. Preveri obstoječe nastavitve. Poišči imena WP_DEBUG, WP_DEBUG_LOG in WP_DEBUG_DISPLAY. Če je katera že navedena, spremeni njeno vrednost, ne dodajaj nove definicije.
4. Vstavi konfiguracijo. Vrstice naj pridejo pred komentar WordPressa, ki zaključuje urejanje in običajno vsebuje besedilo »That’s all, stop editing!«. Po shranjevanju naloži stran in preveri njeno delovanje.

Katere nastavitve WP_DEBUG je vredno uporabljati skupaj?

WP_DEBUG vklopi način za odpravljanje napak WordPress. WP_DEBUG_LOG omogoči pisanje sporočil za odpravljanje napak v datoteko, WP_DEBUG_DISPLAY pa določa, ali se prikažejo na spletni strani. Na produkcijski strani prikaz na zaslonu onemogoči. To lahko izklopiš tudi z nastavitvijo PHP display_errors.

define( 'WP_DEBUG', true );

define( 'WP_DEBUG_LOG', true );

define( 'WP_DEBUG_DISPLAY', false );

@ini_set( 'display_errors', 0 );

Ta konfiguracija napake beleži, obiskovalcem pa jih ne prikaže. Uradni vodnik za odpravljanje napak WordPress navaja več podrobnosti o delovanju konstant in beleženju.

Kako varno urediš datoteko wp-config.php?

Pred shranjevanjem preveri podpičja in narekovaje ter ali vsaka vrstica define() nastavi ločeno konstanto. Iste konstante ne določi dvakrat, ker lahko to povzroči opozorilo ali nepredvidljivo delovanje. Po spremembi poskusi odpreti spletno mesto in tudi skrbniški vmesnik WordPressa.

Pri odpravljanju napak WordPress (debug mode) je beleženje varnejša rešitev kot neposreden prikaz podrobnih sporočil PHP. Če stran po shranjevanju konfiguracijske datoteke javi napako, obnovi shranjeno različico in spremembe preveri znova.

Kje najdeš datoteko debug.log in kako bereš vnose?

Če si beleženje omogočil z nastavitvijo WP_DEBUG_LOG, WordPress datoteko debug.log privzeto ustvari v mapi wp-content namestitve. V upravitelju datotek gostovanja odpri glavno mapo WordPressa in pojdi v mapo wp-content. Poišči datoteko in jo prenesi ali odpri v besedilnem pogledu. Pri poti dnevnika po meri jo išči na tistem mestu.

Preden pregledaš vnose, zapiši, kdaj se je napaka pojavila in med katerim dejanjem. Zabeleži na primer, če se po posodobitvi vtičnika ob odprtju strani tega vtičnika prikaže prazna stran. Nato poišči vrstice dnevnika blizu tega časa. Pomembno povezavo lahko pokažejo tudi vnosi pred napako in po njej.

Katero sporočilo o napaki je lahko najpomembnejša sled?

Skupaj preglej vrsto napake, pot do prizadete datoteke in navedeno številko vrstice. V imenu datoteke se lahko pojavi mapa vtičnika ali predloge, številka vrstice pa pokaže, kje v tej datoteki je sporočilo nastalo. Čas napake in pot do datoteke skupaj zožita preiskavo. To še ne dokazuje, da je ta komponenta napačna. Opozorilo ali vnos o zastareli funkciji ne ustavi nujno strani.

O splošnem delovanju beleženja sporočil PHP obvešča dokumentacija o beleženju napak PHP. Dnevnik WordPressa ni enak dnevnikom spletnega strežnika. Ta del se osredotoča na razumevanje datoteke debug.log, podrobna analiza dnevnikov strežnika je ločena preiskava.

Kako ločiš simptom od možnega sprožilnega vzroka?

Čas napake primerjaj z nedavnimi spremembami vtičnikov ali predloge, posodobitvami in spremembami nastavitev. Če je v dnevniku pot do vtičnika, zapiši, ali se je napaka pojavila po njegovi posodobitvi ali uporabi. Komponenta, imenovana v datoteki, je lahko prizadeta, vendar en sam vnos v dnevniku ne dokazuje vzročne povezave.

Domnevo preveri s preverjenim testom, po možnosti v testnem okolju, in naenkrat naredi le eno spremembo. Tako ugotoviš, ali je simptom povezan s to spremembo. Pri odpravljanju napak WordPress (debug mode) sledi v dnevniku primerjaj s ponovljivim vedenjem, ne izpeljuj zanesljivega sklepa iz ene same vrstice.

Kako preiščeš napako, ne da bi razkril podatke?

Dnevnik lahko vsebuje koristne tehnične podatke, poti in podrobnosti, ki razkrivajo strežniško okolje. Na produkcijski spletni strani zato sporočil PHP ne prikazuj obiskovalcem. Vrednost WP_DEBUG_DISPLAY naj bo false, napake pa beleži v datoteko. Če imaš na voljo testno okolje, napako izzovi tam, tako je manj verjetno, da boš motil obiskovalce pri uporabi spletnega mesta.

Sledi temu vrstnemu redu in na koncu preiskave vrni nastavitve za odpravljanje napak:

1. Naredi varnostno kopijo. Pred spremembo konfiguracije in prizadetih datotek shrani trenutno stanje.
2. Omogoči beleženje. Nastavi pisanje napak v datoteko in onemogoči prikaz na zaslonu.
3. Ponovi napako. Izvedi dejanje, pri katerem se napaka pojavi, in zapiši čas.
4. Preglej dnevnik. Poišči vnos blizu tega časa in zapiši sporočilo, pot do datoteke ter prizadeto komponento.
5. Zaključi preiskavo. Vrni nastavitve za odpravljanje napak in po varni shranitvi potrebnih informacij izbriši datoteko dnevnika s produkcijskega spletnega mesta.

Kaj storiti, če se v dnevniku pojavi ime vtičnika ali predloge?

Zapiši ime komponente, celotno sporočilo o napaki in okoliščine, v katerih se je napaka pojavila. Primerjaj jih z nedavnimi spremembami, vendar imena datoteke samega po sebi ne štej za dokaz. Če imaš na voljo testno okolje, tam preveri, ali izklop ali posodobitev navedenega vtičnika ali predloge spremeni simptom. Kode ne briši in ne prepisuj na podlagi ene same vrstice dnevnika.

Kako zaščitiš informacije za odpravljanje napak?

Tudi med diagnozo imej prikaz napak na zaslonu izklopljen. Vsebine dnevnika ne kopiraj na javni forum ali v vmesnik, do katerega lahko dostopa kdor koli. Če moraš deliti odlomek, iz njega prej odstrani osebne podatke ali podatke, ki prepoznajo okolje, na primer celotne poti. Po preiskavi preveri, ali dnevnik še potrebuješ, in ne puščaj, da se vnosi na produkcijskem spletnem mestu še naprej kopičijo.

Ob zaključku odpravljanja napak WordPress (debug mode) preveri spletno mesto in skrbniški vmesnik ter se prepričaj, da je odpravljanje napak izklopljeno. Za dodatne informacije o nastavitvah gostovanja in WordPressa je koristno izhodišče tudi baza znanja aWh.

Kako izklopiš način debug in kdaj preveriš okolje gostovanja?

Ob zaključku odpravljanja napak ne preveri le, ali je sporočilo o napaki izginilo. Vrni začasne nastavitve, s produkcijskega spletnega mesta odstrani datoteko dnevnika in znova preizkusi prizadeto funkcijo. Tako podatki, uporabljeni za diagnostiko, ne ostanejo po nepotrebnem dostopni, hkrati pa preveriš, ali je spletno mesto spet začelo delovati običajno.

1. Odpri datoteko wp-config.php. Naredi njeno varnostno kopijo, nato poišči konstante, dodane za odpravljanje napak.
2. Izklopi odpravljanje napak. Vrednost WP_DEBUG nastavi na false. Preveri tudi nastavitvi WP_DEBUG_LOG in WP_DEBUG_DISPLAY, da ne ostane aktivno beleženje ali prikaz na zaslonu.
3. Shrani spremembo in preveri stran. Znova naloži prizadeto stran in skrbniški vmesnik. Ponovi tudi dejanje, ki je prej povzročalo napako.
4. Odstrani dnevnik, ki ga ne potrebuješ več. Ko je diagnoza končana, s produkcijskega spletnega mesta izbriši datoteko debug.log, da njena vsebina ne ostane tam brez razloga.

Katera preverjanja opraviti ob zaključku odpravljanja napak?

Preveri, ali se na spletni strani ne prikazuje napaka PHP ali tehnično opozorilo. Znova preglej spremenjeno konfiguracijo, zlasti vrednosti konstant in morebitne podvojene definicije. Nato preizkusi funkcijo, ki je prej delovala napačno, na primer prijavo ali nalaganje prizadete strani. WP_DEBUG pomaga pri diagnozi, sam po sebi pa ne zagotavlja, da je napaka odpravljena.

Kdaj sta pomembna gostovanje WordPress in baza znanja?

Če v dnevniku najdeš predvsem sledi, povezane z izvajalnim okoljem, loči nastavitve WordPressa od okoliščin na strani gostovanja. Takrat je lahko naslednji korak pregled okolja gostovanja, ne naključno spreminjanje datotek WordPressa. Podrobna analiza dnevnikov na strani strežnika zahteva ločeno preiskavo. Kje je na gostovanjih cPanel pri aWh dnevnik napak PHP in kako WordPress dnevnik piše na mesto, ki ni dostopno s spleta, prikazuje članek baze znanja o načinu za odpravljanje napak.

V paketu WordPress gostovanja aWh je na voljo vnaprej nameščen WordPress, WordPress Toolkit Deluxe pa podpira upravljanje WordPressa. To so orodja, ki pomagajo pri upravljanju, ne samodejni popravki napak. Za več informacij o nastavitvah so lahko praktično izhodišče članki baze znanja. Po zaključenem odpravljanju napak WordPress (debug mode) delovanje strani preveri tudi z dejanskimi postopki uporabe.

Ohrani varno delovanje tudi po odpravljanju napak

Odpravljanje napak WordPress (debug mode) je koristno orodje za preiskavo, vendar ga imej vklopljenega le, dokler potrebuješ vnose v dnevniku. Po zaključku preveri delovanje strani in razmisli, kako preprečiti, da bi poznejša posodobitev ali sprememba povzročila nepričakovan zastoj. Dosledno testiranje ti lahko pomaga, da ob novi napaki hitreje določiš smer preiskave.

Tudi različica PHP je del okolja, v katerem teče WordPress. Z različicami PHP, ki jih lahko izbiraš v paketih gostovanja, okolje prilagodiš zahtevam spletnega mesta. Ob spremembi nastavitve zapiši trenutno različico in prizadete komponente. Tako pozneje lažje primerjaš delujočo konfiguracijo s tisto, ki povzroča napako.

Rezultat odpravljanja napak je vredno na kratko dokumentirati. Zapiši, katero dejanje je sprožilo napako, v kakšnih okoliščinah se je pojavila in po kateri spremembi se je delovanje spremenilo. Ta zapis ti lahko pozneje pomaga ločiti vpliv nastavitev WordPressa od vpliva okolja gostovanja.

Oglej si WordPress gostovanje aWh in izberi okolje, ki ustreza potrebam tvoje strani. Skrbno odpravljanje napak in varen zaključek sta dobra osnova za samozavestnejše upravljanje WordPressa.

Pogosta vprašanja o odpravljanju napak WordPress

Ali je mogoče način debug WordPress vklopiti v skrbniškem vmesniku?

V privzetem skrbniškem vmesniku WordPressa ni vgrajenega stikala za način odpravljanja napak. Nastavitev je običajno treba opraviti v datoteki wp-config.php, z ustreznim dostopom do datotek. Nekateri vtičniki lahko ponujajo lasten vmesnik, vendar so to ločena orodja, ne osnovne funkcije WordPressa. Če konfiguracijske datoteke ne moreš urejati, prosi za pomoč skrbnika spletnega mesta.

Ali WP_DEBUG samodejno pokaže, kateri vtičnik povzroča napako?

Ne nujno. Ime vtičnika v sporočilu o napaki lahko kaže, da se je napaka pojavila tam, ne dokazuje pa, da je komponenta sama odgovorna. Lahko se na primer zgodi, da vtičnik obdeluje napačne podatke, ki mu jih je posredoval drug vtičnik. Zapiši prizadeto funkcijo in datoteko iz dnevnika, nato v testnem okolju preveri, ali se simptom ob izklopu komponente spremeni.

Kaj pomeni sporočilo PHP notice ali deprecated v dnevniku WordPressa?

notice je običajno informativno sporočilo o delovanju kode in samo po sebi ne ustavi nujno strani. Sporočilo deprecated opozarja, da koda uporablja funkcijo ali rešitev PHP, ki je označena kot zastarela. Poišči, na katero datoteko se nanaša, nato preveri, ali se pojavi hkrati z dejansko napako spletnega mesta. Opozorilo samo po sebi ne pomeni, da stran deluje napačno.

Ali lahko način WP_DEBUG vpliva na zmogljivost spletne strani WordPress?

Da, odpravljanje napak lahko vpliva na zmogljivost, zlasti če nastaja veliko sporočil in jih je treba nenehno pisati v datoteko. Prikaz na zaslonu lahko poslabša tudi izkušnjo obiskovalcev, če na stran pridejo tehnična sporočila. Na produkcijskem spletnem mestu zato odpravljanje napak uporabljaj le v času potrebne preiskave in ga izklopi, ko ga ne potrebuješ več.

Ali je mogoče način debug WordPress uporabiti tudi pri namestitvi z več spletnimi mesti?

Da, vendar pri namestitvi WordPress z več spletnimi mesti upoštevaj, da wp-config.php upravlja konfiguracijo celotne namestitve. Nastavitev WP_DEBUG v njej zato običajno velja za celotno omrežje, ne le za eno podstran. Pri razumevanju vnosov v dnevniku zapiši, na katerem podspletnem mestu in pri katerem dejanju se je napaka pojavila. Ločene namestitve imajo lastne konfiguracijske datoteke.

Zakaj se datoteka debug.log ne ustvari po vklopu WP_DEBUG_LOG?

Datoteka lahko manjka iz več razlogov. Preveri, ali je aktiven tudi WP_DEBUG, nato izzovi dejanje, ki ustvari sporočilo, ki ga je mogoče zabeležiti. Neuspešno beleženje lahko povzroči tudi to, da WordPress ne more pisati v ciljno mapo ali da je pot dnevnika nastavljena na vrednost po meri. Če se sistem ustavi še pred zagonom WordPressa, napaka ne pride nujno v to datoteko.

Ali sta način debug WordPress in razvijalska konzola brskalnika isto?

Ne. Odpravljanje napak WordPress daje informacije predvsem o delovanju PHP na strani strežnika. Z razvijalsko konzolo brskalnika lahko med drugim preiskuješ napake JavaScript, omrežne zahteve in prikaz strani v brskalniku. Če se na primer gumb ne odziva, ti sled lahko da konzola; če se pri nalaganju strani zmoti proces PHP, je lahko koristnejši dnevnik WordPressa.

• wordpress
• php
• nadzor
• vodniki