pictcode

<?php

/**

 * Email Component

 *

 * CakePHP(tm) : Rapid Development Framework (http://cakephp.org)

 * Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)

 *

 * Licensed under The MIT License

 * For full copyright and license information, please see the LICENSE.txt

 * Redistributions of files must retain the above copyright notice.

 *

 * @copyright     Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)

 * @link          http://cakephp.org CakePHP(tm) Project

 * @package       Cake.Controller.Component

 * @since         CakePHP(tm) v 1.2.0.3467

 * @license       http://www.opensource.org/licenses/mit-license.php MIT License

 */

App::uses('Component', 'Controller');

App::uses('Multibyte', 'I18n');

App::uses('CakeEmail', 'Network/Email');

/**

 * EmailComponent

 *

 * This component is used for handling Internet Message Format based

 * based on the standard outlined in http://www.rfc-editor.org/rfc/rfc2822.txt

 *

 * @package       Cake.Controller.Component

 * @link          http://book.cakephp.org/2.0/en/core-libraries/components/email.html

 * @link          http://book.cakephp.org/2.0/en/core-utility-libraries/email.html

 * @deprecated    3.0.0 Will be removed in 3.0. Use Network/CakeEmail instead

 */

class EmailComponent extends Component {

/**

 * Recipient of the email

 *

 * @var string

 */

        public $to = null;

/**

 * The mail which the email is sent from

 *

 * @var string

 */

        public $from = null;

/**

 * The email the recipient will reply to

 *

 * @var string

 */

        public $replyTo = null;

/**

 * The read receipt email

 *

 * @var string

 */

        public $readReceipt = null;

/**

 * The mail that will be used in case of any errors like

 * - Remote mailserver down

 * - Remote user has exceeded his quota

 * - Unknown user

 *

 * @var string

 */

        public $return = null;

/**

 * Carbon Copy

 *

 * List of email's that should receive a copy of the email.

 * The Recipient WILL be able to see this list

 *

 * @var array

 */

        public $cc = array();

/**

 * Blind Carbon Copy

 *

 * List of email's that should receive a copy of the email.

 * The Recipient WILL NOT be able to see this list

 *

 * @var array

 */

        public $bcc = array();

/**

 * The date to put in the Date: header. This should be a date

 * conforming with the RFC2822 standard. Leave null, to have

 * today's date generated.

 *

 * @var string

 */

        public $date = null;

/**

 * The subject of the email

 *

 * @var string

 */

        public $subject = null;

/**

 * Associative array of a user defined headers

 * Keys will be prefixed 'X-' as per RFC2822 Section 4.7.5

 *

 * @var array

 */

        public $headers = array();

/**

 * List of additional headers

 *

 * These will NOT be used if you are using safemode and mail()

 *

 * @var string

 */

        public $additionalParams = null;

/**

 * Layout for the View

 *

 * @var string

 */

        public $layout = 'default';

/**

 * Template for the view

 *

 * @var string

 */

        public $template = null;

/**

 * Line feed character(s) to be used when sending using mail() function

 * By default PHP_EOL is used.

 * RFC2822 requires it to be CRLF but some Unix

 * mail transfer agents replace LF by CRLF automatically

 * (which leads to doubling CR if CRLF is used).

 *

 * @var string

 */

        public $lineFeed = PHP_EOL;

/**

 * What format should the email be sent in

 *

 * Supported formats:

 * - text

 * - html

 * - both

 *

 * @var string

 */

        public $sendAs = 'text';

/**

 * What method should the email be sent by

 *

 * Supported methods:

 * - mail

 * - smtp

 * - debug

 *

 * @var string

 */

        public $delivery = 'mail';

/**

 * charset the email is sent in

 *

 * @var string

 */

        public $charset = 'utf-8';

/**

 * List of files that should be attached to the email.

 *

 * Can be both absolute and relative paths

 *

 * @var array

 */

        public $attachments = array();

/**

 * What mailer should EmailComponent identify itself as

 *

 * @var string

 */

        public $xMailer = 'CakePHP Email Component';

/**

 * The list of paths to search if an attachment isn't absolute

 *

 * @var array

 */

        public $filePaths = array();

/**

 * List of options to use for smtp mail method

 *

 * Options is:

 * - port

 * - host

 * - timeout

 * - username

 * - password

 * - client

 *

 * @var array

 */

        public $smtpOptions = array();

/**

 * Contains the rendered plain text message if one was sent.

 *

 * @var string

 */

        public $textMessage = null;

/**

 * Contains the rendered HTML message if one was sent.

 *

 * @var string

 */

        public $htmlMessage = null;

/**

 * Whether to generate a Message-ID header for the

 * e-mail. True to generate a Message-ID, False to let

 * it be handled by sendmail (or similar) or a string

 * to completely override the Message-ID.

 *

 * If you are sending Email from a shell, be sure to set this value. As you

 * could encounter delivery issues if you do not.

 *

 * @var mixed

 */

        public $messageId = true;

/**

 * Controller reference

 *

 * @var Controller

 */

        protected $_controller = null;

/**

 * Constructor

 *

 * @param ComponentCollection $collection A ComponentCollection this component can use to lazy load its components

 * @param array $settings Array of configuration settings.

 */

        public function __construct(ComponentCollection $collection, $settings = array()) {

                $this->_controller = $collection->getController();

                parent::__construct($collection, $settings);

        }

/**

 * Initialize component

 *

 * @param Controller $controller Instantiating controller

 * @return void

 */

