Siirry pääsisältöön

Sähköpostien virheenjäljitys MailCatcher-työkalulla

Opi testaamaan ja tarkastelemaan WordPressin lähettämiä sähköposteja turvallisesti Seravon paikallisessa Docker-kehitysympäristössä sisäänrakennetun MailCatcher-työkalun avulla.

MailCatcher on Seravon paikalliseen Docker-kehitysympäristöön sisäänrakennettu työkalu, joka jäljittelee oikeaa sähköpostipalvelinta. Se sieppaa kaikki paikallisen kehitysympäristön PHP- ja WordPress-järjestelmän lähettämät sähköpostit, kuittaa ne WordPressille onnistuneesti lähetetyiksi ja tallentaa viestit selaimessa tarkasteltaviksi. Kehityskontin sisällä MailCatcher toimii paikallisena SMTP-palvelimena portissa 1025, johon PHP:n mail()-funktio on valmiiksi ohjattu.

Näin voit testata turvallisesti esimerkiksi WooCommerce-tilausvahvistuksia, salasanan palautuksia ja yhteydenottolomakkeita ilman riskiä siitä, että testiviestit lähtisivät oikeille asiakkaille tai käyttäjille.

kuvakaappaus esimerkistä MailCatcherin käyttöön

Kuvassa näkyy esimerkki MailCatcherin käyttöliittymästä.

MailCatcherin avaaminen selaimessa

MailCatcher käynnistyy automaattisesti aina, kun käynnistät paikallisen kehitysympäristön (seravo-docker up). Pääset tarkastelemaan siepattuja viestejä selaimessa kummasta tahansa seuraavista osoitteista:

  • http://<sivusto>.local/.seravo/mailcatcher/ (oletuksena http://wordpress.local/.seravo/mailcatcher/)

  • http://mailcatcher.<sivusto>.local/ (oletuksena http://mailcatcher.wordpress.local/)

Käyttöliittymässä voit tarkastella kutakin viestiä kolmessa eri muodossa:

  • HTML: Näyttää viestin visuaalisen ulkoasun sellaisena kuin sähköpostiohjelmat sen renderöivät.

  • Plain Text: Näyttää viestin pelkkänä tekstinä ilman HTML-muotoiluja.

  • Source: Näyttää viestin raakadatan ja sähköpostiotsakkeet (kuten From, To, Reply-To, Subject ja MIME-rakenteen), mikä auttaa vianmäärityksessä.

Sähköpostien lähetyksen testaaminen

Voit testata sähköpostien toimintaa joko käyttämällä WordPressin omia toimintoja (kuten kirjautumissivun salasanan palautusta tai yhteydenottolomaketta) tai lähettämällä testiviestin suoraan kehityskontin komentoriviltä (seravo-docker ssh):

# Lähetä testiviesti Seravon valmiilla työkalulla
wp-mail-test [email protected]

# Tai testaa suoraan WordPressin wp_mail()-funktiota WP-CLI:llä
wp eval 'wp_mail( "[email protected]", "Testiotsikko", "Testiviestin sisältö" );'

Lähetetty viesti ilmestyy välittömästi MailCatcherin selainnäkymään.

Ulkoiset SMTP-lisäosat ja sähköpostipalvelut

MailCatcher sieppaa oletuksena kaikki viestit, jotka lähetetään palvelimen paikallisen PHP mail() -funktion kautta – tämä on Seravon ympäristön vakiotapa, jota WordPressin wp_mail() käyttää ilman erillisiä lisäosia.

Varoitus: MailCatcher ei sieppaa liikennettä, jos sivustolla on käytössä erillinen SMTP-lisäosa (joka ottaa suoran verkkoyhteyden ulkoiseen SMTP-palvelimeen porteissa 587 tai 465) tai API-pohjainen sähköpostipalvelu (kuten Mailchimp, SendGrid API tai Brevo). Jos tuot tuotantotietokannan paikalliseen ympäristöön (wp-pull-production-db), poista ulkoiset SMTP-lisäosat käytöstä kehityksen ajaksi komennolla wp plugin deactivate <lisaosan-nimi>, jotta paikalliset testiviestit eivät lähde oikeille vastaanottajille.

Yleisimmät virhetilanteet

  • MailCatcher-osoite ei avaudu tai palauttaa 502 Bad Gateway -virheen: Varmista, että paikallinen Docker-ympäristö on käynnissä (seravo-docker up) ja että paikallinen nimipalvelu ohjaa .local-osoitteet osoitteeseen 127.0.0.1.

  • Viestit eivät ilmesty MailCatcheriin: Tarkista ensin, toimiiko peruslähetys ajamalla kontin sisällä wp-mail-test [email protected]. Jos testiviesti näkyy MailCatcherissa mutta WordPressin lomakkeet eivät lähetä viestejä, tarkista aktiiviset lisäosat (wp plugin list) mahdollisen ulkoisen SMTP-lisäosan varalta tai tutki PHP-virhelokit (/data/log/php-error.log).

  • Testisähköpostit menivät perille oikeisiin sähköpostiosoitteisiin: Sivustolla on todennäköisesti käytössä tuotantotietokannasta periytynyt ulkoinen SMTP-lisäosa tai API-integraatio, joka ohittaa palvelimen paikallisen sähköpostireitityksen. Deaktivoi kyseinen lisäosa paikallisessa kehitysympäristössä.

Katso myös

MailCatcherin avulla varmistat, että sähköpostipohjat, lomakeilmoitukset ja verkkokaupan viestit toimivat virheettömästi jo kehitysvaiheessa. Mikäli tarvitset apua paikallisen kehitysympäristön työkaluissa tai sähköpostien vianmäärityksessä, asiakaspalvelumme auttaa osoitteessa [email protected].

Vastasiko tämä kysymykseesi?