Vianetsintätilan käyttöönotto edellyttää yhden tiedoston muokkaamista WordPress-asennuksessasi. Se on helppoa, mutta kannattaa tehdä huolellisesti, jotta sivusto ei rikkoudu. Alla on vaiheittaiset ohjeet sen tekemiseen oikein.
Kun tila on aktivoitu, voit kirjata virheet lokiin, piilottaa ne vierailijoilta ja hallita, kuinka WordPress käsittelee vianetsintätietoja. Tämä on erityisen tärkeää tuotantosivustoilla, joilla virheet on tallennettava mutta ei näytettävä julkisesti.
wp-config.php-tiedoston paikantaminen
Ensimmäinen askel vianetsintätilan käyttöönotossa on etsiä wp-config.php-tiedosto. Tämä tiedosto sijaitsee WordPress-asennuksesi juurikansiossa, samassa paikassa kuin wp-content, wp-includes ja wp-admin. Pääset siihen käsiksi FTP-ohjelmalla, palveluntarjoajan hallintapaneelin tiedostonhallinnan kautta tai paikallisesti, jos työskentelet kehityspalvelimella.
On suositeltavaa ottaa varmuuskopio tästä tiedostosta ennen muutosten tekemistä. Yhdenkin merkin puuttuminen voi rikkoa sivuston, ja varmuuskopio mahdollistaa sen nopean palauttamisen. Kun olet löytänyt tiedoston, avaa se tekstieditorissa ja valmistaudu muuttamaan sen asetuksia.
WP_DEBUG:n aktivointi
wp-config.php-tiedoston sisällä selaa, kunnes löydät rivin, joka näyttää tältä: define( 'WP_DEBUG', false );. Tämä rivi hallitsee sitä, onko vianetsintätila käytössä. Oletuksena WordPress poistaa vianetsinnän käytöstä turvallisuus- ja suorituskykysyistä. Aktivoidaksesi sen, vaihda arvo false muotoon true.
Oikean rivin tulisi näyttää tältä: define( 'WP_DEBUG', true );. Kun tallennat tiedoston, WordPress alkaa välittömästi näyttää PHP-varoituksia, ilmoituksia ja virheilmoituksia koko sivustolla. Näin voit tunnistaa ongelmalliset lisäosat, teemat tai mukautetun koodin.
WP_DEBUG_LOG:n käyttäminen virheiden tallentamiseen
Virheiden näyttäminen näytöllä voi olla hyödyllistä kehityksen aikana, mutta se ei aina ole käytännöllistä. Pitkäaikaista seurantaa varten voit ottaa käyttöön WP_DEBUG_LOG. Lisää tätä varten seuraava rivi heti WP_DEBUG-vakion alle: define( 'WP_DEBUG_LOG', true );. Tämä tallentaa kaikki virheet debug.log-tiedostoon wp-content-kansioon.
Lokitiedosto on erityisen hyödyllinen, jos sinun täytyy seurata virheitä, jotka tapahtuvat tietyinä aikoina, tai jos niitä ei voida toistaa suoraan näytöllä. Se mahdollistaa myös tiedoston jakamisen kehittäjille tai tukitiimeille ilman, että annat heille suoraa pääsyä sivustolle.
Virheiden piilottaminen vierailijoilta
Jos WordPress-sivustosi on julkisesti käytössä, et todennäköisesti halua vierailijoiden näkevän raakavirheilmoituksia. Tässä tapauksessa voit lisätä toisen asetuksen poistaaksesi näyttämisen käyttöliittymässä: define( 'WP_DEBUG_DISPLAY', false );. Näin virheet kirjataan edelleen, mutta niitä ei näytetä käyttäjille.
Lisäksi voit lisätä @ini_set( 'display_errors', 0 ); vahvistaaksesi tätä toimintaa. Tämä yhdistelmä pitää sivustosi ammattimaisena ja turvallisena, samalla kun tarvittavat tiedot pysyvät lokissa ylläpitäjille ja kehittäjille.
Kehittynyt vianetsintä SCRIPT_DEBUG:lla
JavaScriptin ja CSS:n kanssa työskenteleville kehittäjille WordPress tarjoaa lisävakion: define( 'SCRIPT_DEBUG', true );. Oletuksena WordPress lataa pienennetyt versiot skripteistä ja tyyleistä. Kun script-debug otetaan käyttöön, WordPress lataa täydet, ei-pienennetyt versiot, joita on helpompi tarkastella ja debugata.
Tämä asetus on erityisen arvokas, jos kehität teemoja tai lisäosia ja sinun täytyy seurata skriptien ja tyylien toimintaa. Tavallisille käyttäjille se ei yleensä ole tarpeen, mutta kehittäjille se voi olla ratkaiseva frontend-ongelmia selvitettäessä.
Yhteenvetona, WordPressin vianetsintätilan käyttöönotto on yksinkertainen mutta tehokas tapa diagnosoida ja ylläpitää verkkosivustoasi. Muokkaamalla wp-config.php-tiedostoa voit näyttää virheet, tallentaa ne lokiin ja pitää sivuston ammattimaisen näköisenä myös ongelmatilanteissa. Oikein käytettynä vianetsintätila on yksi tärkeimmistä työkaluista WordPressin turvallisuuden, vakauden ja kehittäjäystävällisyyden varmistamisessa.
