Handbuch:$wgSMTP
E-Mail-Einstellungen: $wgSMTP | |
---|---|
Zur Verwendung einer direkten (authentifizierten) SMTP-Server-Verbindung. |
|
Eingeführt in Version: | 1.2.0 |
Entfernt in Version: | Weiterhin vorhanden |
Erlaubte Werte: | siehe unten |
Standardwert: | false |
Andere Einstellungen: Alphabetisch | Nach Funktion |
Einzelheiten
Um E-Mails zu versenden (Bestätigungen, Benachrichtigungen, Special:Emailuser ), sollten Sie einen E-Mail-Anbieter verwenden und MediaWiki erlauben, E-Mails mit diesem über SMTP zu versenden. Die Einstellungen werden als Array in $wgSMTP gespeichert. Setzen Sie den Wert auf false (Standardwert), um die integrierte PHP-Funktion mail() zu verwenden. Beachten Sie jedoch, dass Ihre E-Mails in diesem Fall höchstwahrscheinlich im Spam-Ordner des Benutzers landen werden.
Konfigurieren Sie auch $wgEmergencyContact
und vergewissern Sie sich, dass $wgPasswordSender
mit der Absender-E-Mail-Adresse übereinstimmt.
$wgSMTP wird folgendermaßen konfiguriert:
$wgSMTP = [
'host' => 'mail.example.com', // kann auch eine IP-Adresse sein. Wo sich der SMTP-Server befindet. Wenn Sie SSL oder TLS verwenden, fügen Sie das Präfix "ssl://" oder "tls://" hinzu.
'IDHost' => 'example.com', // In der Regel ist dies der Domänenname Ihrer Website (z. B. mywiki.org)
'localhost' => 'example.com', // Wie IDHost oben; wird von einigen Mailservern benötigt
'port' => 587, // Port für die Verbindung zum SMTP-Server
'auth' => true, // Soll SMTP-Authentifizierung verwendet werden (true oder false)
'username' => 'my_user_name', // Für die SMTP-Authentifizierung zu verwendender Benutzername (falls verwendet)
'password' => 'my_password' // Passwort für die SMTP-Authentifizierung (falls verwendet)
];
IDHost
ist eine MediaWiki-spezifische Einstellung, die verwendet wird, um den Message-ID E-Mail-Header zu erstellen (siehe RFC 2822, sec 3.6.4 für weitere Informationen über eine korrekt formatierte Message-ID).
Wenn nicht angegeben, wird standardmäßig $wgServer verwendet.
Für die übrigen Einstellungen siehe Mail::factory() für eine ausführlichere Beschreibung.
(Blättern Sie nach unten zu den Parametern für smtp
.)
Beispiele
Fehlerbehebung
Error sending mail: Unknown error in PHP's mail() function MediaWiki
Be sure that $wgEmergencyContact
and $wgPasswordSender
are set correctly, and match your email address.
Some hosts will reject to send an email with a sender that doesn't match the account that sends the email.
If your server has SELinux enabled, be sure to configure it correctly to enable sending mails from the webserver.
Error sending mail: authentication failure SMTP: STARTTLS
PEAR's mail will try to use TLS when connecting to the mail server if the server supports it, even if you don't specify ssl:// in the host. But if the server certificate is not valid (CA not trusted, certificate has expired, CN does not match server name/IP address, etc.) it will refuse to work, and instead you'll get the following error:
authentication failure [SMTP: STARTTLS failed (code: 220, response: begin TLS negotiation)]
You must fix the certificate issues for mail to work.
Timeout-Probleme
If the incorrect port is used, email will timeout without returning an error, and the website will appear unresponsive to the user. Consult your email provider's manual or try the other common SMTP ports: 25, 465, and 587.
- Timeout issues with AWS SES
By default, Amazon EC2 throttles traffic on SMTP port 25 for all instances. If you continue to receive timeout errors using SMTP port 25, you can request that the throttle be removed or you can change the port that is used for sending (for example, 587). For more information, see How do I troubleshoot SMTP connectivity or timeout issues with Amazon SES?
require_once(): Failed opening required Net/Socket.php
Check your LocalSettings.php for any lines that call set_include_path
. These should not be needed but can mess up SMTP support. Remove them from LocalSettings.php if present.
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.
Siehe auch
- Konfiguration
- Handbuch:Konfigurationseinstellungen - diverse emailbezogene Einstellungen
- Handbuch:$wgEnableEmail (enabled by default)
- Erweiterungen