Overview

Namespaces

  • Faulancer
    • Controller
    • Exception
    • Form
      • Validator
        • Type
    • Helper
      • Reflection
    • Http
    • Mail
    • ORM
      • User
    • Service
      • Factory
    • ServiceLocator
    • Session
    • View
      • Helper

Classes

  • Mailer
  • Overview
  • Namespace
  • Class
  1:   2:   3:   4:   5:   6:   7:   8:   9:  10:  11:  12:  13:  14:  15:  16:  17:  18:  19:  20:  21:  22:  23:  24:  25:  26:  27:  28:  29:  30:  31:  32:  33:  34:  35:  36:  37:  38:  39:  40:  41:  42:  43:  44:  45:  46:  47:  48:  49:  50:  51:  52:  53:  54:  55:  56:  57:  58:  59:  60:  61:  62:  63:  64:  65:  66:  67:  68:  69:  70:  71:  72:  73:  74:  75:  76:  77:  78:  79:  80:  81:  82:  83:  84:  85:  86:  87:  88:  89:  90:  91:  92:  93:  94:  95:  96:  97:  98:  99: 100: 101: 102: 103: 104: 105: 106: 107: 108: 109: 110: 111: 112: 113: 114: 115: 116: 117: 118: 119: 120: 121: 122: 123: 124: 125: 126: 127: 128: 129: 130: 131: 132: 133: 134: 135: 136: 137: 138: 139: 140: 141: 142: 143: 144: 145: 146: 147: 148: 149: 150: 151: 152: 153: 154: 155: 156: 157: 158: 159: 160: 161: 162: 163: 164: 165: 166: 167: 168: 169: 170: 171: 172: 173: 174: 175: 176: 177: 178: 179: 180: 181: 182: 183: 184: 185: 186: 187: 188: 189: 190: 191: 192: 193: 194: 195: 196: 197: 198: 199: 200: 201: 202: 203: 204: 205: 206: 207: 208: 209: 210: 211: 212: 213: 214: 215: 216: 217: 218: 219: 220: 221: 222: 223: 224: 225: 226: 227: 228: 229: 230: 231: 232: 233: 234: 235: 236: 237: 238: 239: 240: 241: 242: 243: 244: 245: 246: 247: 248: 249: 250: 251: 252: 253: 254: 255: 256: 257: 258: 259: 
<?php
/**
 * Class Mailer | Mailer.php
 * @package Faulancer\Mail
 * @author  Florian Knapp <office@florianknapp.de>
 */
namespace Faulancer\Mail;

/**
 * Class Mailer
 *
 * +--Example usage:
 * |
 * | $mail = new Mailer();
 * | $mail->addTo('test@test.com');
 * | $mail->addCc('cc@test.com');
 * | $mail->addBcc('bcc@test.com');
 * | $mail->setFrom('Test User <testuser@test.com>');
 * | $mail->setSubject('Testsubject');
 * | $mail->addAttachment('shownFileName.png', '/absolute/path/to/file.png');
 * | $mail->addAttachment('logo.png', '/absolute/path/to/logo.png', true); // We want to show it inline
 * | $mail->setContent('<img src="cid:logo.png"><br /><h3>Welcome to our newsletter</h3>... ... ...');
 * | $mail->send(); // Html is on per default; give this method 'false' to send in plain text
 * |
 */
class Mailer
{

    /**
     * @var array
     */
    protected $recipients = [];

    /**
     * @var array
     */
    protected $carbonCopies = [];

    /**
     * @var array
     */
    protected $blindCarbonCopies = [];

    /**
     * @var string
     */
    protected $from = '';

    /**
     * @var string
     */
    protected $replyTo = '';

    /**
     * @var string
     */
    protected $subject = '';

    /**
     * @var string
     */
    protected $content = '';

    /**
     * @var bool
     */
    protected $isHtml = false;

    /**
     * @var array
     */
    protected $attachment = [];

    /**
     * @var string
     */
    protected $boundary = '';

    /**
     * @param string $name
     */
    public function addTo(string $name)
    {
        $this->recipients[] = $name;
    }

    /**
     * @param string $name
     */
    public function addCc(string $name)
    {
        $this->carbonCopies[] = $name;
    }

