Kézikönyv:$wgSMTP

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

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

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 = array(
 '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 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).

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.

Lásd még