Open main menu
This page is a translated version of the page Manual:$wgSMTP and the translation is 79% complete.

Outdated translations are marked like this.
Other languages:
English • ‎français • ‎magyar • ‎polski • ‎português do Brasil • ‎中文 • ‎日本語
Configuration des courriels: $wgSMTP
Pour utiliser une connexion directe (authentifiée) au serveur SMTP.
Introduit dans la version :1.2.0
Retiré dans la version :Encore utilisé
Valeurs autorisées :voir ci-dessous
Valeur par défaut :false

Contents

Détails

Pour utiliser une connexion directe (authentifiée) au serveur SMTP, vous devez remplir un tableau. Mettez-le à false (la valeur par défaut) pour utiliser la fonction intégrée PHP mail().

Par exemple:

$wgSMTP = array(
 'host'     => "mail.example.com", // pourrait également être une adresse IP. Où se trouve le serveur SMTP
 'IDHost'   => "example.com",      // Généralement, ce sera le nom de domaine de votre site web (aka mywiki.org)
 'port'     => 25,                 // Port à utiliser lors de la connexion au serveur SMTP
 'auth'     => true,               // Devrions-nous utiliser l'authentification SMTP (true ou false)
 'username' => "my_user_name",     // Nom d'utilisateur à utiliser pour l'authentification SMTP (si utilisé)
 'password' => "my_password"       // Mot de passe à utiliser pour l'authentification SMTP (si utilisé)
);

'IDHost' est un paramètre spécifique à MediaWiki utilisé pour construire l'entête Message-ID du courriel (voyez [$url RFC 2822, sec 3.6.4] pour plus d'information sur un Message-ID correctement formaté). Si non fourni, sera par défaut à $wgServer . Pour les autres paramètres, voyez Mail::factory() pour une description plus complète. (descendez jusqu'au paramètre smtp).

Install dependencies (MW 1.31 and earlier)

  Avertissement : Ce paramètre nécessite que le paquet Mail de PEAR soit installé (lancez "pear install MAIL Net_SMTP"). Depuis MediaWiki 1.27 (git #a372e170), les dépendances PEAR requises sont déjà groupées. Si vous obtenez un message d'erreur indiquant que pear n'est pas installé, installez php-pear, puis réessayez. 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.


Exemples

  • Outlook Exchange Server
$wgSMTP = [
 'host'     => "outlook.corporatedomain.com",
 'IDHost'   => "corporatationname.com",
 'port'     => 25,
 'auth'     => false,
 'username' => "name@corporationname.com",
 '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://smtp.gmail.com',
 'IDHost' => 'gmail.com',
 'localhost' => 'myservername.org',
 'port' => 465,
 'username' => 'myemail@gmail.com',
 'password' => '16 digit special gmail app password',
 'auth' => true
];

Après cela, vous pouvez obtenir une erreur de type d'échec d'authentification. Vous devrez vous connecter au compte Gmail que vous utilisez et vérifier que la personne qui vient de vous connecter est bien vous. Vous avez seulement besoin de vérifier ceci une fois. (Gmail vous enverra un email et vous aurez à suivre simplement les instructions)

Guide de dépannage

Erreur lors de l'envoi du mail: Erreur inconnue dans la fonction mail () de PHP Mediawiki

Assurez-vous que $wgEmergencyContact et $wgPasswordSender sont correctement définis et correspondent à votre adresse e-mail. Certains hôtes refusent d'envoyer un e-mail avec un expéditeur qui ne correspond pas au compte qui envoie l'e-mail.

Ensuite, installez les paquets nécessaires pour envoyer le courrier.

$ sudo pear install mail
$ sudo pear install net_smtp

Voir aussi les problèmes possibles dans tâche T32260.

Si votre serveur a SELinux activé, assurez-vous de le configurer correctement pour permettre l'envoi de mails depuis le serveur web.

Erreur lors de l'envoi du courrier: échec d'authentification SMTP: STARTTLS

Le courrier de PEAR essaiera d'utiliser TLS lors de la connexion au serveur de messagerie si le serveur le prend en charge, même si vous ne spécifiez pas ssl:// dans l'hôte.

Mais si le certificat du serveur n'est pas valide (CA non sécurisé, le certificat a expiré, etc.), il refusera de fonctionner et vous obtiendrez l'erreur suivante :

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

Vous devez corriger les problèmes de certificat pour que le courrier fonctionne.

Timeout issue with Amazon 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?

Voir aussi