cakephp2-php8/lib/Cake/Network/Email/SmtpTransport.php

374 lines
8.8 KiB
PHP
Raw Normal View History

2011-03-01 16:47:05 +00:00
<?php
/**
* Send mail using SMTP protocol
*
* CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
* Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
2011-03-01 16:47:05 +00:00
*
* Licensed under The MIT License
* For full copyright and license information, please see the LICENSE.txt
2011-03-01 16:47:05 +00:00
* Redistributions of files must retain the above copyright notice.
*
* @copyright Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
2011-03-01 16:47:05 +00:00
* @link http://cakephp.org CakePHP(tm) Project
* @package Cake.Network.Email
2011-03-01 16:47:05 +00:00
* @since CakePHP(tm) v 2.0.0
* @license http://www.opensource.org/licenses/mit-license.php MIT License
2011-03-01 16:47:05 +00:00
*/
2011-04-13 03:29:34 +00:00
App::uses('CakeSocket', 'Network');
2011-03-01 16:47:05 +00:00
/**
* Send mail using SMTP protocol
2011-03-01 16:47:05 +00:00
*
* @package Cake.Network.Email
2011-03-01 16:47:05 +00:00
*/
class SmtpTransport extends AbstractTransport {
/**
* Socket to SMTP server
*
* @var CakeSocket
2011-03-01 16:47:05 +00:00
*/
protected $_socket;
/**
* CakeEmail
*
* @var CakeEmail
2011-03-01 16:47:05 +00:00
*/
protected $_cakeEmail;
/**
* Content of email to return
*
* @var string
*/
protected $_content;
2014-03-13 15:28:54 +00:00
/**
* The response of the last sent SMTP command.
*
* @var array
*/
protected $_lastResponse = array();
/**
* Returns the response of the last sent SMTP command.
*
* A response consists of one or more lines containing a response
* code and an optional response message text:
* {{{
* array(
* array(
* 'code' => '250',
* 'message' => 'mail.example.com'
* ),
* array(
* 'code' => '250',
* 'message' => 'PIPELINING'
* ),
* array(
* 'code' => '250',
* 'message' => '8BITMIME'
* ),
* // etc...
* )
* }}}
*
* @return array
*/
public function getLastResponse() {
return $this->_lastResponse;
}
2011-03-01 16:47:05 +00:00
/**
* Send mail
*
* @param CakeEmail $email CakeEmail
* @return array
2011-04-29 01:25:18 +00:00
* @throws SocketException
2011-03-01 16:47:05 +00:00
*/
public function send(CakeEmail $email) {
$this->_cakeEmail = $email;
$this->_connect();
$this->_auth();
$this->_sendRcpt();
$this->_sendData();
$this->_disconnect();
return $this->_content;
2011-03-01 16:47:05 +00:00
}
/**
* Set the configuration
*
2014-06-04 18:58:55 +00:00
* @param array $config Configuration options.
* @return array Returns configs
*/
public function config($config = null) {
if ($config === null) {
return $this->_config;
}
$default = array(
'host' => 'localhost',
'port' => 25,
'timeout' => 30,
'username' => null,
'password' => null,
'client' => null,
'tls' => false
);
$this->_config = array_merge($default, $this->_config, $config);
return $this->_config;
}
2014-03-13 15:28:54 +00:00
/**
* Parses and stores the reponse lines in `'code' => 'message'` format.
*
2014-06-04 18:58:55 +00:00
* @param array $responseLines Response lines to parse.
2014-03-13 15:28:54 +00:00
* @return void
*/
protected function _bufferResponseLines(array $responseLines) {
$response = array();
foreach ($responseLines as $responseLine) {
2014-03-15 10:47:13 +00:00
if (preg_match('/^(\d{3})(?:[ -]+(.*))?$/', $responseLine, $match)) {
2014-03-13 15:28:54 +00:00
$response[] = array(
'code' => $match[1],
'message' => isset($match[2]) ? $match[2] : null
);
}
}
$this->_lastResponse = array_merge($this->_lastResponse, $response);
}
2011-03-01 16:47:05 +00:00
/**
* Connect to SMTP Server
*
* @return void
2011-04-29 01:25:18 +00:00
* @throws SocketException
2011-03-01 16:47:05 +00:00
*/
protected function _connect() {
$this->_generateSocket();
if (!$this->_socket->connect()) {
throw new SocketException(__d('cake_dev', 'Unable to connect to SMTP server.'));
2011-03-01 16:47:05 +00:00
}
$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');
if ($this->_config['tls']) {
$this->_smtpSend("STARTTLS", '220');
$this->_socket->enableCrypto('tls');
$this->_smtpSend("EHLO {$host}", '250');
}
2011-03-01 16:47:05 +00:00
} catch (SocketException $e) {
if ($this->_config['tls']) {
throw new SocketException(__d('cake_dev', 'SMTP server did not accept the connection or trying to connect to non TLS SMTP server using TLS.'));
}
2011-03-01 16:47:05 +00:00
try {
$this->_smtpSend("HELO {$host}", '250');
} catch (SocketException $e2) {
throw new SocketException(__d('cake_dev', 'SMTP server did not accept the connection.'));
2011-03-01 16:47:05 +00:00
}
}
}
/**
* Send authentication
*
* @return void
2011-04-29 01:25:18 +00:00
* @throws SocketException
2011-03-01 16:47:05 +00:00
*/
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.'));
2011-03-01 16:47:05 +00:00
}
if (!$this->_smtpSend(base64_encode($this->_config['password']), '235')) {
throw new SocketException(__d('cake_dev', 'SMTP server did not accept the password.'));
2011-03-01 16:47:05 +00:00
}
} elseif ($authRequired == '504') {
throw new SocketException(__d('cake_dev', 'SMTP authentication method not allowed, check if SMTP server requires TLS'));
2011-03-01 16:47:05 +00:00
} elseif ($authRequired != '503') {
throw new SocketException(__d('cake_dev', 'SMTP does not require authentication.'));
2011-03-01 16:47:05 +00:00
}
}
}
/**
* Prepares the `MAIL FROM` SMTP command.
2011-03-01 16:47:05 +00:00
*
* @param string $email The email address to send with the command.
* @return string
2011-03-01 16:47:05 +00:00
*/
protected function _prepareFromCmd($email) {
return 'MAIL FROM:<' . $email . '>';
}
/**
* Prepares the `RCPT TO` SMTP command.
*
* @param string $email The email address to send with the command.
* @return string
*/
protected function _prepareRcptCmd($email) {
return 'RCPT TO:<' . $email . '>';
}
/**
* Prepares the `from` email address.
*
* @return array
*/
protected function _prepareFromAddress() {
$from = $this->_cakeEmail->returnPath();
if (empty($from)) {
$from = $this->_cakeEmail->from();
}
return $from;
}
2011-03-01 16:47:05 +00:00
/**
* Prepares the recipient email addresses.
*
* @return array
*/
protected function _prepareRecipientAddresses() {
$to = $this->_cakeEmail->to();
$cc = $this->_cakeEmail->cc();
$bcc = $this->_cakeEmail->bcc();
return array_merge(array_keys($to), array_keys($cc), array_keys($bcc));
2011-03-01 16:47:05 +00:00
}
/**
* Prepares the message headers.
2011-03-01 16:47:05 +00:00
*
* @return array
2011-03-01 16:47:05 +00:00
*/
protected function _prepareMessageHeaders() {
return $this->_cakeEmail->getHeaders(array('from', 'sender', 'replyTo', 'readReceipt', 'to', 'cc', 'subject'));
}
2011-03-01 16:47:05 +00:00
/**
* Prepares the message body.
*
* @return string
*/
protected function _prepareMessage() {
$lines = $this->_cakeEmail->message();
$messages = array();
foreach ($lines as $line) {
2012-05-08 15:16:17 +00:00
if ((!empty($line)) && ($line[0] === '.')) {
$messages[] = '.' . $line;
} else {
$messages[] = $line;
}
}
return implode("\r\n", $messages);
}
/**
* Send emails
*
* @return void
* @throws SocketException
*/
protected function _sendRcpt() {
$from = $this->_prepareFromAddress();
$this->_smtpSend($this->_prepareFromCmd(key($from)));
$emails = $this->_prepareRecipientAddresses();
foreach ($emails as $email) {
$this->_smtpSend($this->_prepareRcptCmd($email));
}
}
/**
* Send Data
*
* @return void
* @throws SocketException
*/
protected function _sendData() {
$this->_smtpSend('DATA', '354');
$headers = $this->_headersToString($this->_prepareMessageHeaders());
$message = $this->_prepareMessage();
$this->_smtpSend($headers . "\r\n\r\n" . $message . "\r\n\r\n\r\n.");
$this->_content = array('headers' => $headers, 'message' => $message);
2011-03-01 16:47:05 +00:00
}
/**
* Disconnect
*
* @return void
2011-04-29 01:25:18 +00:00
* @throws SocketException
2011-03-01 16:47:05 +00:00
*/
protected function _disconnect() {
$this->_smtpSend('QUIT', false);
$this->_socket->disconnect();
}
/**
* Helper method to generate socket
*
* @return void
2011-04-29 01:25:18 +00:00
* @throws SocketException
2011-03-01 16:47:05 +00:00
*/
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
2011-03-01 16:47:05 +00:00
* @return void
2011-04-29 01:25:18 +00:00
* @throws SocketException
2011-03-01 16:47:05 +00:00
*/
protected function _smtpSend($data, $checkCode = '250') {
2014-03-13 15:28:54 +00:00
$this->_lastResponse = array();
if ($data !== null) {
2011-03-01 16:47:05 +00:00
$this->_socket->write($data . "\r\n");
}
while ($checkCode !== false) {
$response = '';
$startTime = time();
2011-04-04 02:41:40 +00:00
while (substr($response, -2) !== "\r\n" && ((time() - $startTime) < $this->_config['timeout'])) {
2011-03-01 16:47:05 +00:00
$response .= $this->_socket->read();
}
if (substr($response, -2) !== "\r\n") {
throw new SocketException(__d('cake_dev', 'SMTP timeout.'));
2011-03-01 16:47:05 +00:00
}
$responseLines = explode("\r\n", rtrim($response, "\r\n"));
$response = end($responseLines);
2011-03-01 16:47:05 +00:00
2014-03-13 15:28:54 +00:00
$this->_bufferResponseLines($responseLines);
2011-03-01 16:47:05 +00:00
if (preg_match('/^(' . $checkCode . ')(.)/', $response, $code)) {
if ($code[2] === '-') {
continue;
}
return $code[1];
}
throw new SocketException(__d('cake_dev', 'SMTP Error: %s', $response));
2011-03-01 16:47:05 +00:00
}
}
}