summaryrefslogtreecommitdiff
path: root/vendor/symfony/mime/Address.php
diff options
context:
space:
mode:
Diffstat (limited to 'vendor/symfony/mime/Address.php')
-rw-r--r--vendor/symfony/mime/Address.php98
1 files changed, 98 insertions, 0 deletions
diff --git a/vendor/symfony/mime/Address.php b/vendor/symfony/mime/Address.php
new file mode 100644
index 0000000000..86a80426db
--- /dev/null
+++ b/vendor/symfony/mime/Address.php
@@ -0,0 +1,98 @@
+<?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\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>
+ *
+ * @experimental in 4.3
+ */
+class Address
+{
+ private static $validator;
+ private static $encoder;
+
+ private $address;
+
+ public function __construct(string $address)
+ {
+ 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));
+ }
+
+ if (null === self::$validator) {
+ self::$validator = new EmailValidator();
+ }
+
+ if (!self::$validator->isValid($address, new RFCValidation())) {
+ throw new RfcComplianceException(sprintf('Email "%s" does not comply with addr-spec of RFC 2822.', $address));
+ }
+
+ $this->address = $address;
+ }
+
+ public function getAddress(): string
+ {
+ return $this->address;
+ }
+
+ public function getEncodedAddress(): string
+ {
+ if (null === self::$encoder) {
+ self::$encoder = new IdnAddressEncoder();
+ }
+
+ return self::$encoder->encodeString($this->address);
+ }
+
+ public function toString(): string
+ {
+ return $this->getEncodedAddress();
+ }
+
+ /**
+ * @param Address|string $address
+ */
+ public static function create($address): self
+ {
+ if ($address instanceof self) {
+ return $address;
+ }
+ if (\is_string($address)) {
+ return new self($address);
+ }
+
+ throw new InvalidArgumentException(sprintf('An address can be an instance of Address or a string ("%s") given).', \is_object($address) ? \get_class($address) : \gettype($address)));
+ }
+
+ /**
+ * @param (Address|string)[] $addresses
+ *
+ * @return Address[]
+ */
+ public static function createArray(array $addresses): array
+ {
+ $addrs = [];
+ foreach ($addresses as $address) {
+ $addrs[] = self::create($address);
+ }
+
+ return $addrs;
+ }
+}