121 lines
3.6 KiB
PHP
121 lines
3.6 KiB
PHP
<?php
|
|
|
|
/*
|
|
* This file is part of the Symfony package.
|
|
*
|
|
* (c) Fabien Potencier <fabien@symfony.com>
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE
|
|
* file that was distributed with this source code.
|
|
*/
|
|
|
|
namespace Symfony\Component\Mime;
|
|
|
|
use Egulias\EmailValidator\EmailValidator;
|
|
use Egulias\EmailValidator\Validation\MessageIDValidation;
|
|
use Egulias\EmailValidator\Validation\RFCValidation;
|
|
use Symfony\Component\Mime\Encoder\IdnAddressEncoder;
|
|
use Symfony\Component\Mime\Exception\InvalidArgumentException;
|
|
use Symfony\Component\Mime\Exception\LogicException;
|
|
use Symfony\Component\Mime\Exception\RfcComplianceException;
|
|
|
|
/**
|
|
* @author Fabien Potencier <fabien@symfony.com>
|
|
*/
|
|
final class Address
|
|
{
|
|
/**
|
|
* A regex that matches a structure like 'Name <email@address.com>'.
|
|
* It matches anything between the first < and last > as email address.
|
|
* This allows to use a single string to construct an Address, which can be convenient to use in
|
|
* config, and allows to have more readable config.
|
|
* This does not try to cover all edge cases for address.
|
|
*/
|
|
private const FROM_STRING_PATTERN = '~(?<displayName>[^<]*)<(?<addrSpec>.*)>[^>]*~';
|
|
|
|
private static EmailValidator $validator;
|
|
private static IdnAddressEncoder $encoder;
|
|
|
|
private string $address;
|
|
private string $name;
|
|
|
|
public function __construct(string $address, string $name = '')
|
|
{
|
|
if (!class_exists(EmailValidator::class)) {
|
|
throw new LogicException(sprintf('The "%s" class cannot be used as it needs "%s"; try running "composer require egulias/email-validator".', __CLASS__, EmailValidator::class));
|
|
}
|
|
|
|
self::$validator ??= new EmailValidator();
|
|
|
|
$this->address = trim($address);
|
|
$this->name = trim(str_replace(["\n", "\r"], '', $name));
|
|
|
|
if (!self::$validator->isValid($this->address, class_exists(MessageIDValidation::class) ? new MessageIDValidation() : new RFCValidation())) {
|
|
throw new RfcComplianceException(sprintf('Email "%s" does not comply with addr-spec of RFC 2822.', $address));
|
|
}
|
|
}
|
|
|
|
public function getAddress(): string
|
|
{
|
|
return $this->address;
|
|
}
|
|
|
|
public function getName(): string
|
|
{
|
|
return $this->name;
|
|
}
|
|
|
|
public function getEncodedAddress(): string
|
|
{
|
|
self::$encoder ??= new IdnAddressEncoder();
|
|
|
|
return self::$encoder->encodeString($this->address);
|
|
}
|
|
|
|
public function toString(): string
|
|
{
|
|
return ($n = $this->getEncodedName()) ? $n.' <'.$this->getEncodedAddress().'>' : $this->getEncodedAddress();
|
|
}
|
|
|
|
public function getEncodedName(): string
|
|
{
|
|
if ('' === $this->getName()) {
|
|
return '';
|
|
}
|
|
|
|
return sprintf('"%s"', preg_replace('/"/u', '\"', $this->getName()));
|
|
}
|
|
|
|
public static function create(self|string $address): self
|
|
{
|
|
if ($address instanceof self) {
|
|
return $address;
|
|
}
|
|
|
|
if (false === strpos($address, '<')) {
|
|
return new self($address);
|
|
}
|
|
|
|
if (!preg_match(self::FROM_STRING_PATTERN, $address, $matches)) {
|
|
throw new InvalidArgumentException(sprintf('Could not parse "%s" to a "%s" instance.', $address, self::class));
|
|
}
|
|
|
|
return new self($matches['addrSpec'], trim($matches['displayName'], ' \'"'));
|
|
}
|
|
|
|
/**
|
|
* @param array<Address|string> $addresses
|
|
*
|
|
* @return Address[]
|
|
*/
|
|
public static function createArray(array $addresses): array
|
|
{
|
|
$addrs = [];
|
|
foreach ($addresses as $address) {
|
|
$addrs[] = self::create($address);
|
|
}
|
|
|
|
return $addrs;
|
|
}
|
|
}
|