Address.php

Go to the documentation of this file.

<?php

namespace Elgg\Email;

use Zend\Mail\Address as ZendAddress;
use Zend\Mail\Exception\InvalidArgumentException;
use Zend\Validator\EmailAddress as EmailAddressValidator;
use Zend\Validator\Hostname;

class Address extends ZendAddress {
    
    public function setEmail($email) {
        
        if (!is_string($email) || empty($email)) {
            throw new InvalidArgumentException('Email must be a valid email address');
        }
        
        if (preg_match("/[\r\n]/", $email)) {
            throw new InvalidArgumentException('CRLF injection detected');
        }
        
        $emailAddressValidator = new EmailAddressValidator(Hostname::ALLOW_DNS | Hostname::ALLOW_LOCAL);
        if (!$emailAddressValidator->isValid($email)) {
            $invalidMessages = $emailAddressValidator->getMessages();
            throw new InvalidArgumentException(array_shift($invalidMessages));
        }
        
        $this->email = $email;
    }
    
    public function setName($name) {
        
        if (!is_string($name)) {
            throw new InvalidArgumentException('Name must be a string');
        }
        
        if (preg_match("/[\r\n]/", $name)) {
            throw new InvalidArgumentException('CRLF injection detected');
        }
        
        $this->name = $name;
    }
    
    public function unsetName() {
        $this->name = null;
    }
    
    public static function fromString($contact, $ignored = null) {
        $containsName = preg_match('/<(.*)>/', $contact, $matches) == 1;
        if ($containsName) {
            $name = trim(substr($contact, 0, strpos($contact, '<')));
            return new self($matches[1], $name);
        } else {
            return new self(trim($contact));
        }
    }
    
    public static function getFormattedEmailAddress($email, $name = null) {
        $mail = new self($email, $name);
        return $mail->toString();
    }
}