MailAddress.php

Go to the documentation of this file.

<?php
use MediaWiki\Mail\UserEmailContact;
 
class MailAddress {
    public $name;
 
    public $realName;
 
    public $address;
 
    public function __construct( $address, $name = null, $realName = null ) {
        $this->address = strval( $address );
        $this->name = strval( $name );
        $this->realName = strval( $realName );
    }
 
    public static function newFromUser( UserEmailContact $user ) {
        return new MailAddress( $user->getEmail(), $user->getUser()->getName(), $user->getRealName() );
    }
 
    public function toString() {
        if ( !$this->address ) {
            return '';
        }
 
        # PHP's mail() implementation under Windows is somewhat shite, and
        # can't handle "Joe Bloggs <joe@bloggs.com>" format email addresses,
        # so don't bother generating them
        if ( $this->name === '' || wfIsWindows() ) {
            return $this->address;
        }
 
        global $wgEnotifUseRealName;
        $name = ( $wgEnotifUseRealName && $this->realName !== '' ) ? $this->realName : $this->name;
        $quoted = UserMailer::quotedPrintable( $name );
        // Must only be quoted if string does not use =? encoding (T191931)
        if ( $quoted === $name ) {
            $quoted = '"' . addslashes( $quoted ) . '"';
        }
 
        return "$quoted <{$this->address}>";
    }
 
    public function __toString() {
        return $this->toString();
    }
}