Jump to navigation Jump to search
This page is a translated version of the page Manual:$wgSMTP and the translation is 33% complete.

Other languages:
English • ‎français • ‎magyar • ‎polski • ‎português do Brasil • ‎中文 • ‎日本語
Configurações de e-mail: $wgSMTP
Para utilizar uma conexão direta (autenticada) com o servidor SMTP.
Introduzido na versão:1.2.0
Removido na versão:ainda em uso
Valores permitidos:(veja abaixo)
Valor padrão:false
Outras definições: Alfabético | Por função


Para utilizar uma conexão direta (autenticada) com o servidor SMTP, você precisará preencher um array com detalhes sobre sua conexão. Defina como false (o valor padrão) para usar a função embutida PHP mail().


$wgSMTP = array(
 'host'     => "", // could also be an IP address. Where the SMTP server is located
 'IDHost'   => "",      // Generally this will be the domain name of your website (aka
 'port'     => 25,                 // Port to use when connecting to the SMTP server
 'auth'     => true,               // Should we use SMTP authentication (true or false)
 'username' => "my_user_name",     // Username to use for SMTP authentication (if being used)
 'password' => "my_password"       // Password to use for SMTP authentication (if being used)

'IDHost' é uma configuração específica do MediaWiki usado para construir o cabeçalho de e-mail ID de mensagens (veja RFC 2822, sec 3.6.4 para mais informações sobre uma ID de mensagem formatada corretamente). If not provided, will default to $wgServer . Para as demais configurações, consulte Mail::factory() para uma descrição mais completa. (Role para baixo até o parâmetro smtp.)

Install dependencies (MW 1.31 and earlier)

Atenção Atenção: Esta configuração requer o pacote Mail do PEAR para ser insltalado (execute pear install MAIL Net_SMTP, e você pode executar o "pear list" para confirmar). Since MediaWiki 1.27 (git #a372e170), the required PEAR dependencies are already bundled. Se você receber uma mensagem de erro informando que o PEAR não está instalado, então instale php-pear e, em seguida, tente novamente. It may also cause conflicts if you have different versions of those PEAR packages installed on your system. In that case, you can remove the installed ones with the command pear uninstall mail pear/Auth_SASL net_smtp

You may also install pear/mail with Composer with the command:

composer require pear/mail

MediaWiki 1.31 added pear/mail to the required section of composer.json, thereby bundling it. Previously (MW 1.26 to 1.30) it had only be in the suggest section. As such, for MW 1.31+ installation of pear/mail is not required. However, pear/net_smtp was not added to composer.json until MW 1.32, and thus it must be installed. For MediaWiki 1.30 and earlier pear/mail must be installed.

These packages can be installed with Composer by creating a composer.local.json like:

	"require": {
		"pear/mail": "1.4.1",
		"pear/net_smtp": "1.8.0"

See Composer#Using_composer-merge-plugin.


  • Outlook Exchange Server
$wgSMTP = [
 'host'     => "",
 'IDHost'   => "",
 'port'     => 25,
 'auth'     => false,
 'username' => "",
 'password' => "pw1245"
  • Gmail

Note that you'll need to use an "App password" instead of your usual Gmail password, as explained here.

$wgSMTP = [
 'host' => 'ssl://',
 'IDHost' => '',
 'localhost' => '',
 'port' => 465,
 'username' => '',
 'password' => '16 digit special gmail app password',
 'auth' => true

After this you may get an authentication failure type error. You will need to sign into the gmail account you are using and verify that the person that just signed in is you. You only need to verify this one time. (gmail will send you an email and you just follow the instructions)

Troubleshooting email

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.

Be sure you have installed the packages required to send the mail.

$ sudo pear install mail
$ sudo pear install net_smtp

See also possible issues in tarefa T32260.

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.

Ver também