{"id":230774,"date":"2022-12-04T16:40:00","date_gmt":"2022-12-04T13:40:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=230774"},"modified":"2022-12-04T16:40:34","modified_gmt":"2022-12-04T13:40:34","slug":"wordpressin-virhelokien-lukeminen-ja-ymmaertaeminen-osa-1","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/fi\/wordpressin-virhelokien-lukeminen-ja-ymmaertaeminen-osa-1\/","title":{"rendered":"WordPressin virhelokien lukeminen ja ymm\u00e4rt\u00e4minen, osa 1"},"content":{"rendered":"\n

Samalla kun tutkimme edelleen, mit\u00e4 tarkoittaa olla riippumaton WordPress-kehitt\u00e4j\u00e4<\/a><\/strong>, tarvittavia ty\u00f6kaluja ja erilaisia \u200b\u200bstrategioita, jotka voivat parantaa osaamistamme, olen k\u00e4ynyt l\u00e4pi erilaisia \u200b\u200bvakioita, laajennuksia ja ty\u00f6kaluja, jotka auttavat meit\u00e4.<\/p>\n

Jos olet vain t\u00f6rm\u00e4nnyt t\u00e4h\u00e4n viestiin, suosittelen tutustumaan oppaani alkuper\u00e4isiin WordPress-virheenkorjausty\u00f6kaluihin<\/a><\/strong> sek\u00e4 sarjan t\u00e4h\u00e4n menness\u00e4 oleviin muihin viesteihin.<\/a><\/strong><\/p>\n

Loppujen lopuksi pid\u00e4n t\u00e4rke\u00e4n\u00e4, ett\u00e4 me kaikki ty\u00f6skentelemme samalla pohjalla \u2013 tai jollain l\u00e4heisesti liittyv\u00e4ll\u00e4 \u2013 kun k\u00e4ymme t\u00e4t\u00e4 tietoa l\u00e4pi.<\/p>\n

\"WordPressin<\/a><\/p>\n

Loppujen lopuksi Xdebugin<\/a><\/strong> kaltaisen ty\u00f6kalun k\u00e4ytt\u00f6 on v\u00e4ltt\u00e4m\u00e4t\u00f6nt\u00e4, mutta meid\u00e4n on pyritt\u00e4v\u00e4 siihen (uteliaisille kirjoitin lyhyen oppaan<\/a><\/strong> t\u00e4st\u00e4 hieman yli vuosi sitten).<\/p>\n

Aloitetaan nyt kuitenkin perusasioista. Edellisess\u00e4 viestiss\u00e4 poistuin seuraavalla lausunnolla:<\/p>\n

\n

Seuraavassa viestiss\u00e4 alamme tarkastella, mit\u00e4 tarvitaan WordPressin luoman virhelokin tutkimiseen ja kuinka ymm\u00e4rt\u00e4\u00e4 n\u00e4kem\u00e4mme tiedot.<\/p>\n<\/blockquote>\n

Ja sit\u00e4 haluan tarkastella t\u00e4n\u00e4\u00e4n, koska jos ei muuta, se antaa sinulle jotain k\u00e4yt\u00e4nn\u00f6llist\u00e4, josta voit ty\u00f6skennell\u00e4.<\/p>\n

WordPressin virhelokien ymm\u00e4rt\u00e4minen, osa 1<\/h2>\n

Ennen kuin menen liian pitk\u00e4lle t\u00e4h\u00e4n, haluan k\u00e4sitell\u00e4 yht\u00e4 kysymyst\u00e4, jonka sivuston j\u00e4sen on esitt\u00e4nyt.<\/p>\n

Nimitt\u00e4in minulta kysyttiin:<\/p>\n

\n

Milloin aiomme tarkastella oliokeskeisi\u00e4 periaatteita?<\/p>\n<\/blockquote>\n

Vaikka olen k\u00e4sitellyt t\u00e4t\u00e4 hieman aiemmassa sarjassa<\/a><\/strong>, yrit\u00e4n k\u00e4sitell\u00e4 sit\u00e4 tarkemmin my\u00f6hemmin t\u00e4ss\u00e4 sarjassa.<\/p>\n

Aloitetaan kuitenkin virhelokien tarkasteleminen t\u00e4m\u00e4n j\u00e4lkeen.<\/p>\n

Vakioiden m\u00e4\u00e4ritt\u00e4minen<\/h3>\n

Jos et ole m\u00e4\u00e4ritt\u00e4nyt vakioita wp-config.php-<\/strong> tiedostossasi, suosittelen, ett\u00e4 teet sen nyt, koska se antaa sinulle parhaan mahdollisen tarkkuuden tutkiessasi mahdollisia ongelmia.<\/p>\n

Jos et ole perill\u00e4, muista lukea t\u00e4m\u00e4 viesti<\/a><\/strong> (ja jos olet, varmista, ett\u00e4 seuraavat vakiot<\/a><\/strong> on m\u00e4\u00e4ritetty asetustiedostossasi):<\/p>\n

<?php\ndefine( 'WP_DEBUG', true );\ndefine( 'WP_DEBUG_LOG', true );\ndefine( 'WP_DEBUG_DISPLAY', true );\n@ini_set( 'display_errors', 1 );\ndefine( 'SCRIPT_DEBUG', true );\ndefine( 'SAVEQUERIES', true );<\/code><\/pre>\n
Kun ne ovat paikoillaan, sinulla on kaikki mit\u00e4 tarvitset n\u00e4hd\u00e4ksesi tiedot n\u00e4yt\u00f6ll\u00e4, mutta my\u00f6s WordPressin luomassa virheenkorjauslokissa.<\/p>\n
Miss\u00e4 loki on?<\/h3>\n
T\u00e4m\u00e4 voi vaihdella ymp\u00e4rist\u00f6si luonteesta riippuen; Kuitenkin useimmissa tapauksissa l\u00f6yd\u00e4t debug.log<\/strong> – osoitteen wp-sis\u00e4lt\u00f6hakemistosta, joka sijaitsee<\/strong> laajennusten<\/strong>, teemojen<\/strong> ja lataushakemistojen<\/strong> yl\u00e4puolella .<\/p>\n
\"WordPressin<\/a><\/p>\n
Kuten yll\u00e4 olevan kuvakaappauksen esikatselusta n\u00e4et, virheenkorjaustiedostossani on paljon sis\u00e4lt\u00f6\u00e4. Tarkastellaan sit\u00e4 tarkemmin seuraavassa osiossa sek\u00e4 kuinka se ymm\u00e4rret\u00e4\u00e4n. Sill\u00e4 v\u00e4lin kuitenkin tarkista, onko t\u00e4m\u00e4 tiedosto edes olemassa. Jos on, voit menn\u00e4 eteenp\u00e4in ja tutkia tiedoston sis\u00e4lt\u00f6\u00e4. Ymm\u00e4rr\u00e4t tai et ymm\u00e4rr\u00e4 paljon tapahtuvasta, mutta tiedoston sis\u00e4lt\u00f6 tarkoittaa, ett\u00e4 jokin teemassa tai laajennuksessa laukaisee erilaisia \u200b\u200bPHP-varoituksia, -ilmoituksia ja -virheit\u00e4<\/a><\/strong>, joita WordPress ker\u00e4\u00e4 ja tallentaa lokitiedostoon.<\/p>\n
Mit\u00e4 lokitiedosto edes tarkoittaa?<\/h3>\n
T\u00e4m\u00e4 ei v\u00e4ltt\u00e4m\u00e4tt\u00e4 tarkoita, ett\u00e4 jokin olisi rikki, mutta se osoittaa, ett\u00e4 jokin ei toimi niin kuin sen pit\u00e4isi, sit\u00e4 ei havaita ja k\u00e4sitell\u00e4 oikein ohjelmatasolla tai se yksinkertaisesti tekee jotain, mit\u00e4 sen ei pit\u00e4isi tehd\u00e4.<\/p>\n
\"WordPressin<\/a><\/p>\n
Sen ei tarvitse n\u00e4ytt\u00e4\u00e4 t\u00e4lt\u00e4 (mutta se voi!).<\/p>\n
Kehitt\u00e4j\u00e4n\u00e4 meid\u00e4n tulee pyrki\u00e4 varmistamaan, ett\u00e4 koodimme ei luo mit\u00e4\u00e4n, mik\u00e4 kirjoitetaan virhelokiin.<\/p>\n
Yksi asia on tehd\u00e4 se kehitysty\u00f6ss\u00e4, koska voimme saada k\u00e4sityksen siit\u00e4, mit\u00e4 teemme ja miten WordPress toimii. Se on kuitenkin toinen asia, ett\u00e4 jokin, jonka julkaisemme tuotantotasolla, tuottaa t\u00e4llaisia \u200b\u200basioita.<\/p>\n
Virhelokin lukeminen<\/h3>\n
Ilmeisesti virhelokin lukeminen on muutakin kuin sen avaamista. Monille ensivaikutelma on, ett\u00e4 se voi olla joukko ammattislangia. Min\u00e4kin ymm\u00e4rr\u00e4n sen. Mutta kun ymm\u00e4rr\u00e4t, mit\u00e4 se n\u00e4ytt\u00e4\u00e4 sinulle, on paljon helpompi ymm\u00e4rt\u00e4\u00e4.<\/p>\n
Katsotaanpa siis todella yksinkertaista esimerkki\u00e4. T\u00e4m\u00e4k\u00e4\u00e4n ei ole keksitty esimerkki. Itse asiassa t\u00e4m\u00e4 on per\u00e4isin laajennuksesta, jonka parissa ty\u00f6skentelin. Virheloki sis\u00e4lt\u00e4\u00e4 seuraavat tiedot<\/a><\/strong> :<\/p>\n
[05-Jul-2018 19:43:53 UTC] PHP Fatal error:  Uncaught Error: Class 'EasyEmailExportAdminEmailExportSubmenu' not found in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php:37\n#8 \/U in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php on line 37\n[05-Jul-2018 19:44:03 UTC] PHP Warning:  include_once(.\/src\/Admin\/EmailExportSubmenu.php): failed to open stream: No such file or directory in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php on line 25\n[05-Jul-2018 19:44:03 UTC] PHP Warning:  include_once(): Failed opening '.\/src\/Admin\/EmailExportSubmenu.php' for inclusion (include_path='.:\/usr\/local\/Cellar\/php\/7.2.5\/share\/php\/pear') in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php on line 25<\/code><\/pre>\n
Huomaa, ett\u00e4 yll\u00e4 olevassa sis\u00e4ll\u00f6ss\u00e4 on kolme rivi\u00e4. Paras tapa toimia virhelokeja luettaessa on aloittaa alhaalta ja siirty\u00e4 yl\u00f6sp\u00e4in. T\u00e4m\u00e4 johtuu siit\u00e4, ett\u00e4 suorituksen aikana suoritettavat asiat toimivat pinossa.<\/p>\n
Lyhyt poikkeama pinoista<\/h4>\n
En mene k\u00e4sitteen tietojenk\u00e4sittelytieteen m\u00e4\u00e4ritelm\u00e4\u00e4n, mutta koodi suoritetaan ja toimii siten, ett\u00e4 funktioita esiintyy ja aivan kirjaimellisesti tietokoneen muistissa pinotaan p\u00e4\u00e4llekk\u00e4in.<\/p>\n
Siten viimeisin juokseva asia tulee aina olemaan ylh\u00e4\u00e4ll\u00e4, miss\u00e4 sen alkujuuri on alhaalla. Koska kirjoitamme koodia jo olemassa olevaan sovellukseen, se on WordPress; silloin koodimme on todenn\u00e4k\u00f6isesti aina yl\u00e4osassa.<\/p>\n
\"WordPressin<\/a><\/p>\n
WordPress-virhelokien ymm\u00e4rt\u00e4minen: Se ei ole t\u00e4llainen pino<\/p>\n
Ajatuksena on, ett\u00e4 koodi alkaa suorittaa WordPressiss\u00e4 ja etenee kohti tekem\u00e4\u00e4mme ty\u00f6t\u00e4. Kun tulee ilmoitus, varoitus tai virhe, se on yleens\u00e4 jotain koodissamme (vaikka WordPress ei ole vapautettu, niin yleens\u00e4).<\/p>\n
Joten kun luet virhelokia, luet pohjimmiltaan niin sanottua pinoj\u00e4ljityst\u00e4.<\/a><\/strong> Wikipediassa, kuten linkitetty, on melko syv\u00e4llinen m\u00e4\u00e4ritelm\u00e4 aiheesta, mutta ehk\u00e4 osuvin kohta t\u00e4h\u00e4n viestiin on seuraava:<\/p>\n
\n
Ohjelmoijat k\u00e4ytt\u00e4v\u00e4t yleens\u00e4 pinoj\u00e4ljityst\u00e4 interaktiivisen ja post mortem -virheenkorjauksen aikana (https:\/\/en.wikipedia.org\/wiki\/Debugging<\/a>). Loppuk\u00e4ytt\u00e4j\u00e4t voivat n\u00e4hd\u00e4 pinon j\u00e4ljen osana virheilmoitusta<\/a>, jonka k\u00e4ytt\u00e4j\u00e4 voi sitten ilmoittaa ohjelmoijalle.<\/p>\n<\/blockquote>\n
T\u00e4m\u00e4 sopii yhteen sen kanssa, mit\u00e4 olen edell\u00e4 hahmotellut, eik\u00f6 niin? Mutta tarpeeksi puhua siit\u00e4, mit\u00e4 pinoj\u00e4ljitys on (se tulee selvemm\u00e4ksi, kun p\u00e4\u00e4semme syvemm\u00e4lle virheenkorjaukseen), palataanpa nyt lokitiedoston lukemiseen sellaisena kuin se on.<\/p>\n
Takaisin lokin lukemiseen<\/h3>\n
Sis\u00e4lt\u00e4\u00e4 tiedostot<\/h4>\n
Katsotaanpa ensin alimmaista rivi\u00e4 yll\u00e4 olevassa sis\u00e4ll\u00f6ss\u00e4. Se sis\u00e4lt\u00e4\u00e4 seuraavat:<\/p>\n
[05-Jul-2018 19:44:03 UTC] PHP Warning: include_once(): Failed opening '.\/src\/Admin\/EmailExportSubmenu.php' for inclusion (include_path='.:\/usr\/local\/Cellar\/php\/7.2.5\/share\/php\/pear') in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php on line 25<\/code><\/pre>\n
T\u00e4m\u00e4 kertoo minulle, ett\u00e4 tiedostoni easy-email-export.php<\/strong> rivill\u00e4 25 se ei onnistunut avaamaan tiedostoa sis\u00e4llytett\u00e4v\u00e4ksi. T\u00e4m\u00e4 tarkoittaa, ett\u00e4 koodissa on include_once<\/strong> -lauseke, joka viittaa osoitteeseen .\/src\/Admin\/EmailExportSubmenu.php<\/strong>, jota se ei l\u00f6yd\u00e4.<\/p>\n
Joten paras tapa toimia olisi etsi\u00e4 rivi 25 ja selvitt\u00e4\u00e4, miksi se ei l\u00f6yd\u00e4 tiedostoa. Ehk\u00e4 se kaataa koko polun siihen, mihin se n\u00e4ytt\u00e4\u00e4. P\u00e4\u00e4semme t\u00e4h\u00e4n hetkeksi, kun puhumme virhelokiin kirjoittamisesta.<\/p>\n
Virheiden j\u00e4rke\u00e4<\/h4>\n
Seuraavalla rivill\u00e4 (eli juuri tarkastelemamme rivin yl\u00e4puolella) on seuraava:<\/p>\n
[05-Jul-2018 19:44:03 UTC] PHP Warning: include_once(.\/src\/Admin\/EmailExportSubmenu.php): failed to open stream: No such file or directory in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php on line 25<\/code><\/pre>\n
T\u00e4m\u00e4 erityinen rivi eroaa vain hieman, mutta se antaa lis\u00e4tietoa, ja se sis\u00e4ltyy lausekkeeseen, joka kuuluu "Ei t\u00e4llaista tiedostoa tai hakemistoa". T\u00e4m\u00e4 on oivaltava, koska se kirjaimellisesti kertoo meille, ett\u00e4 tiedostoa ei ole olemassa.<\/p>\n
Sit\u00e4 ei ainakaan ole olemassa sielt\u00e4, miss\u00e4 se katsoo. Joten kaksi mahdollisuutta ovat:<\/p>\n
    \n
  1. emme ole luoneet tiedostoa, johon olemme viittauksia,<\/li>\n
  2. viittaamme tiedoston sijaintiin v\u00e4\u00e4r\u00e4ss\u00e4 paikassa<\/li>\n<\/ol>\n
    Siksi meid\u00e4n on ensin tarkistettava, onko tiedosto olemassa paikassa, jota yrit\u00e4mme sis\u00e4llytt\u00e4\u00e4. Jos ei, meid\u00e4n pit\u00e4isi luoda tiedosto.<\/p>\n
    Jos tiedosto on olemassa, tied\u00e4mme, ett\u00e4 laajennus yritt\u00e4\u00e4 ladata sen v\u00e4\u00e4r\u00e4st\u00e4 polusta. Joten meid\u00e4n on ehk\u00e4 tarkasteltava automaattista latausohjelmaamme<\/a><\/strong>, sis\u00e4llytt\u00e4mispolkuamme tai sit\u00e4, miten tiedostoja haetaan. Koska todenn\u00e4k\u00f6isyys on, ett\u00e4 jos tiedosto on olemassa, sit\u00e4 yritet\u00e4\u00e4n ladata paikasta, jossa se ei ole.<\/p>\n
    Tavoittamaton virhe<\/h3>\n
    Koodin viimeisell\u00e4 rivill\u00e4 n\u00e4et jotain t\u00e4llaista:<\/p>\n
    [05-Jul-2018 19:43:53 UTC] PHP Fatal error: Uncaught Error: Class 'EasyEmailExportAdminEmailExportSubmenu' not found in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php:37\n#8 \/U in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php on line 37<\/code><\/pre>\n
    T\u00e4m\u00e4 on hyv\u00e4 esimerkki ensinn\u00e4kin, koska se ilmoittaa nimenomaisesti, ett\u00e4 t\u00e4m\u00e4 on huomaamaton virhe. T\u00e4m\u00e4 tarkoittaa, ett\u00e4 toiminnallisuudesta riippumatta jokin aiheuttaa virheen, eik\u00e4 sit\u00e4 saada kiinni.<\/p>\n