MediaWiki REL1_28
UserMailer Class Reference

Collection of static functions for sending mail. More...

Static Public Member Functions

static arrayToHeaderString ( $headers, $endl=PHP_EOL)
 Creates a single string from an associative array.
 
static errorHandler ( $code, $string)
 Set the mail error message in self::$mErrorString.
 
static makeMsgId ()
 Create a value suitable for the MessageId Header.
 
static quotedPrintable ( $string, $charset='')
 Converts a string into quoted-printable format.
 
static rfc822Phrase ( $phrase)
 Converts a string into a valid RFC 822 "phrase", such as is used for the sender name.
 
static sanitizeHeaderValue ( $val)
 Strips bad characters from a header value to prevent PHP mail header injection attacks.
 
static send ( $to, $from, $subject, $body, $options=[])
 This function will perform a direct (authenticated) login to a SMTP Server to use for mail relaying if 'wgSMTP' specifies an array of parameters.
 

Static Protected Member Functions

static sendInternal (array $to, MailAddress $from, $subject, $body, $options=[])
 Helper function fo UserMailer::send() which does the actual sending.
 
static sendWithPear ( $mailer, $dest, $headers, $body)
 Send mail using a PEAR mailer.
 

Static Private Attributes

static $mErrorString
 

Detailed Description

Collection of static functions for sending mail.

Definition at line 30 of file UserMailer.php.

Member Function Documentation

◆ arrayToHeaderString()

static UserMailer::arrayToHeaderString (   $headers,
  $endl = PHP_EOL 
)
static

Creates a single string from an associative array.

Parameters
array$headersAssociative Array: keys are header field names, values are ... values.
string$endlThe end of line character. Defaults to "\\n"

Note RFC2822 says newlines must be CRLF (\r\n) but php mail naively "corrects" it and requires \n for the "correction" to work

Returns
string

Definition at line 67 of file UserMailer.php.

References $name, $value, as, and sanitizeHeaderValue().

Referenced by sendInternal().

◆ errorHandler()

static UserMailer::errorHandler (   $code,
  $string 
)
static

Set the mail error message in self::$mErrorString.

Parameters
int$codeError number
string$stringError message

Definition at line 446 of file UserMailer.php.

◆ makeMsgId()

static UserMailer::makeMsgId ( )
static

Create a value suitable for the MessageId Header.

Returns
string

Definition at line 82 of file UserMailer.php.

References $wgServer, $wgSMTP, global, wfParseUrl(), and wfWikiID().

Referenced by sendInternal().

◆ quotedPrintable()

static UserMailer::quotedPrintable (   $string,
  $charset = '' 
)
static

Converts a string into quoted-printable format.

Since
1.17

From PHP5.3 there is a built in function quoted_printable_encode() This method does not duplicate that. This method is doing Q encoding inside encoded-words as defined by RFC 2047 This is for email headers. The built in quoted_printable_encode() is for email bodies

Parameters
string$string
string$charset
Returns
string

Definition at line 485 of file UserMailer.php.

References $matches, and $out.

Referenced by sendInternal(), UserMailerTest\testQuotedPrintable(), and MailAddress\toString().

◆ rfc822Phrase()

static UserMailer::rfc822Phrase (   $phrase)
static

Converts a string into a valid RFC 822 "phrase", such as is used for the sender name.

Parameters
string$phrase
Returns
string

Definition at line 464 of file UserMailer.php.

References sanitizeHeaderValue().

◆ sanitizeHeaderValue()

static UserMailer::sanitizeHeaderValue (   $val)
static

Strips bad characters from a header value to prevent PHP mail header injection attacks.

Parameters
string$valString to be santizied
Returns
string

Definition at line 455 of file UserMailer.php.

Referenced by arrayToHeaderString(), and rfc822Phrase().

◆ send()

static UserMailer::send (   $to,
  $from,
  $subject,
  $body,
  $options = [] 
)
static

This function will perform a direct (authenticated) login to a SMTP Server to use for mail relaying if 'wgSMTP' specifies an array of parameters.

It requires PEAR:Mail to do that. Otherwise it just uses the standard PHP 'mail' function.

Parameters
MailAddress | MailAddress[]$toRecipient's email (or an array of them)
MailAddress$fromSender's email
string$subjectEmail's subject.
string$bodyEmail's text or Array of two strings to be the text and html bodies
array$options,'replyTo' MailAddress 'contentType' string default 'text/plain; charset=UTF-8' 'headers' array Extra headers to set
Exceptions
MWException
Exception
Returns
Status

Definition at line 114 of file UserMailer.php.

References $from, $options, $status, $wgAllowHTMLEmail, as, global, sendInternal(), and wfDebug().

Referenced by EmaillingJob\run(), EmailNotification\sendImpersonal(), User\sendMail(), EmailNotification\sendPersonalised(), and SpecialEmailUser\submit().

◆ sendInternal()

static UserMailer::sendInternal ( array  $to,
MailAddress  $from,
  $subject,
  $body,
  $options = [] 
)
staticprotected

Helper function fo UserMailer::send() which does the actual sending.

It expects a $to list which the UserMailerSplitTo hook would not split further.

Parameters
MailAddress[]$toArray of recipients' email addresses
MailAddress$fromSender's email
string$subjectEmail's subject.
string$bodyEmail's text or Array of two strings to be the text and html bodies
array$options,'replyTo' MailAddress 'contentType' string default 'text/plain; charset=UTF-8' 'headers' array Extra headers to set
Exceptions
MWException
Exception
Returns
Status

Definition at line 208 of file UserMailer.php.

References $e, $from, $mime, $options, $ret, $status, $wgAdditionalMailParams, $wgEnotifMaxRecips, $wgSMTP, arrayToHeaderString(), as, MWTimestamp\getLocalInstance(), SpecialPage\getTitleFor(), global, mail, makeMsgId(), PROTO_CANONICAL, quotedPrintable(), sendWithPear(), wfDebug(), and wfIsWindows().

Referenced by send().

◆ sendWithPear()

static UserMailer::sendWithPear (   $mailer,
  $dest,
  $headers,
  $body 
)
staticprotected

Send mail using a PEAR mailer.

Parameters
Mail_smtp$mailer
string$dest
string$headers
string$body
Returns
Status

Definition at line 43 of file UserMailer.php.

References wfDebug().

Referenced by sendInternal().

Member Data Documentation

◆ $mErrorString

UserMailer::$mErrorString
staticprivate

Definition at line 31 of file UserMailer.php.


The documentation for this class was generated from the following file: