ilMailMimeTransportBase Class Reference

Class ilMailMimeTransportBase. More...

Inheritance diagram for ilMailMimeTransportBase:

Collaboration diagram for ilMailMimeTransportBase:

Public Member Functions
	__construct (\ilSetting $settings, \ilAppEventHandler $eventHandler)
	ilMailMimeTransportBase constructor. More...
	send (\ilMimeMail $mail)
	Parameters ilMimeMail $mail Returns bool More...

Protected Member Functions
	getMailer ()
	setMailer ($mailer)
	resetMailer ()
	onBeforeSend ()

Protected Attributes
	$mailer
	$settings

Private Attributes
	$eventHandler

Detailed Description

Class ilMailMimeTransportBase.

Definition at line 9 of file class.ilMailMimeTransportBase.php.

Constructor & Destructor Documentation

__construct()

ilMailMimeTransportBase::__construct	(	\ilSetting	$settings,
		\ilAppEventHandler	$eventHandler
	)

ilMailMimeTransportBase constructor.

Parameters

\ilSetting	$settings
ilAppEventHandler	$eventHandler

Definition at line 25 of file class.ilMailMimeTransportBase.php.

References $eventHandler, $settings, setMailer(), and settings().

    {
        $this->settings = $settings;
        $this->eventHandler = $eventHandler;

        $mail = new PHPMailer();
        $this->setMailer($mail);
    }

Here is the call graph for this function:

Member Function Documentation

getMailer()

ilMailMimeTransportBase::getMailer ( )

protected

Returns

PHPMailer

Definition at line 37 of file class.ilMailMimeTransportBase.php.

References $mailer.

Referenced by resetMailer(), and send().

    {
        return $this->mailer;
    }

Here is the caller graph for this function:

onBeforeSend()

ilMailMimeTransportBase::onBeforeSend ( )

protected

Definition at line 61 of file class.ilMailMimeTransportBase.php.

Referenced by send().

    {
    }

Here is the caller graph for this function:

resetMailer()

ilMailMimeTransportBase::resetMailer ( )

protected

Definition at line 50 of file class.ilMailMimeTransportBase.php.

References getMailer().

Referenced by send().

    {
        $this->getMailer()->clearAllRecipients();
        $this->getMailer()->clearAttachments();
        $this->getMailer()->clearReplyTos();
        $this->getMailer()->ErrorInfo = '';
    }

Here is the call graph for this function:

Here is the caller graph for this function:

send()

ilMailMimeTransportBase::send ( \ilMimeMail  $mail )

final

Parameters

ilMimeMail

$mail

Returns

bool

Implements ilMailMimeTransport.

Definition at line 68 of file class.ilMailMimeTransportBase.php.

