{"id":115,"date":"2023-02-14T00:00:00","date_gmt":"2023-02-13T23:00:00","guid":{"rendered":"https:\/\/helloblog.io\/fi\/parempi-wordpress-debuggaus-acornilla\/"},"modified":"2026-01-20T06:33:16","modified_gmt":"2026-01-20T05:33:16","slug":"parempi-wordpress-debuggaus-acornilla","status":"publish","type":"post","link":"https:\/\/helloblog.io\/fi\/parempi-wordpress-debuggaus-acornilla\/","title":{"rendered":"Parempi WordPress-debuggaus Acornilla: WP_DEBUG-lukukelpoiseksi"},"content":{"rendered":"\n

WordPressin kehityksess\u00e4 yksi helpoimmista tavoista s\u00e4\u00e4st\u00e4\u00e4 aikaa on pit\u00e4\u00e4 WP_DEBUG<\/code> aina p\u00e4\u00e4ll\u00e4 lokaalissa ymp\u00e4rist\u00f6ss\u00e4. Se paljastaa notice-tason ongelmat ja varsinaiset fatal errorit heti \u2014 ja juuri ne \u201cpienet\u201d notice-varoitukset ovat usein niit\u00e4, jotka muuttuvat my\u00f6hemmin vaikeasti j\u00e4ljitett\u00e4viksi bugeiksi tai yhteensopivuusongelmiksi muiden lis\u00e4osien kanssa.<\/p>\n\n\n\n

Ongelma on, ett\u00e4 WordPressin oletusdebuggaus on k\u00e4ytett\u00e4vyydelt\u00e4\u00e4n aika karu: virheilmoitukset tulostetaan suoraan sivulle, eik\u00e4 pino (stack trace) ole erityisen yst\u00e4v\u00e4llinen luettavaksi. Jos rakennat sivustoa Roots-stackilla (Bedrock + Acorn), saat t\u00e4h\u00e4n huomattavasti paremman kokemuksen k\u00e4yt\u00e4nn\u00f6ss\u00e4 \u201ckaupan p\u00e4\u00e4lle\u201d.<\/p>\n\n\n\n

Mit\u00e4 WP_DEBUG k\u00e4yt\u00e4nn\u00f6ss\u00e4 tekee (ja miksi se kannattaa pit\u00e4\u00e4 p\u00e4\u00e4ll\u00e4)<\/h2>\n\n\n\n

WP_DEBUG<\/code> on WordPressin debug-tila, joka aktivoidaan m\u00e4\u00e4rittelem\u00e4ll\u00e4 WP_DEBUG<\/code>-konstantti konfiguraatiossa. Kun se on p\u00e4\u00e4ll\u00e4, WordPress n\u00e4ytt\u00e4\u00e4 ja\/tai loggaa PHP-virheit\u00e4 ja -huomautuksia. Kehitysymp\u00e4rist\u00f6ss\u00e4 t\u00e4m\u00e4 on peruskauraa: saat v\u00e4litt\u00f6m\u00e4n palautteen deprecated-kutsuista, m\u00e4\u00e4rittelem\u00e4tt\u00f6mist\u00e4 muuttujista ja muista asioista, jotka muuten j\u00e4isiv\u00e4t piiloon.<\/p>\n\n\n\n

Bedrockissa (Roots-projektin moderni WordPress-boilerplate, jossa riippuvuudet hoidetaan Composerilla) debug-tila on tyypillisesti valmiiksi p\u00e4\u00e4ll\u00e4 kehitysymp\u00e4rist\u00f6iss\u00e4. T\u00e4m\u00e4 on yksi Bedrockin k\u00e4yt\u00e4nn\u00f6n hy\u00f6dyist\u00e4: ymp\u00e4rist\u00f6kohtainen konfiguraatio ohjaa asetuksia j\u00e4rkev\u00e4sti ilman, ett\u00e4 jokainen projekti keksii py\u00f6r\u00e4\u00e4 uudelleen.<\/p>\n\n\n\n

WP_DEBUG:n oletusoutput: toimii, mutta ei ole mukava<\/h2>\n\n\n\n

Oletuksena WordPress puskee virheilmoitukset suoraan sivulle. Se on parempi kuin ei mit\u00e4\u00e4n, mutta k\u00e4yt\u00e4nn\u00f6ss\u00e4 se tarkoittaa usein:<\/p>\n\n\n\n

    \n\n
  • Virhe n\u00e4kyy kyll\u00e4, mutta konteksti (mist\u00e4 se tuli ja miksi) j\u00e4\u00e4 vajaaksi.<\/li>\n\n\n
  • Stack trace on vaikea lukea, etenkin jos projekti k\u00e4ytt\u00e4\u00e4 moderneja rakenteita ja autoloadingia.<\/li>\n\n\n
  • Sama virheilmoitus voi toistua useaan kertaan ja sotkea n\u00e4kym\u00e4n nopeasti.<\/li>\n\n<\/ul>\n\n\n\n

    Lis\u00e4ksi WordPress-ekosysteemiss\u00e4 on paljon lis\u00e4osia ja teemoja, jotka p\u00e4\u00e4st\u00e4v\u00e4t l\u00e4pi notice- ja warning-tason viestej\u00e4. Kun teet omaa teemaa tai pluginia, n\u00e4m\u00e4 signaalit ovat arvokkaita: ne kertovat usein integraatio-ongelmista tai reunatapauksista, joihin t\u00f6rm\u00e4\u00e4t vasta tuotannossa.<\/p>\n\n\n\n

    \"WordPressin
    WP_DEBUG:n oletustulostus on suoraviivainen, mutta harvoin mukavin tapa lukea poikkeuksia. \u2014 Forr\u00e1s: Roots.io<\/em><\/figcaption><\/figure>\n\n\n\n

    Acorn ja parempi error handling WordPressiss\u00e4<\/h2>\n\n\n\n

    Acorn on Roots-ekosysteemin PHP-sovelluskerros WordPressille, joka tuo Laravelista tuttuja k\u00e4yt\u00e4nt\u00f6j\u00e4 (esim. helperit, palvelukontit ja modernimpi sovellusrakenne) WordPress-projekteihin. Yksi konkreettinen hy\u00f6ty arjessa on parempi virheenk\u00e4sittely, kun WP_DEBUG<\/code> ja WP_DEBUG_DISPLAY<\/code> ovat p\u00e4\u00e4ll\u00e4.<\/p>\n\n\n\n

    Acornin oletus: Symfony exception handler<\/h3>\n\n\n\n

    Acornin oletusk\u00e4yt\u00f6s on hy\u00f6dynt\u00e4\u00e4 Symfonyn exception handleria. K\u00e4yt\u00e4nn\u00f6ss\u00e4 t\u00e4m\u00e4 tarkoittaa selke\u00e4mp\u00e4\u00e4 virhesivua: poikkeus, viesti ja pino esitet\u00e4\u00e4n huomattavasti luettavammin kuin WordPressin perusoutput.<\/p>\n\n\n\n

    \"Acornin
    Acornin oletusvirhesivu Symfonyn handlerilla parantaa luettavuutta heti. \u2014 Forr\u00e1s: Roots.io<\/em><\/figcaption><\/figure>\n\n\n\n

    Ignition: Laravel-tyylinen virhesivu my\u00f6s WordPressiin<\/h3>\n\n\n\n

    Jos olet tehnyt kehityst\u00e4 Laravelilla, Ignition on todenn\u00e4k\u00f6isesti tuttu: se on Laravelin (v9:st\u00e4 eteenp\u00e4in) oletusvirhesivu, jossa on todella hyv\u00e4 developer experience. Acorn v3 toi mukanaan Laravelin reititystuen, ja samalla my\u00f6s Ignition-tuki tuli mahdolliseksi WordPress-sivustoille, jotka k\u00e4ytt\u00e4v\u00e4t Acornia.<\/p>\n\n\n\n

    Ignition on erityisen hy\u00f6dyllinen silloin, kun haluat nopean kokonaiskuvan: mit\u00e4 tapahtui, miss\u00e4 tiedostossa, mill\u00e4 rivill\u00e4, ja miten koodi p\u00e4\u00e4tyi siihen. Se tekee virheiden \u201ctriagesta\u201d huomattavasti nopeampaa.<\/p>\n\n\n\n

    \"Acornin
    Ignition tarjoaa Laravelista tutun virhesivun ja helpottaa poikkeusten paikantamista. \u2014 Forr\u00e1s: Roots.io<\/em><\/figcaption><\/figure>\n\n\n\n

    Ignitionin saa k\u00e4ytt\u00f6\u00f6n asentamalla sen kehitysriippuvuudeksi samassa hakemistossa, jossa Acorn on asennettuna:<\/p>\n\n\n\n

    <\/circle><\/circle><\/circle><\/g><\/svg><\/span>