Manual:$wgSMTP

This page is a translated version of the page Manual:$wgSMTP and the translation is 100% complete.
Other languages:
English • ‎Nederlands • ‎français • ‎magyar • ‎polski • ‎português • ‎português do Brasil • ‎தமிழ் • ‎中文 • ‎日本語
Email settings: $wgSMTP
Voor het gebruik van een directe (geauthenticeerde) SMTP-serververbinding.
Geïntroduceerd in versie:1.2.0
Verwijderd in versie:nog steeds in gebruik
Toegelaten waardes:Zie onder.
Standaardwaarde:false

Details

Om e-mails te versturen (e-mailbevestigingen, meldingen, Special:Emailuser ), moet u gebruik maken van een externe e-mailprovider en MediaWiki toestaan om e-mail te versturen via SMTP. De instellingen worden opgeslagen als een array in $wgSMTP. Stel in op false (de standaardwaarde) om de ingebouwde PHP mail() functie te gebruiken, maar houd er rekening mee dat als u dit doet uw e-mails hoogstwaarschijnlijk in de spam-map van de gebruiker terecht zullen komen.

Configureer ook $wgEmergencyContact en zorg ervoor dat $wgPasswordSender overeenkomt met het verzendende e-mailadres.

$wgSMTP is zo geconfigureerd:

$wgSMTP = [
    'host'     => 'mail.example.com', // zou ook een IP-adres kunnen zijn. Waar de SMTP-server zich bevindt
    'IDHost'   => 'example.com',      // Over het algemeen zal dit de domeinnaam van uw website zijn (ofwel mywiki.org)
    'port'     => 25,                 // Poort om te gebruiken bij het maken van een verbinding met de SMTP-server
    'auth'     => true,               // Moet er gebruik gemaakt worden van STMP-authenticatie (true of false)
    'username' => 'my_user_name',     // Gebruikersnaam voor SMTP-authenticatie (indien gebruikt)
    'password' => 'my_password'       // Wachtwoord voor SMTP-authenticatie (indien gebruikt)
];

IDHost is een MediaWiki-specifieke instelling die wordt gebruikt om de Message-ID e-mail header te bouwen (zie RFC 2822, sec 3.6.4 voor meer informatie over een correct geformatteerde Message-ID). Indien niet verstrekt, zal dit standaard staan op $wgServer . Voor de overige instellingen, zie Mail::factory() voor een meer volledige beschrijving. (Scroll naar beneden naar de smtp parameter.)

Installeer afhankelijkheden voor oudere versies van MediaWiki (versie MediaWiki 1.31 en eerder)

Voorbeelden

Outlook Exchange Server

$wgSMTP = [
    'host'     => 'outlook.corporatedomain.com',
    'IDHost'   => 'corporatationname.com',
    'port'     => 25,
    'auth'     => false,
    'username' => 'name@corporationname.com',
    'password' => 'pw1245'
];

Gmail

Merk op dat u een "App-wachtwoord" moet gebruiken in plaats van uw gebruikelijke Gmail-wachtwoord, zoals uitgelegd [$app-wachtwoord hier].

$wgSMTP = [
    'host' => 'ssl://smtp.gmail.com',
    'IDHost' => 'gmail.com',
    'localhost' => 'myservername.org',
    'port' => 465,
    'username' => 'myemail@gmail.com',
    'password' => '16 digit special gmail app password',
    'auth' => true
];

Hierna kunt u een typefout in de authenticatie krijgen. U moet zich aanmelden bij de gmail-account die u gebruikt en controleren of u de persoon bent die zich zojuist heeft aangemeld. U hoeft dit maar één keer te controleren. (gmail stuurt u een e-mail en u hoeft alleen maar de instructies te volgen)

AWS SES

Amazon Web Services' Simple E-mail Service kan worden gebruikt voor SMTP-ondersteuning. Merk op dat als je AWS SES instantie is geconfigureerd in 'Sandbox' modus je je instellingen moet wijzigen in configuratieparameters $wgPasswordSender en $wgEmergencyContact naar een e-mailadres dat je hebt geverifieerd in de AWS SES console. Als nieuwe gebruikers zich registreren en ze staan niet in de geverifieerde lijst, krijgen ze de e-mail niet en bent u beperkt tot 200 e-mails per dag!

$wgSMTP = [
    'host' => 'tls://email-smtp.us-east-1.amazonaws.com', // Provided by Amazon SES to you
    'IDHost' => 'email-smtp.us-east-1.amazonaws.com', // Provided by Amazon SES to you
    'port' => 465,
    'username' => 'ISJAKSJAETQKJSAS8RP3LSFA', // Provided by Amazon SES to you
    'password' => '13HJASHjhjhjHAkjhkhA/hUfJHSIFAjjAskJADOIW2',  // Provided by Amazon SES to you
    'auth' => true
];

Probleemoplossing

Error sending mail: Unknown error in PHP's mail() function MediaWiki

Zorg ervoor dat $wgEmergencyContact en $wgPasswordSender correct zijn ingesteld en overeenkomen met uw e-mailadres. Sommige hosts zullen weigeren om een e-mail te sturen met een afzender die niet overeenkomt met de account die de e-mail stuurt.

Zorg ervoor dat u de pakketten hebt geïnstalleerd die nodig zijn voor het verzenden van de post.

$ sudo pear install mail
$ sudo pear install net_smtp

Zie ook mogelijke problemen in taak T32260.

Als uw server SELinux heeft ingeschakeld, moet u deze correct configureren om het verzenden van mails vanaf de webserver mogelijk te maken.

Error sending mail: authentication failure SMTP: STARTTLS

PEAR's mail zal proberen om TLS te gebruiken bij het maken van een verbinding met de mailserver als de server dit ondersteunt, zelfs als u geen ssl:// in de host opgeeft. Maar als het servercertificaat niet geldig is (CA wordt niet vertrouwd, het certificaat is verlopen, CN komt niet overeen met de servernaam/IP-adres, etc) zal het weigeren te werken, en in plaats daarvan krijgt u de volgende fout:

authentication failure [SMTP: STARTTLS failed (code: 220, response: begin TLS negotiation)]

Je moet het certificaatproblemen oplossen zodat mail werkt.

Timeout issues

Als de verkeerde poort wordt gebruikt, zal e-mail timeout zonder een fout te retourneren, en de website zal niet reageren op de gebruiker. Raadpleeg de handleiding van uw e-mailprovider of probeer de andere gangbare SMTP-poorten: 25, 465 en 587.

Timeout problemen met AWS SES

Standaard beperkt Amazon EC2 het verkeer op SMTP-poort 25 voor alle instances. Als u timeouts blijft ontvangen van met SMTP-poort 25, kunt u vragen om de throttle te verwijderen of u kunt de poort die wordt gebruikt voor het verzenden wijzigen (bijvoorbeeld 587). Voor meer informatie, zie Hoe kan ik problemen met SMTP-connectiviteit of time-out problemen met Amazon SES oplossen?


Zie ook