        public function initialize(Controller $controller) {

                if (Configure::read('App.encoding') !== null) {

                        $this->charset = Configure::read('App.encoding');

                }

        }

/**

 * Send an email using the specified content, template and layout

 *

 * @param string|array $content Either an array of text lines, or a string with contents

 *  If you are rendering a template this variable will be sent to the templates as `$content`

 * @param string $template Template to use when sending email

 * @param string $layout Layout to use to enclose email body

 * @return bool Success

 */

        public function send($content = null, $template = null, $layout = null) {

                $lib = new CakeEmail();

                $lib->charset = $this->charset;

                $lib->headerCharset = $this->charset;

                $lib->from($this->_formatAddresses((array)$this->from));

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

                        $lib->to($this->_formatAddresses((array)$this->to));

                }

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

                        $lib->cc($this->_formatAddresses((array)$this->cc));

                }

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

                        $lib->bcc($this->_formatAddresses((array)$this->bcc));

                }

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

                        $lib->replyTo($this->_formatAddresses((array)$this->replyTo));

                }

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

                        $lib->returnPath($this->_formatAddresses((array)$this->return));

                }

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

                        $lib->readReceipt($this->_formatAddresses((array)$this->readReceipt));

                }

                $lib->subject($this->subject);

                $lib->messageID($this->messageId);

                $lib->helpers($this->_controller->helpers);

                $headers = array('X-Mailer' => $this->xMailer);

                foreach ($this->headers as $key => $value) {

                        $headers['X-' . $key] = $value;

                }

                if ($this->date) {

                        $headers['Date'] = $this->date;

                }

                $lib->setHeaders($headers);

                if ($template) {

                        $this->template = $template;

                }

                if ($layout) {

                        $this->layout = $layout;

                }

                $lib->template($this->template, $this->layout)->viewVars($this->_controller->viewVars)->emailFormat($this->sendAs);

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

                        $lib->attachments($this->_formatAttachFiles());

                }

                $lib->transport(ucfirst($this->delivery));

                if ($this->delivery === 'mail') {

                        $lib->config(array('eol' => $this->lineFeed, 'additionalParameters' => $this->additionalParams));

                } elseif ($this->delivery === 'smtp') {

                        $lib->config($this->smtpOptions);

                } else {

                        $lib->config(array());

                }

                $sent = $lib->send($content);

                $this->htmlMessage = $lib->message(CakeEmail::MESSAGE_HTML);

                if (empty($this->htmlMessage)) {

                        $this->htmlMessage = null;

                }

                $this->textMessage = $lib->message(CakeEmail::MESSAGE_TEXT);

                if (empty($this->textMessage)) {

                        $this->textMessage = null;

                }

                $this->_header = array();

                $this->_message = array();

                return $sent;

        }

/**

 * Reset all EmailComponent internal variables to be able to send out a new email.

 *

 * @return void

 */

        public function reset() {

                $this->template = null;

                $this->to = array();

                $this->from = null;

                $this->replyTo = null;

                $this->return = null;

                $this->cc = array();

                $this->bcc = array();

                $this->subject = null;

                $this->additionalParams = null;

                $this->date = null;

                $this->attachments = array();

                $this->htmlMessage = null;

                $this->textMessage = null;

                $this->messageId = true;

                $this->delivery = 'mail';

        }

/**

 * Format the attach array

 *

 * @return array

 */

        protected function _formatAttachFiles() {

                $files = array();

                foreach ($this->attachments as $filename => $attachment) {

                        $file = $this->_findFiles($attachment);

                        if (!empty($file)) {

                                if (is_int($filename)) {

                                        $filename = basename($file);

                                }

                                $files[$filename] = $file;

                        }

                }

                return $files;

        }

/**

 * Find the specified attachment in the list of file paths

 *

 * @param string $attachment Attachment file name to find

 * @return string|null Path to located file

 */

        protected function _findFiles($attachment) {

                if (file_exists($attachment)) {

                        return $attachment;

                }

                foreach ($this->filePaths as $path) {

                        if (file_exists($path . DS . $attachment)) {

                                $file = $path . DS . $attachment;

                                return $file;

                        }

                }

                return null;

        }

/**

 * Format addresses to be an array with email as key and alias as value

 *

 * @param array $addresses Address to format.

 * @return array

 */

        protected function _formatAddresses($addresses) {

                $formatted = array();

                foreach ($addresses as $address) {

                        if (preg_match('/((.*))?\s?<(.+)>/', $address, $matches) && !empty($matches[2])) {

                                $formatted[$this->_strip($matches[3])] = $matches[2];

                        } else {

                                $address = $this->_strip($address);

                                $formatted[$address] = $address;

                        }

                }

                return $formatted;

        }

/**

 * Remove certain elements (such as bcc:, to:, %0a) from given value.

 * Helps prevent header injection / manipulation on user content.

 *

 * @param string $value Value to strip

 * @param bool $message Set to true to indicate main message content

 * @return string Stripped value

 */

        protected function _strip($value, $message = false) {

                $search = '%0a|%0d|Content-(?:Type|Transfer-Encoding)\:';

                $search .= '|charset\=|mime-version\:|multipart/mixed|(?:[^a-z]to|b?cc)\:.*';

                if ($message !== true) {

                        $search .= '|\r|\n';

                }

                $search = '#(?:' . $search . ')#i';

                while (preg_match($search, $value)) {

                        $value = preg_replace($search, '', $value);

                }

                return $value;

        }

}