References $GLOBALS, $message, $result, ilMimeMail\getAttachments(), ilMimeMail\getBcc(), ilMimeMail\getCc(), ilMimeMail\getFinalBody(), ilMimeMail\getFinalBodyAlt(), ilMimeMail\getFrom(), ilMimeMail\getImages(), ilLoggerFactory\getLogger(), getMailer(), ilMimeMail\getSubject(), ilMimeMail\getTo(), onBeforeSend(), resetMailer(), and user().

                                                  : bool
    {
        $this->resetMailer();

        $this->getMailer()->XMailer = ' ';

        foreach ($mail->getTo() as $recipients) {
            $recipient_pieces = array_filter(array_map('trim', explode(',', $recipients)));
            foreach ($recipient_pieces as $recipient) {
                $this->getMailer()->AddAddress($recipient, '');
            }
        }

        foreach ($mail->getCc() as $carbon_copies) {
            $cc_pieces = array_filter(array_map('trim', explode(',', $carbon_copies)));
            foreach ($cc_pieces as $carbon_copy) {
                $this->getMailer()->AddCC($carbon_copy, '');
            }
        }

        foreach ($mail->getBcc() as $blind_carbon_copies) {
            $bcc_pieces = array_filter(array_map('trim', explode(',', $blind_carbon_copies)));
            foreach ($bcc_pieces as $blind_carbon_copy) {
                $this->getMailer()->AddBCC($blind_carbon_copy, '');
            }
        }

        $this->getMailer()->Subject = $mail->getSubject();

        if ($mail->getFrom()->hasReplyToAddress()) {
            $this->getMailer()->addReplyTo($mail->getFrom()->getReplyToAddress(), $mail->getFrom()->getReplyToName());
        }
        if ($mail->getFrom()->hasEnvelopFromAddress()) {
            $this->getMailer()->Sender = $mail->getFrom()->getEnvelopFromAddress();
        }
        $this->getMailer()->setFrom($mail->getFrom()->getFromAddress(), $mail->getFrom()->getFromName(), false);

        foreach ($mail->getAttachments() as $attachment) {
            $this->getMailer()->AddAttachment($attachment['path'], $attachment['name']);
        }

        foreach ($mail->getImages() as $image) {
            $this->getMailer()->AddEmbeddedImage($image['path'], $image['cid'], $image['name']);
        }

        if ($mail->getFinalBodyAlt()) {
            $this->getMailer()->IsHTML(true);
            $this->getMailer()->AltBody = $mail->getFinalBodyAlt();
            $this->getMailer()->Body = $mail->getFinalBody();
        } else {
            $this->getMailer()->IsHTML(false);
            $this->getMailer()->AltBody = '';
            $this->getMailer()->Body = $mail->getFinalBody();
        }

        ilLoggerFactory::getLogger('mail')->info(sprintf(
            "Trying to delegate external email delivery:" .
            " Initiated by: %s (%s) " .
            "| To: %s | CC: %s | BCC: %s | Subject: %s " .
            "| From: %s / %s " .
            "| ReplyTo: %s / %s " .
            "| EnvelopeFrom: %s",
            $GLOBALS['DIC']->user()->getLogin(),
            $GLOBALS['DIC']->user()->getId(),
            implode(', ', $mail->getTo()),
            implode(', ', $mail->getCc()),
            implode(', ', $mail->getBcc()),
            $mail->getSubject(),
            $mail->getFrom()->getFromAddress(),
            $mail->getFrom()->getFromName(),
            $mail->getFrom()->getReplyToAddress(),
            $mail->getFrom()->getReplyToName(),
            $mail->getFrom()->getEnvelopFromAddress()
        ));

        ilLoggerFactory::getLogger('mail')->debug(sprintf("Mail Alternative Body: %s", $this->getMailer()->AltBody));
        ilLoggerFactory::getLogger('mail')->debug(sprintf("Mail Body: %s", $this->getMailer()->Body));

        $this->getMailer()->CharSet = 'utf-8';

        $this->mailer->SMTPDebug = 4;
        $this->mailer->Debugoutput = function ($message, $level) {
            if (
                strpos($message, 'Invalid address') !== false ||
                strpos($message, 'Message body empty') !== false
            ) {
                ilLoggerFactory::getLogger('mail')->warning($message);
            } else {
                ilLoggerFactory::getLogger('mail')->debug($message);
            }
        };

        $this->onBeforeSend();
        $result = $this->getMailer()->Send();
        if ($result) {
            ilLoggerFactory::getLogger('mail')->info(sprintf(
                'Successfully delegated external mail delivery'
            ));

            if (strlen($this->getMailer()->ErrorInfo) > 0) {
                ilLoggerFactory::getLogger('mail')->warning(sprintf(
                    '... with most recent errors: %s',
                    $this->getMailer()->ErrorInfo
                ));
            }
        } else {
            ilLoggerFactory::getLogger('mail')->warning(sprintf(
                'Could not deliver external email: %s',
                $this->getMailer()->ErrorInfo
            ));
        }

        $this->eventHandler->raise('Services/Mail', 'externalEmailDelegated', [
            'mail' => $mail,
            'result' => (bool) $result
        ]);

        return (bool) $result;
    }

Here is the call graph for this function:

setMailer()

ilMailMimeTransportBase::setMailer (   $mailer )

protected

Parameters

PHPMailer

$mailer

Definition at line 45 of file class.ilMailMimeTransportBase.php.

References $mailer.

Referenced by __construct().

    {
        $this->mailer = $mailer;
    }

Here is the caller graph for this function:

Field Documentation

$eventHandler

ilMailMimeTransportBase::$eventHandler

private

Definition at line 18 of file class.ilMailMimeTransportBase.php.

Referenced by __construct().

$mailer

ilMailMimeTransportBase::$mailer

protected

Definition at line 12 of file class.ilMailMimeTransportBase.php.

Referenced by getMailer(), and setMailer().

$settings

ilMailMimeTransportBase::$settings

protected

Definition at line 15 of file class.ilMailMimeTransportBase.php.

Referenced by __construct().

---

The documentation for this class was generated from the following file:

• Services/Mail/classes/Mime/Transport/class.ilMailMimeTransportBase.php