De MAIL-variabelen van Laravel instellen

Laravel leest zijn mailinstellingen uit het omgevingsbestand van uw toepassing. Met een handvol MAIL-variabelen laat u alle mail van uw applicatie — registraties, wachtwoordresets, meldingen uit een wachtrij — via 2Mail vertrekken, zonder één regel code te wijzigen.

Wat u nodig hebt

• de servernaam uit uw 2mail-account
• een SMTP-login met wachtwoord, in het dashboard aangemaakt voor deze toepassing; gebruik voor uw test- en productieomgeving een aparte login
• een afzenderadres op een domein dat als verzenddomein in uw account staat

Stap 1: de variabelen invullen

Open het omgevingsbestand van uw toepassing en zet de mailer op SMTP. Ingevuld ziet het er zo uit:

MAIL_MAILER=smtp, MAIL_HOST=de servernaam uit uw 2mail-account, MAIL_PORT=587, MAIL_USERNAME=uw SMTP-login, MAIL_PASSWORD=uw wachtwoord, MAIL_ENCRYPTION=tls, MAIL_FROM_ADDRESS=een adres op uw verzenddomein, MAIL_FROM_NAME=de naam van uw bedrijf.

Zet waarden met spaties, zoals de afzendernaam, tussen aanhalingstekens. Houd de versleuteling op tls; dat is de STARTTLS-instelling die bij poort 587 hoort.

Stap 2: de configuratiecache verversen

Draait uw productieomgeving met een gecachte configuratie, dan leest Laravel het omgevingsbestand niet opnieuw. Ververs de configuratiecache na elke wijziging, anders test u met de oude waarden en zoekt u een fout die er niet is.

Stap 3: testen

Verstuur een eenvoudig bericht, bijvoorbeeld vanuit de interactieve console van Laravel of via een bestaande notificatie, naar een adres buiten uw domein. Controleer daarna de afleveringslog in het dashboard van 2Mail: daar ziet u of het bericht ons bereikt heeft en wat de ontvangende server geantwoord heeft.

Stap 4: de wachtrij

Verstuurt u mail via een wachtrij, dan gebeurt het echte versturen in de worker, niet in de webrequest. Herstart de workers na een wijziging van de variabelen; anders draaien ze door met de oude instellingen. Bij een fout in de worker verschijnt het bericht in de tabel met mislukte taken, met de melding van onze relay erbij.

Veelgemaakte fouten

• Verbinding kon niet worden opgezet — de servernaam bevat een typefout, of de hosting blokkeert poort 587. Vraag uw hoster om die poort vrij te geven.
• Afzender geweigerd — het afzenderadres in een individuele mailable overschrijft het globale adres en gebruikt een ander domein.
• Werkt lokaal, niet in productie — de configuratiecache is niet ververst, of productie gebruikt een ander omgevingsbestand met oude waarden.

Meer over deze koppeling staat op SMTP voor Laravel. Wilt u liever zonder SMTP versturen en per bericht een status terugkrijgen, kijk dan naar de e-mail-API.

Lukt het niet?

Stuur ons via contact de melding uit uw logbestand of uit de tabel met mislukte taken. Daar staat het antwoord van onze relay letterlijk in.