REDROOM

Navigation

Breadcrumbs

/ / home / getspomw / royalsquad.us / vendor / symfony / mime

Create

Create File | Create Folder | Upload Files | Run Command

Edit File Size: 4.44 KB

/home/getspomw/royalsquad.us/vendor/symfony/mime/Address.php

Text Base64

<?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 (!str_contains($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;
    }

/**
     * Returns true if this address' localpart contains at least one
     * non-ASCII character, and false if it is only ASCII (or empty).
     *
     * This is a helper for Envelope, which has to decide whether to
     * the SMTPUTF8 extensions (RFC 6530 and following) for any given
     * message.
     *
     * The SMTPUTF8 extension is strictly required if any address
     * contains a non-ASCII character in its localpart. If non-ASCII
     * is only used in domains (e.g. horst@freiherr-von-mühlhausen.de)
     * then it is possible to send the message using IDN encoding
     * instead of SMTPUTF8. The most common software will display the
     * message as intended.
     */
    public function hasUnicodeLocalpart(): bool
    {
        return (bool) preg_match('/[\x80-\xFF].*@/', $this->address);
    }
}

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Directory Contents

Dirs: 9 Ã— Files: 18

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
Crypto DIR	-	drwxrwxrwx	2026-04-21 14:29:09	Edit Download recursive recursive
DependencyInjection DIR	-	drwxrwxrwx	2026-04-21 14:21:27	Edit Download recursive recursive
Encoder DIR	-	drwxrwxrwx	2026-04-21 09:10:19	Edit Download recursive recursive
Exception DIR	-	drwxrwxrwx	2026-04-21 08:40:37	Edit Download recursive recursive
Header DIR	-	drwxrwxrwx	2026-04-21 13:59:39	Edit Download recursive recursive
HtmlToTextConverter DIR	-	drwxrwxrwx	2026-04-21 18:26:09	Edit Download recursive recursive
Part DIR	-	drwxrwxrwx	2026-04-19 16:48:34	Edit Download recursive recursive
Resources DIR	-	drwxrwxrwx	2025-09-17 06:53:20	Edit Download recursive recursive
Test DIR	-	drwxrwxrwx	2025-09-17 06:53:20	Edit Download recursive recursive
Address.php	4.44 KB	lrw-rw-rw-	2025-09-17 06:53:20	Edit Download recursive recursive
BodyRendererInterface.php	418 B	lrw-rw-rw-	2025-09-17 06:53:20	Edit Download recursive recursive
CHANGELOG.md	1.12 KB	lrw-rw-rw-	2025-09-17 06:53:20	Edit Download recursive recursive
CharacterStream.php	9.13 KB	lrw-rw-rw-	2025-09-17 06:53:20	Edit Download recursive recursive
composer.json	1.42 KB	lrw-rw-rw-	2025-09-17 06:53:20	Edit Download recursive recursive
DraftEmail.php	1.10 KB	lrw-rw-rw-	2025-09-17 06:53:20	Edit Download recursive recursive
Email.php	14.98 KB	lrw-rw-rw-	2025-09-17 06:53:20	Edit Download recursive recursive
error_log	13.23 KB	lrw-r--r--	2026-04-27 12:53:10	Edit Download recursive recursive
FileBinaryMimeTypeGuesser.php	2.37 KB	lrw-rw-rw-	2025-09-17 06:53:20	Edit Download recursive recursive
FileinfoMimeTypeGuesser.php	1.98 KB	lrw-rw-rw-	2025-09-17 06:53:20	Edit Download recursive recursive
LICENSE	1.04 KB	lrw-rw-rw-	2025-09-17 06:53:20	Edit Download recursive recursive
Message.php	4.33 KB	lrw-rw-rw-	2025-09-17 06:53:20	Edit Download recursive recursive
MessageConverter.php	5.04 KB	lrw-rw-rw-	2025-09-17 06:53:20	Edit Download recursive recursive
MimeTypeGuesserInterface.php	826 B	lrw-rw-rw-	2025-09-17 06:53:20	Edit Download recursive recursive
MimeTypes.php	191.01 KB	lrw-rw-rw-	2025-09-17 06:53:20	Edit Download recursive recursive
MimeTypesInterface.php	777 B	lrw-rw-rw-	2025-09-17 06:53:20	Edit Download recursive recursive
RawMessage.php	2.38 KB	lrw-rw-rw-	2025-09-17 06:53:20	Edit Download recursive recursive
README.md	459 B	lrw-rw-rw-	2025-09-17 06:53:20	Edit Download recursive recursive