3 * Classes used to send e-mails
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 * http://www.gnu.org/copyleft/gpl.html
21 * @author <brion@pobox.com>
22 * @author <mail@tgries.de>
23 * @author Tim Starling
24 * @author Luke Welling lwelling@wikimedia.org
28 * Stores a single person's name and email address.
29 * These are passed in via the constructor, and will be returned in SMTP
30 * header format when requested.
49 * @param string $address String with an email address
50 * @param string|null $name Human-readable name if a string address is given
51 * @param string|null $realName Human-readable real name if a string address is given
53 public function __construct( $address, $name = null, $realName = null ) {
54 $this->address
= strval( $address );
55 $this->name
= strval( $name );
56 $this->realName
= strval( $realName );
60 * Create a new MailAddress object for the given user
66 public static function newFromUser( User
$user ) {
67 return new MailAddress( $user->getEmail(), $user->getName(), $user->getRealName() );
71 * Return formatted and quoted address to insert into SMTP headers
74 public function toString() {
75 if ( !$this->address
) {
79 # PHP's mail() implementation under Windows is somewhat shite, and
80 # can't handle "Joe Bloggs <joe@bloggs.com>" format email addresses,
81 # so don't bother generating them
82 if ( $this->name
=== '' ||
wfIsWindows() ) {
83 return $this->address
;
86 global $wgEnotifUseRealName;
87 $name = ( $wgEnotifUseRealName && $this->realName
!== '' ) ?
$this->realName
: $this->name
;
88 $quoted = UserMailer
::quotedPrintable( $name );
89 // Must only be quoted if string does not use =? encoding (T191931)
90 if ( $quoted === $name ) {
91 $quoted = '"' . addslashes( $quoted ) . '"';
94 return "$quoted <{$this->address}>";
97 public function __toString() {
98 return $this->toString();