Backup of current cakephp version

lib/Cake/Network/Email/AbstractTransport.php

@@ -0,0 +1,76 @@
+<?php
+/**
+ * Abstract send email
+ *
+ * PHP 5
+ *
+ * CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
+ * Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
+ *
+ * Licensed under The MIT License
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @copyright     Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
+ * @link          http://cakephp.org CakePHP(tm) Project
+ * @package       Cake.Network.Email
+ * @since         CakePHP(tm) v 2.0.0
+ * @license       MIT License (http://www.opensource.org/licenses/mit-license.php)
+ */
+
+/**
+ * Abstract transport for sending email
+ *
+ * @package       Cake.Network.Email
+ */
+abstract class AbstractTransport {
+
+/**
+ * Configurations
+ *
+ * @var array
+ */
+	protected $_config = array();
+
+/**
+ * Send mail
+ *
+ * @params CakeEmail $email
+ * @return array
+ */
+	abstract public function send(CakeEmail $email);
+
+/**
+ * Set the config
+ *
+ * @param array $config
+ * @return array Returns configs
+ */
+	public function config($config = null) {
+		if (is_array($config)) {
+			$this->_config = $config;
+		}
+		return $this->_config;
+	}
+
+/**
+ * Help to convert headers in string
+ *
+ * @param array $headers Headers in format key => value
+ * @param string $eol
+ * @return string
+ */
+	protected function _headersToString($headers, $eol = "\r\n") {
+		$out = '';
+		foreach ($headers as $key => $value) {
+			if ($value === false || $value === null || $value === '') {
+				continue;
+			}
+			$out .= $key . ': ' . $value . $eol;
+		}
+		if (!empty($out)) {
+			$out = substr($out, 0, -1 * strlen($eol));
+		}
+		return $out;
+	}
+
+}

lib/Cake/Network/Email/DebugTransport.php

@@ -0,0 +1,41 @@
+<?php
+/**
+ * Emulates the email sending process for testing purposes
+ *
+ * PHP 5
+ *
+ * CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
+ * Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
+ *
+ * Licensed under The MIT License
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @copyright     Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
+ * @link          http://cakephp.org CakePHP(tm) Project
+ * @package       Cake.Network.Email
+ * @since         CakePHP(tm) v 2.0.0
+ * @license       MIT License (http://www.opensource.org/licenses/mit-license.php)
+ */
+
+/**
+ * Debug Transport class, useful for emulate the email sending process and inspect the resulted
+ * email message before actually send it during development
+ *
+ * @package       Cake.Network.Email
+ */
+class DebugTransport extends AbstractTransport {
+
+/**
+ * Send mail
+ *
+ * @param CakeEmail $email CakeEmail
+ * @return array
+ */
+	public function send(CakeEmail $email) {
+		$headers = $email->getHeaders(array('from', 'sender', 'replyTo', 'readReceipt', 'returnPath', 'to', 'cc', 'subject'));
+		$headers = $this->_headersToString($headers);
+		$message = implode("\r\n", (array)$email->message());
+		return array('headers' => $headers, 'message' => $message);
+	}
+
+}

lib/Cake/Network/Email/MailTransport.php

