Open main menu

Kézikönyv:$wgSMTP

This page is a translated version of the page Manual:$wgSMTP and the translation is 76% complete.

Outdated translations are marked like this.
Other languages:
English • ‎français • ‎magyar • ‎polski • ‎português do Brasil • ‎中文 • ‎日本語
Email settings: $wgSMTP
Közvetlen (hitelesített) SMTP-szerverkapcsolat használata.
Bevezetve:1.2.0
Eltávolítva:használatban
Megengedett értékek:lásd alább
Alapértelmezett érték:false

Contents

Részletek

A változóval egy közvetlen (hitelesített) SMTP-szerverkapcsolat definiálható; a részleteket egy tömbben kell megadni. „False” érték (alapértelmezés) esetén a PHP beépített mail() funkciója lesz használva.

Például

$wgSMTP = [
    'host'     => "mail.example.com", // IP-cím is lehet; az SMTP-szerver helye
    'IDHost'   => "example.com",      // Általánosságban ez lesz a webhelyed domainneve (pl. mywiki.org)
    'port'     => 25,                 // Az SMTP-szerverhez való kapcsolódáskor használandó port
    'auth'     => true,               // Szükséges-e SMTP-autentikáció használata (true vagy false)
    'username' => "my_user_name",     // SMTP-felhasználónév (ha szükséges)
    'password' => "my_password"       // SMTP-jelszó (ha szükséges)
];

Az „IDHost” egy MediaWiki-specifikus beállítás a Message-ID e-mail-fejléc használatához (további információk a Message-ID formázásához: RFC 2822, sec 3.6.4). Ha nincs megadva, értéke a $wgServer -ben megadott lesz. A többi beállítás részletes leírását lásd: Mail::factory(). (Görgess lejjebb az smtp paraméterhez.)

Install dependencies (MW 1.31 and earlier)
  Figyelem: Ehhez a beállításhoz szükséges a PEAR Mail-csomagjának telepítése (telepítéshez futtasd a pear install MAIL Net_SMTP parancsot, megerősítéshez használd a pear list-et). A MediaWiki 1.27 (git #a372e170) óta a szükséges PEAR-függőségeket a szoftver már tartalmazza. Ha a PEAR hiányáról szóló hibaüzenetet kapsz, telepítsd a php-pear paranccsal és próbáld újra. A különböző PEAR-csomagok jelenléte ütközésekhez vezethet. Ebben az esetben a telepített verziók a pear uninstall mail pear/Auth_SASL net_smtp paranccsal uninstallálhatóak.

A Composerrel a pear/mail-t is telepítheted a következő paranccsal:

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.


Példák

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

Vedd figyelembe, hogy a Gmail-jelszavad helyett az itt leírtak szerint az „App”-jelszavad kell használnod.

$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
];

Ezután a hitelesítési típussal kapcsolatos hibaüzenetet kaphatsz. Be kell jelentkezned Gmail-fiókodba és megerősítened, hogy te állsz a bejelentkezési kísérlet mögött. Ezt egyszer kell megtenned (kövesd a Gmail által küldött e-mailben szereplő instrukciókat).

AWS SES

Amazon Web Services' Simple E-mail Service can be used for SMTP support. Note that if your AWS SES instance is configured in 'Sandbox' mode you should change your settings to configuration parameters $wgPasswordSender and $wgEmergencyContact to an email address that you have verified in the AWS SES console. If new users register and they are not in the verified list, they will not get the email and you will be limited to 200 emails per day!

$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
];

E-mail-problémák megoldása

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

Győződj meg róla, hogy az $wgEmergencyContact és a $wgPasswordSender helyesen vannak kitöltve és megegyeznek az e-mail-címeddel. Ha a küldő és a fiók nem egyezik, néhány hoszt megtagadja az üzenetküldést.

Ellenőrizd, hogy telepítetted-e a szükséges csomagokat.

$ sudo pear install mail
$ sudo pear install net_smtp

A problémák további leírása: task T32260.

Ha a szervereden engedélyezve van az SELinux , az üzenetküldés engedélyezéséhez ellenőrizd, hogy helyesen van-e beállítva.

Error sending mail: authentication failure SMTP: STARTTLS

Ha a szerver támogatja a TLS-t, akkor a PEAR mail az üzenetküldő szerverhez kapcsolódáskor azt próbálja használni akkor is, ha nem specifikáltad az ssl://-t a hosztban. Ha a szerver tanúsítványa nem érvényes (nem megbízható, lejárt, a CN nem egyezik a szervernévvel, illetve IP-címmel stb.) akkor a funkció nem fog működni, és a következő hibaüzenetet fogod kapni:

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

Az e-mail-küldés működéséhez ki kell javítanod a tanúsítványhibákat.

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

Lásd még