Manual:$wgSMTP
Email instellingen: $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 |
Andere instellingen: Alfabetisch | Per functie |
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 If using SSL or TLS, add the prefix "ssl://" or "tls://".
'IDHost' => 'example.com', // Over het algemeen zal dit de domeinnaam van uw website zijn (ofwel mywiki.org)
'port' => 587, // Poort om te gebruiken bij het maken van een verbinding met de SMTP-server
'auth' => true, // Moet er gebruik gemaakt worden van SMTP-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)
For MediaWiki version 1.31 and earlier) |
---|
MediaWiki 1.31 voegde Deze pakketten kunnen worden geïnstalleerd met Composer door het creëren van een {
"require": {
"pear/mail": "1.4.1",
"pear/net_smtp": "1.8.0"
}
}
|
Voorbeelden
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.
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?
Mailserver does not accept sender (From)
If you are not able to send any email because your mailserver says something like "you are not authorized to use this sender" (or something like that), first check if your "SMTP username" is consistent with your email sender (see $wgPasswordSender ) then, if you have an old wiki, see $wgUserEmailUseReplyTo .
If you don't solve it, contact your mailserver.
Zie ook
- Configuration
- Manual:Configuration settings#Email settings - various settings related to email
- Manual:$wgEnableEmail (enabled by default)
- Extensions