@@ -0,0 +1,73 @@
+<?php
+/**
+ * Send mail using mail() function
+ *
+ * PHP 5
+ *
+ * CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
+ * Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
+ *
+ * Licensed under The MIT License
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @copyright     Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
+ * @link          http://cakephp.org CakePHP(tm) Project
+ * @package       Cake.Network.Email
+ * @since         CakePHP(tm) v 2.0.0
+ * @license       MIT License (http://www.opensource.org/licenses/mit-license.php)
+ */
+
+/**
+ * Send mail using mail() function
+ *
+ * @package       Cake.Network.Email
+ */
+class MailTransport extends AbstractTransport {
+
+/**
+ * Send mail
+ *
+ * @param CakeEmail $email CakeEmail
+ * @return array
+ * @throws SocketException When mail cannot be sent.
+ */
+	public function send(CakeEmail $email) {
+		$eol = PHP_EOL;
+		if (isset($this->_config['eol'])) {
+			$eol = $this->_config['eol'];
+		}
+		$headers = $email->getHeaders(array('from', 'sender', 'replyTo', 'readReceipt', 'returnPath', 'to', 'cc', 'bcc'));
+		$to = $headers['To'];
+		unset($headers['To']);
+		$headers = $this->_headersToString($headers, $eol);
+		$message = implode($eol, $email->message());
+
+		$params = isset($this->_config['additionalParameters']) ? $this->_config['additionalParameters'] : null;
+		$this->_mail($to, $email->subject(), $message, $headers, $params);
+		return array('headers' => $headers, 'message' => $message);
+	}
+
+/**
+ * Wraps internal function mail() and throws exception instead of errors if anything goes wrong
+ *
+ * @param string $to email's recipient
+ * @param string $subject email's subject
+ * @param string $message email's body
+ * @param string $headers email's custom headers
+ * @param string $params additional params for sending email, will be ignored when in safe_mode
+ * @throws SocketException if mail could not be sent
+ * @return void
+ */
+	protected function _mail($to, $subject, $message, $headers, $params = null) {
+		if (ini_get('safe_mode')) {
+			//@codingStandardsIgnoreStart
+			if (!@mail($to, $subject, $message, $headers)) {
+				throw new SocketException(__d('cake_dev', 'Could not send email.'));
+			}
+		} elseif (!@mail($to, $subject, $message, $headers, $params)) {
+			//@codingStandardsIgnoreEnd
+			throw new SocketException(__d('cake_dev', 'Could not send email.'));
+		}
+	}
+
+}

lib/Cake/Network/Email/SmtpTransport.php