    /**
     * @param string $name
     */
    public function addBcc(string $name)
    {
        $this->blindCarbonCopies[] = $name;
    }

    /**
     * @param string $name
     */
    public function setFrom(string $name)
    {
        $this->from = $name;
    }

    public function setReplyTo(string $name)
    {
        $this->replyTo = $name;
    }

    /**
     * @param string $subject
     */
    public function setSubject(string $subject)
    {
        $this->subject = $subject;
    }

    public function setContent(string $content)
    {
        $this->content = $content;
    }

    /**
     * @param string $name
     * @param string $path
     * @param bool   $inline
     */
    public function addAttachment(string $name = '', string $path, bool $inline = false)
    {
        $this->attachment[] = [
            'name'     => $name,
            'path'     => $path,
            'encoded'  => chunk_split(base64_encode(file_get_contents($path))),
            'mimetype' => mime_content_type($path),
            'inline'   => $inline
        ];
    }

    /**
     * @param bool $html
     * @return bool
     */
    public function send($html = true)
    {
        $this->isHtml = $html;
        return $this->sendMail($this->getHeaders(), $this->getMessage());
    }

    /**
     * @param string $headers
     * @param string $message
     * @return bool
     * @codeCoverageIgnore
     */
    protected function sendMail($headers, $message)
    {
        if (mail(implode(',', $this->recipients), $this->subject,$headers, $message)) {
            return true;
        }
        return false;
    }

    /**
     * @return string
     */
    protected function getBoundary()
    {
        if (empty($this->boundary)) {
            $this->boundary = md5('faulancer');
        }
        return $this->boundary;
    }

    /**
     * @return string
     */
    protected function getHeaders()
    {
        $boundary = $this->getBoundary();
        $headers  = 'MIME-Version: 1.0' . PHP_EOL;

        if (!empty($this->from)) {
            $headers .= 'From: ' .$this->from . PHP_EOL;
        }

        if (!empty($this->replyTo)) {
            $headers .= 'Reply-To: ' . $this->replyTo . PHP_EOL;
        } else if (!empty($this->from)) {
            $headers .= 'Reply-To: ' . $this->from . PHP_EOL;
        }

        if (!empty($this->carbonCopies)) {
            $headers .= 'CC: ' . implode(',', $this->carbonCopies) . PHP_EOL;
        }

        if (!empty($this->blindCarbonCopies)) {
            $headers .= 'BCC: ' . implode(',', $this->blindCarbonCopies) . PHP_EOL;
        }

        $headers .= 'Content-Type: multipart/mixed; boundary = ' . $boundary . PHP_EOL;

        return $headers;
    }

    /**
     * @return string
     */
    protected function getMessage()
    {
        $boundary = $this->getBoundary();
        $body = '--' . $boundary . PHP_EOL;

        if ($this->isHtml) {
            $body .= 'Content-Type: text/html; charset=utf-8' . PHP_EOL;
        } else {
            $body .= 'Content-Type: text/plain; charset=utf-8' . PHP_EOL;
        }

        $body .= 'Content-Transfer-Encoding: base64' . PHP_EOL . PHP_EOL;
        $body .= chunk_split(base64_encode($this->content));

        if (!empty($this->attachment)) {

            foreach ($this->attachment as $attachment) {

                $encodedContent = $attachment['encoded'];
                $fileType       = $attachment['mimetype'];
                $fileName       = $attachment['name'];

                $body .= '--' . $boundary . PHP_EOL;
                $body .= 'Content-Type: ' . $fileType . '; name=' . $fileName . PHP_EOL;

                if ($attachment['inline']) {
                    $body .= 'Content-ID: <' . $fileName . '>' . PHP_EOL;
                    $body .= 'Content-Disposition: inline; filename=' . $fileName . PHP_EOL;
                } else {
                    $body .= 'Content-Disposition: attachment; filename=' . $fileName . PHP_EOL;
                }

                $body .= 'Content-Transfer-Encoding: base64' . PHP_EOL;
                $body .= 'X-Attachment-Id: ' . rand(1000,99999) . PHP_EOL . PHP_EOL;
                $body .= $encodedContent;

            }

        }

        $body .= '--' . $boundary . '--' . PHP_EOL;

        return $body;
    }

}
API documentation generated by ApiGen