MailAddress.php

Go to the documentation of this file.

<?php
class MailAddress {
    public $name;
 
    public $realName;
 
    public $address;
 
    function __construct( $address, $name = null, $realName = null ) {
        if ( is_object( $address ) && $address instanceof User ) {
            // Old calling format, now deprecated
            wfDeprecated( __METHOD__ . ' with a User object', '1.24' );
            $this->address = $address->getEmail();
            $this->name = $address->getName();
            $this->realName = $address->getRealName();
        } else {
            $this->address = strval( $address );
            $this->name = strval( $name );
            $this->realName = strval( $realName );
        }
    }
 
    public static function newFromUser( User $user ) {
        return new MailAddress( $user->getEmail(), $user->getName(), $user->getRealName() );
    }
 
    function toString() {
        # 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->address ) {
            if ( $this->name != '' && !wfIsWindows() ) {
                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}>";
            } else {
                return $this->address;
            }
        } else {
            return "";
        }
    }
 
    function __toString() {
        return $this->toString();
    }
}