@@ -0,0 +1,240 @@
+<?php
+/**
+ * Send mail using SMTP protocol
+ *
+ * PHP 5
+ *
+ * CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
+ * Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
+ *
+ * Licensed under The MIT License
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @copyright     Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
+ * @link          http://cakephp.org CakePHP(tm) Project
+ * @package       Cake.Network.Email
+ * @since         CakePHP(tm) v 2.0.0
+ * @license       MIT License (http://www.opensource.org/licenses/mit-license.php)
+ */
+
+App::uses('CakeSocket', 'Network');
+
+/**
+ * Send mail using SMTP protocol
+ *
+ * @package       Cake.Network.Email
+ */
+class SmtpTransport extends AbstractTransport {
+
+/**
+ * Socket to SMTP server
+ *
+ * @var CakeSocket
+ */
+	protected $_socket;
+
+/**
+ * CakeEmail
+ *
+ * @var CakeEmail
+ */
+	protected $_cakeEmail;
+
+/**
+ * Content of email to return
+ *
+ * @var string
+ */
+	protected $_content;
+
+/**
+ * Send mail
+ *
+ * @param CakeEmail $email CakeEmail
+ * @return array
+ * @throws SocketException
+ */
+	public function send(CakeEmail $email) {
+		$this->_cakeEmail = $email;
+
+		$this->_connect();
+		$this->_auth();
+		$this->_sendRcpt();
+		$this->_sendData();
+		$this->_disconnect();
+
+		return $this->_content;
+	}
+
+/**
+ * Set the configuration
+ *
+ * @param array $config
+ * @return void
+ */
+	public function config($config = array()) {
+		$default = array(
+			'host' => 'localhost',
+			'port' => 25,
+			'timeout' => 30,
+			'username' => null,
+			'password' => null,
+			'client' => null
+		);
+		$this->_config = $config + $default;
+	}
+
+/**
+ * Connect to SMTP Server
+ *
+ * @return void
+ * @throws SocketException
+ */
+	protected function _connect() {
+		$this->_generateSocket();
+		if (!$this->_socket->connect()) {
+			throw new SocketException(__d('cake_dev', 'Unable to connect to SMTP server.'));
+		}
+		$this->_smtpSend(null, '220');
+
+		if (isset($this->_config['client'])) {
+			$host = $this->_config['client'];
+		} elseif ($httpHost = env('HTTP_HOST')) {
+			list($host) = explode(':', $httpHost);
+		} else {
+			$host = 'localhost';
+		}
+
+		try {
+			$this->_smtpSend("EHLO {$host}", '250');
+		} catch (SocketException $e) {
+			try {
+				$this->_smtpSend("HELO {$host}", '250');
+			} catch (SocketException $e2) {
+				throw new SocketException(__d('cake_dev', 'SMTP server did not accept the connection.'));
+			}
+		}
+	}
+
+/**
+ * Send authentication
+ *
+ * @return void
+ * @throws SocketException
+ */
+	protected function _auth() {
+		if (isset($this->_config['username']) && isset($this->_config['password'])) {
+			$authRequired = $this->_smtpSend('AUTH LOGIN', '334|503');
+			if ($authRequired == '334') {
+				if (!$this->_smtpSend(base64_encode($this->_config['username']), '334')) {
+					throw new SocketException(__d('cake_dev', 'SMTP server did not accept the username.'));
+				}
+				if (!$this->_smtpSend(base64_encode($this->_config['password']), '235')) {
+					throw new SocketException(__d('cake_dev', 'SMTP server did not accept the password.'));
+				}
+			} elseif ($authRequired != '503') {
+				throw new SocketException(__d('cake_dev', 'SMTP does not require authentication.'));
+			}
+		}
+	}
+
+/**
+ * Send emails
+ *
+ * @return void
+ * @throws SocketException
+ */
+	protected function _sendRcpt() {
+		$from = $this->_cakeEmail->from();
+		$this->_smtpSend('MAIL FROM:<' . key($from) . '>');
+
+		$to = $this->_cakeEmail->to();
+		$cc = $this->_cakeEmail->cc();
+		$bcc = $this->_cakeEmail->bcc();
+		$emails = array_merge(array_keys($to), array_keys($cc), array_keys($bcc));
+		foreach ($emails as $email) {
+			$this->_smtpSend('RCPT TO:<' . $email . '>');
+		}
+	}
+
+/**
+ * Send Data
+ *
+ * @return void
+ * @throws SocketException
+ */
+	protected function _sendData() {
+		$this->_smtpSend('DATA', '354');
+
+		$headers = $this->_cakeEmail->getHeaders(array('from', 'sender', 'replyTo', 'readReceipt', 'returnPath', 'to', 'cc', 'subject'));
+		$headers = $this->_headersToString($headers);
+		$lines = $this->_cakeEmail->message();
+		$messages = array();
+		foreach ($lines as $line) {
+			if ((!empty($line)) && ($line[0] === '.')) {
+				$messages[] = '.' . $line;
+			} else {
+				$messages[] = $line;
+			}
+		}
+		$message = implode("\r\n", $messages);
+		$this->_smtpSend($headers . "\r\n\r\n" . $message . "\r\n\r\n\r\n.");
+		$this->_content = array('headers' => $headers, 'message' => $message);
+	}
+
+/**
+ * Disconnect
+ *
+ * @return void
+ * @throws SocketException
+ */
+	protected function _disconnect() {
+		$this->_smtpSend('QUIT', false);
+		$this->_socket->disconnect();
+	}
+
+/**
+ * Helper method to generate socket
+ *
+ * @return void
+ * @throws SocketException
+ */
+	protected function _generateSocket() {
+		$this->_socket = new CakeSocket($this->_config);
+	}
+
+/**
+ * Protected method for sending data to SMTP connection
+ *
+ * @param string $data data to be sent to SMTP server
+ * @param string|boolean $checkCode code to check for in server response, false to skip
+ * @return void
+ * @throws SocketException
+ */
+	protected function _smtpSend($data, $checkCode = '250') {
+		if (!is_null($data)) {
+			$this->_socket->write($data . "\r\n");
+		}
+		while ($checkCode !== false) {
+			$response = '';
+			$startTime = time();
+			while (substr($response, -2) !== "\r\n" && ((time() - $startTime) < $this->_config['timeout'])) {
+				$response .= $this->_socket->read();
+			}
+			if (substr($response, -2) !== "\r\n") {
+				throw new SocketException(__d('cake_dev', 'SMTP timeout.'));
+			}
+			$responseLines = explode("\r\n", rtrim($response, "\r\n"));
+			$response = end($responseLines);
+
+			if (preg_match('/^(' . $checkCode . ')(.)/', $response, $code)) {
+				if ($code[2] === '-') {
+					continue;
+				}
+				return $code[1];
+			}
+			throw new SocketException(__d('cake_dev', 'SMTP Error: %s', $response));
+		}
+	}
+
+}