TransportServiceFactoryTrait.php

<?php

declare (strict_types=1);
namespace Drupal\Core\Mailer;

use Symfony\Component\Mailer\Exception\UnsupportedSchemeException;
use Symfony\Component\Mailer\Transport\Dsn;
use Symfony\Component\Mailer\Transport\TransportInterface;

/**
 * A trait containing helper methods for transport service construction.
 */
trait TransportServiceFactoryTrait {
    
    /**
     * A list of transport factories.
     *
     * @var Iterable<TransportFactoryInterface>
     */
    protected iterable $factories;
    
    /**
     * Constructs a transport instance given a DSN object.
     *
     * @param \Symfony\Component\Mailer\Transport\Dsn $dsn
     *   The mailer DSN object.
     *
     * @throws \Symfony\Component\Mailer\Exception\IncompleteDsnException
     * @throws \Symfony\Component\Mailer\Exception\UnsupportedSchemeException
     */
    protected function fromDsnObject(Dsn $dsn) : TransportInterface {
        foreach ($this->factories as $factory) {
            if ($factory->supports($dsn)) {
                return $factory->create($dsn);
            }
        }
        throw new UnsupportedSchemeException($dsn);
    }

}