Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x
  2. MessageConverter.php

class MessageConverter

@author Fabien Potencier <fabien@symfony.com>

Hierarchy

  • class \Symfony\Component\Mime\MessageConverter

Expanded class hierarchy of MessageConverter

1 file declares its use of MessageConverter
AbstractApiTransport.php in vendor/symfony/mailer/Transport/AbstractApiTransport.php

File

vendor/symfony/mime/MessageConverter.php, line 24

Namespace

Symfony\Component\Mime
View source
final class MessageConverter {
    
    /**
     * @throws RuntimeException when unable to convert the message to an email
     */
    public static function toEmail(Message $message) : Email {
        if ($message instanceof Email) {
            return $message;
        }
        // try to convert to a "simple" Email instance
        $body = $message->getBody();
        if ($body instanceof TextPart) {
            return self::createEmailFromTextPart($message, $body);
        }
        if ($body instanceof AlternativePart) {
            return self::createEmailFromAlternativePart($message, $body);
        }
        if ($body instanceof RelatedPart) {
            return self::createEmailFromRelatedPart($message, $body);
        }
        if ($body instanceof MixedPart) {
            $parts = $body->getParts();
            if ($parts[0] instanceof RelatedPart) {
                $email = self::createEmailFromRelatedPart($message, $parts[0]);
            }
            elseif ($parts[0] instanceof AlternativePart) {
                $email = self::createEmailFromAlternativePart($message, $parts[0]);
            }
            elseif ($parts[0] instanceof TextPart) {
                $email = self::createEmailFromTextPart($message, $parts[0]);
            }
            else {
                throw new RuntimeException(\sprintf('Unable to create an Email from an instance of "%s" as the body is too complex.', get_debug_type($message)));
            }
            return self::addParts($email, \array_slice($parts, 1));
        }
        throw new RuntimeException(\sprintf('Unable to create an Email from an instance of "%s" as the body is too complex.', get_debug_type($message)));
    }
    private static function createEmailFromTextPart(Message $message, TextPart $part) : Email {
        if ('text' === $part->getMediaType() && 'plain' === $part->getMediaSubtype()) {
            return (new Email(clone $message->getHeaders()))
                ->text($part->getBody(), $part->getPreparedHeaders()
                ->getHeaderParameter('Content-Type', 'charset') ?: 'utf-8');
        }
        if ('text' === $part->getMediaType() && 'html' === $part->getMediaSubtype()) {
            return (new Email(clone $message->getHeaders()))
                ->html($part->getBody(), $part->getPreparedHeaders()
                ->getHeaderParameter('Content-Type', 'charset') ?: 'utf-8');
        }
        throw new RuntimeException(\sprintf('Unable to create an Email from an instance of "%s" as the body is too complex.', get_debug_type($message)));
    }
    private static function createEmailFromAlternativePart(Message $message, AlternativePart $part) : Email {
        $parts = $part->getParts();
        if (2 === \count($parts) && $parts[0] instanceof TextPart && 'text' === $parts[0]->getMediaType() && 'plain' === $parts[0]->getMediaSubtype() && $parts[1] instanceof TextPart && 'text' === $parts[1]->getMediaType() && 'html' === $parts[1]->getMediaSubtype()) {
            return (new Email(clone $message->getHeaders()))
                ->text($parts[0]->getBody(), $parts[0]->getPreparedHeaders()
                ->getHeaderParameter('Content-Type', 'charset') ?: 'utf-8')
                ->html($parts[1]->getBody(), $parts[1]->getPreparedHeaders()
                ->getHeaderParameter('Content-Type', 'charset') ?: 'utf-8');
        }
        throw new RuntimeException(\sprintf('Unable to create an Email from an instance of "%s" as the body is too complex.', get_debug_type($message)));
    }
    private static function createEmailFromRelatedPart(Message $message, RelatedPart $part) : Email {
        $parts = $part->getParts();
        if ($parts[0] instanceof AlternativePart) {
            $email = self::createEmailFromAlternativePart($message, $parts[0]);
        }
        elseif ($parts[0] instanceof TextPart) {
            $email = self::createEmailFromTextPart($message, $parts[0]);
        }
        else {
            throw new RuntimeException(\sprintf('Unable to create an Email from an instance of "%s" as the body is too complex.', get_debug_type($message)));
        }
        return self::addParts($email, \array_slice($parts, 1));
    }
    private static function addParts(Email $email, array $parts) : Email {
        foreach ($parts as $part) {
            if (!$part instanceof DataPart) {
                throw new RuntimeException(\sprintf('Unable to create an Email from an instance of "%s" as the body is too complex.', get_debug_type($email)));
            }
            $email->addPart($part);
        }
        return $email;
    }

}

Members

Title Sort descending Modifiers Object type Summary
MessageConverter::addParts private static function
MessageConverter::createEmailFromAlternativePart private static function
MessageConverter::createEmailFromRelatedPart private static function
MessageConverter::createEmailFromTextPart private static function
MessageConverter::toEmail public static function

API Navigation

  • Drupal Core 11.1.x
  • Topics
  • Classes
  • Functions
  • Constants
  • Globals
  • Files
  • Namespaces
  • Deprecated
  • Services
RSS feed
Powered by Drupal