359 lines
9.3 KiB
PHP
359 lines
9.3 KiB
PHP
<?php
|
|
|
|
/*
|
|
* This file is part of SwiftMailer.
|
|
* (c) 2004-2009 Chris Corbyn
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE
|
|
* file that was distributed with this source code.
|
|
*/
|
|
|
|
use Egulias\EmailValidator\EmailValidator;
|
|
use Egulias\EmailValidator\Validation\RFCValidation;
|
|
|
|
/**
|
|
* A Mailbox Address MIME Header for something like From or Sender.
|
|
*
|
|
* @author Chris Corbyn
|
|
*/
|
|
class Swift_Mime_Headers_MailboxHeader extends Swift_Mime_Headers_AbstractHeader
|
|
{
|
|
/**
|
|
* The mailboxes used in this Header.
|
|
*
|
|
* @var string[]
|
|
*/
|
|
private $mailboxes = [];
|
|
|
|
/**
|
|
* The strict EmailValidator.
|
|
*
|
|
* @var EmailValidator
|
|
*/
|
|
private $emailValidator;
|
|
|
|
private $addressEncoder;
|
|
|
|
/**
|
|
* Creates a new MailboxHeader with $name.
|
|
*
|
|
* @param string $name of Header
|
|
*/
|
|
public function __construct($name, Swift_Mime_HeaderEncoder $encoder, EmailValidator $emailValidator, Swift_AddressEncoder $addressEncoder = null)
|
|
{
|
|
$this->setFieldName($name);
|
|
$this->setEncoder($encoder);
|
|
$this->emailValidator = $emailValidator;
|
|
$this->addressEncoder = $addressEncoder ?? new Swift_AddressEncoder_IdnAddressEncoder();
|
|
}
|
|
|
|
/**
|
|
* Get the type of Header that this instance represents.
|
|
*
|
|
* @see TYPE_TEXT, TYPE_PARAMETERIZED, TYPE_MAILBOX
|
|
* @see TYPE_DATE, TYPE_ID, TYPE_PATH
|
|
*
|
|
* @return int
|
|
*/
|
|
public function getFieldType()
|
|
{
|
|
return self::TYPE_MAILBOX;
|
|
}
|
|
|
|
/**
|
|
* Set the model for the field body.
|
|
*
|
|
* This method takes a string, or an array of addresses.
|
|
*
|
|
* @param mixed $model
|
|
*
|
|
* @throws Swift_RfcComplianceException
|
|
*/
|
|
public function setFieldBodyModel($model)
|
|
{
|
|
$this->setNameAddresses($model);
|
|
}
|
|
|
|
/**
|
|
* Get the model for the field body.
|
|
*
|
|
* This method returns an associative array like {@link getNameAddresses()}
|
|
*
|
|
* @throws Swift_RfcComplianceException
|
|
*
|
|
* @return array
|
|
*/
|
|
public function getFieldBodyModel()
|
|
{
|
|
return $this->getNameAddresses();
|
|
}
|
|
|
|
/**
|
|
* Set a list of mailboxes to be shown in this Header.
|
|
*
|
|
* The mailboxes can be a simple array of addresses, or an array of
|
|
* key=>value pairs where (email => personalName).
|
|
* Example:
|
|
* <code>
|
|
* <?php
|
|
* //Sets two mailboxes in the Header, one with a personal name
|
|
* $header->setNameAddresses(array(
|
|
* 'chris@swiftmailer.org' => 'Chris Corbyn',
|
|
* 'mark@swiftmailer.org' //No associated personal name
|
|
* ));
|
|
* ?>
|
|
* </code>
|
|
*
|
|
* @see __construct()
|
|
* @see setAddresses()
|
|
* @see setValue()
|
|
*
|
|
* @param string|string[] $mailboxes
|
|
*
|
|
* @throws Swift_RfcComplianceException
|
|
*/
|
|
public function setNameAddresses($mailboxes)
|
|
{
|
|
$this->mailboxes = $this->normalizeMailboxes((array) $mailboxes);
|
|
$this->setCachedValue(null); //Clear any cached value
|
|
}
|
|
|
|
/**
|
|
* Get the full mailbox list of this Header as an array of valid RFC 2822 strings.
|
|
*
|
|
* Example:
|
|
* <code>
|
|
* <?php
|
|
* $header = new Swift_Mime_Headers_MailboxHeader('From',
|
|
* array('chris@swiftmailer.org' => 'Chris Corbyn',
|
|
* 'mark@swiftmailer.org' => 'Mark Corbyn')
|
|
* );
|
|
* print_r($header->getNameAddressStrings());
|
|
* // array (
|
|
* // 0 => Chris Corbyn <chris@swiftmailer.org>,
|
|
* // 1 => Mark Corbyn <mark@swiftmailer.org>
|
|
* // )
|
|
* ?>
|
|
* </code>
|
|
*
|
|
* @see getNameAddresses()
|
|
* @see toString()
|
|
*
|
|
* @throws Swift_RfcComplianceException
|
|
*
|
|
* @return string[]
|
|
*/
|
|
public function getNameAddressStrings()
|
|
{
|
|
return $this->createNameAddressStrings($this->getNameAddresses());
|
|
}
|
|
|
|
/**
|
|
* Get all mailboxes in this Header as key=>value pairs.
|
|
*
|
|
* The key is the address and the value is the name (or null if none set).
|
|
* Example:
|
|
* <code>
|
|
* <?php
|
|
* $header = new Swift_Mime_Headers_MailboxHeader('From',
|
|
* array('chris@swiftmailer.org' => 'Chris Corbyn',
|
|
* 'mark@swiftmailer.org' => 'Mark Corbyn')
|
|
* );
|
|
* print_r($header->getNameAddresses());
|
|
* // array (
|
|
* // chris@swiftmailer.org => Chris Corbyn,
|
|
* // mark@swiftmailer.org => Mark Corbyn
|
|
* // )
|
|
* ?>
|
|
* </code>
|
|
*
|
|
* @see getAddresses()
|
|
* @see getNameAddressStrings()
|
|
*
|
|
* @return string[]
|
|
*/
|
|
public function getNameAddresses()
|
|
{
|
|
return $this->mailboxes;
|
|
}
|
|
|
|
/**
|
|
* Makes this Header represent a list of plain email addresses with no names.
|
|
*
|
|
* Example:
|
|
* <code>
|
|
* <?php
|
|
* //Sets three email addresses as the Header data
|
|
* $header->setAddresses(
|
|
* array('one@domain.tld', 'two@domain.tld', 'three@domain.tld')
|
|
* );
|
|
* ?>
|
|
* </code>
|
|
*
|
|
* @see setNameAddresses()
|
|
* @see setValue()
|
|
*
|
|
* @param string[] $addresses
|
|
*
|
|
* @throws Swift_RfcComplianceException
|
|
*/
|
|
public function setAddresses($addresses)
|
|
{
|
|
$this->setNameAddresses(array_values((array) $addresses));
|
|
}
|
|
|
|
/**
|
|
* Get all email addresses in this Header.
|
|
*
|
|
* @see getNameAddresses()
|
|
*
|
|
* @return string[]
|
|
*/
|
|
public function getAddresses()
|
|
{
|
|
return array_keys($this->mailboxes);
|
|
}
|
|
|
|
/**
|
|
* Remove one or more addresses from this Header.
|
|
*
|
|
* @param string|string[] $addresses
|
|
*/
|
|
public function removeAddresses($addresses)
|
|
{
|
|
$this->setCachedValue(null);
|
|
foreach ((array) $addresses as $address) {
|
|
unset($this->mailboxes[$address]);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get the string value of the body in this Header.
|
|
*
|
|
* This is not necessarily RFC 2822 compliant since folding white space will
|
|
* not be added at this stage (see {@link toString()} for that).
|
|
*
|
|
* @see toString()
|
|
*
|
|
* @throws Swift_RfcComplianceException
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getFieldBody()
|
|
{
|
|
// Compute the string value of the header only if needed
|
|
if (null === $this->getCachedValue()) {
|
|
$this->setCachedValue($this->createMailboxListString($this->mailboxes));
|
|
}
|
|
|
|
return $this->getCachedValue();
|
|
}
|
|
|
|
/**
|
|
* Normalizes a user-input list of mailboxes into consistent key=>value pairs.
|
|
*
|
|
* @param string[] $mailboxes
|
|
*
|
|
* @return string[]
|
|
*/
|
|
protected function normalizeMailboxes(array $mailboxes)
|
|
{
|
|
$actualMailboxes = [];
|
|
|
|
foreach ($mailboxes as $key => $value) {
|
|
if (\is_string($key)) {
|
|
//key is email addr
|
|
$address = $key;
|
|
$name = $value;
|
|
} else {
|
|
$address = $value;
|
|
$name = null;
|
|
}
|
|
$this->assertValidAddress($address);
|
|
$actualMailboxes[$address] = $name;
|
|
}
|
|
|
|
return $actualMailboxes;
|
|
}
|
|
|
|
/**
|
|
* Produces a compliant, formatted display-name based on the string given.
|
|
*
|
|
* @param string $displayName as displayed
|
|
* @param bool $shorten the first line to make remove for header name
|
|
*
|
|
* @return string
|
|
*/
|
|
protected function createDisplayNameString($displayName, $shorten = false)
|
|
{
|
|
return $this->createPhrase($this, $displayName, $this->getCharset(), $this->getEncoder(), $shorten);
|
|
}
|
|
|
|
/**
|
|
* Creates a string form of all the mailboxes in the passed array.
|
|
*
|
|
* @param string[] $mailboxes
|
|
*
|
|
* @throws Swift_RfcComplianceException
|
|
*
|
|
* @return string
|
|
*/
|
|
protected function createMailboxListString(array $mailboxes)
|
|
{
|
|
return implode(', ', $this->createNameAddressStrings($mailboxes));
|
|
}
|
|
|
|
/**
|
|
* Redefine the encoding requirements for mailboxes.
|
|
*
|
|
* All "specials" must be encoded as the full header value will not be quoted
|
|
*
|
|
* @see RFC 2822 3.2.1
|
|
*
|
|
* @param string $token
|
|
*
|
|
* @return bool
|
|
*/
|
|
protected function tokenNeedsEncoding($token)
|
|
{
|
|
return preg_match('/[()<>\[\]:;@\,."]/', $token) || parent::tokenNeedsEncoding($token);
|
|
}
|
|
|
|
/**
|
|
* Return an array of strings conforming the the name-addr spec of RFC 2822.
|
|
*
|
|
* @param string[] $mailboxes
|
|
*
|
|
* @return string[]
|
|
*/
|
|
private function createNameAddressStrings(array $mailboxes)
|
|
{
|
|
$strings = [];
|
|
|
|
foreach ($mailboxes as $email => $name) {
|
|
$mailboxStr = $this->addressEncoder->encodeString($email);
|
|
if (null !== $name) {
|
|
$nameStr = $this->createDisplayNameString($name, empty($strings));
|
|
$mailboxStr = $nameStr.' <'.$mailboxStr.'>';
|
|
}
|
|
$strings[] = $mailboxStr;
|
|
}
|
|
|
|
return $strings;
|
|
}
|
|
|
|
/**
|
|
* Throws an Exception if the address passed does not comply with RFC 2822.
|
|
*
|
|
* @param string $address
|
|
*
|
|
* @throws Swift_RfcComplianceException if invalid
|
|
*/
|
|
private function assertValidAddress($address)
|
|
{
|
|
if (!$this->emailValidator->isValid($address, new RFCValidation())) {
|
|
throw new Swift_RfcComplianceException('Address in mailbox given ['.$address.'] does not comply with RFC 2822, 3.6.2.');
|
|
}
|
|
}
|
|
}
|