Added 3rd party KH modules

This commit is contained in:
Deon George
2013-04-22 14:19:54 +10:00
parent 68c7f4f159
commit 85be61ab8b
177 changed files with 21253 additions and 0 deletions

View File

@@ -0,0 +1,543 @@
<?php
/*
* This file is part of SwiftMailer.
* (c) 2004-2009 Chris Corbyn
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
//@require 'Swift/Transport.php';
//@require 'Swift/Transport/IoBuffer.php';
//@require 'Swift/Transport/CommandSentException.php';
//@require 'Swift/TransportException.php';
//@require 'Swift/Mime/Message.php';
//@require 'Swift/Events/EventDispatcher.php';
//@require 'Swift/Events/EventListener.php';
/**
* Sends Messages over SMTP.
*
* @package Swift
* @subpackage Transport
* @author Chris Corbyn
*/
abstract class Swift_Transport_AbstractSmtpTransport
implements Swift_Transport
{
/** Input-Output buffer for sending/receiving SMTP commands and responses */
protected $_buffer;
/** Connection status */
protected $_started = false;
/** The domain name to use in HELO command */
protected $_domain = '[127.0.0.1]';
/** The event dispatching layer */
protected $_eventDispatcher;
/** Return an array of params for the Buffer */
abstract protected function _getBufferParams();
/**
* Creates a new EsmtpTransport using the given I/O buffer.
*
* @param Swift_Transport_IoBuffer $buf
* @param Swift_Events_EventDispatcher $dispatcher
*/
public function __construct(Swift_Transport_IoBuffer $buf,
Swift_Events_EventDispatcher $dispatcher)
{
$this->_eventDispatcher = $dispatcher;
$this->_buffer = $buf;
$this->_lookupHostname();
}
/**
* Set the name of the local domain which Swift will identify itself as.
* This should be a fully-qualified domain name and should be truly the domain
* you're using. If your server doesn't have a domain name, use the IP in square
* brackets (i.e. [127.0.0.1]).
*
* @param string $domain
*/
public function setLocalDomain($domain)
{
$this->_domain = $domain;
return $this;
}
/**
* Get the name of the domain Swift will identify as.
*
* @return string
*/
public function getLocalDomain()
{
return $this->_domain;
}
/**
* Start the SMTP connection.
*/
public function start()
{
if (!$this->_started)
{
if ($evt = $this->_eventDispatcher->createTransportChangeEvent($this))
{
$this->_eventDispatcher->dispatchEvent($evt, 'beforeTransportStarted');
if ($evt->bubbleCancelled())
{
return;
}
}
try
{
$this->_buffer->initialize($this->_getBufferParams());
}
catch (Swift_TransportException $e)
{
$this->_throwException($e);
}
$this->_readGreeting();
$this->_doHeloCommand();
if ($evt)
{
$this->_eventDispatcher->dispatchEvent($evt, 'transportStarted');
}
$this->_started = true;
}
}
/**
* Test if an SMTP connection has been established.
*
* @return boolean
*/
public function isStarted()
{
return $this->_started;
}
/**
* Send the given Message.
*
* Recipient/sender data will be retreived from the Message API.
* The return value is the number of recipients who were accepted for delivery.
*
* @param Swift_Mime_Message $message
* @param string[] &$failedRecipients to collect failures by-reference
* @return int
*/
public function send(Swift_Mime_Message $message, &$failedRecipients = null)
{
$sent = 0;
$failedRecipients = (array) $failedRecipients;
if (!$reversePath = $this->_getReversePath($message))
{
throw new Swift_TransportException(
'Cannot send message without a sender address'
);
}
if ($evt = $this->_eventDispatcher->createSendEvent($this, $message))
{
$this->_eventDispatcher->dispatchEvent($evt, 'beforeSendPerformed');
if ($evt->bubbleCancelled())
{
return 0;
}
}
$to = (array) $message->getTo();
$cc = (array) $message->getCc();
$bcc = (array) $message->getBcc();
$message->setBcc(array());
try
{
$sent += $this->_sendTo($message, $reversePath, $to, $failedRecipients);
$sent += $this->_sendCc($message, $reversePath, $cc, $failedRecipients);
$sent += $this->_sendBcc($message, $reversePath, $bcc, $failedRecipients);
}
catch (Exception $e)
{
$message->setBcc($bcc);
throw $e;
}
$message->setBcc($bcc);
if ($evt)
{
if ($sent == count($to) + count($cc) + count($bcc))
{
$evt->setResult(Swift_Events_SendEvent::RESULT_SUCCESS);
}
elseif ($sent > 0)
{
$evt->setResult(Swift_Events_SendEvent::RESULT_TENTATIVE);
}
else
{
$evt->setResult(Swift_Events_SendEvent::RESULT_FAILED);
}
$evt->setFailedRecipients($failedRecipients);
$this->_eventDispatcher->dispatchEvent($evt, 'sendPerformed');
}
$message->generateId(); //Make sure a new Message ID is used
return $sent;
}
/**
* Stop the SMTP connection.
*/
public function stop()
{
if ($this->_started)
{
if ($evt = $this->_eventDispatcher->createTransportChangeEvent($this))
{
$this->_eventDispatcher->dispatchEvent($evt, 'beforeTransportStopped');
if ($evt->bubbleCancelled())
{
return;
}
}
try
{
$this->executeCommand("QUIT\r\n", array(221));
}
catch (Swift_TransportException $e) {}
try
{
$this->_buffer->terminate();
if ($evt)
{
$this->_eventDispatcher->dispatchEvent($evt, 'transportStopped');
}
}
catch (Swift_TransportException $e)
{
$this->_throwException($e);
}
}
$this->_started = false;
}
/**
* Register a plugin.
*
* @param Swift_Events_EventListener $plugin
*/
public function registerPlugin(Swift_Events_EventListener $plugin)
{
$this->_eventDispatcher->bindEventListener($plugin);
}
/**
* Reset the current mail transaction.
*/
public function reset()
{
$this->executeCommand("RSET\r\n", array(250));
}
/**
* Get the IoBuffer where read/writes are occurring.
*
* @return Swift_Transport_IoBuffer
*/
public function getBuffer()
{
return $this->_buffer;
}
/**
* Run a command against the buffer, expecting the given response codes.
*
* If no response codes are given, the response will not be validated.
* If codes are given, an exception will be thrown on an invalid response.
*
* @param string $command
* @param int[] $codes
* @param string[] &$failures
* @return string
*/
public function executeCommand($command, $codes = array(), &$failures = null)
{
$failures = (array) $failures;
$seq = $this->_buffer->write($command);
$response = $this->_getFullResponse($seq);
if ($evt = $this->_eventDispatcher->createCommandEvent($this, $command, $codes))
{
$this->_eventDispatcher->dispatchEvent($evt, 'commandSent');
}
$this->_assertResponseCode($response, $codes);
return $response;
}
// -- Protected methods
/** Read the opening SMTP greeting */
protected function _readGreeting()
{
$this->_assertResponseCode($this->_getFullResponse(0), array(220));
}
/** Send the HELO welcome */
protected function _doHeloCommand()
{
$this->executeCommand(
sprintf("HELO %s\r\n", $this->_domain), array(250)
);
}
/** Send the MAIL FROM command */
protected function _doMailFromCommand($address)
{
$this->executeCommand(
sprintf("MAIL FROM: <%s>\r\n", $address), array(250)
);
}
/** Send the RCPT TO command */
protected function _doRcptToCommand($address)
{
$this->executeCommand(
sprintf("RCPT TO: <%s>\r\n", $address), array(250, 251, 252)
);
}
/** Send the DATA command */
protected function _doDataCommand()
{
$this->executeCommand("DATA\r\n", array(354));
}
/** Stream the contents of the message over the buffer */
protected function _streamMessage(Swift_Mime_Message $message)
{
$this->_buffer->setWriteTranslations(array("\r\n." => "\r\n.."));
try
{
$message->toByteStream($this->_buffer);
$this->_buffer->flushBuffers();
}
catch (Swift_TransportException $e)
{
$this->_throwException($e);
}
$this->_buffer->setWriteTranslations(array());
$this->executeCommand("\r\n.\r\n", array(250));
}
/** Determine the best-use reverse path for this message */
protected function _getReversePath(Swift_Mime_Message $message)
{
$return = $message->getReturnPath();
$sender = $message->getSender();
$from = $message->getFrom();
$path = null;
if (!empty($return))
{
$path = $return;
}
elseif (!empty($sender))
{
// Don't use array_keys
reset($sender); // Reset Pointer to first pos
$path = key($sender); // Get key
}
elseif (!empty($from))
{
reset($from); // Reset Pointer to first pos
$path = key($from); // Get key
}
return $path;
}
/** Throw a TransportException, first sending it to any listeners */
protected function _throwException(Swift_TransportException $e)
{
if ($evt = $this->_eventDispatcher->createTransportExceptionEvent($this, $e))
{
$this->_eventDispatcher->dispatchEvent($evt, 'exceptionThrown');
if (!$evt->bubbleCancelled())
{
throw $e;
}
}
else
{
throw $e;
}
}
/** Throws an Exception if a response code is incorrect */
protected function _assertResponseCode($response, $wanted)
{
list($code, $separator, $text) = sscanf($response, '%3d%[ -]%s');
$valid = (empty($wanted) || in_array($code, $wanted));
if ($evt = $this->_eventDispatcher->createResponseEvent($this, $response,
$valid))
{
$this->_eventDispatcher->dispatchEvent($evt, 'responseReceived');
}
if (!$valid)
{
$this->_throwException(
new Swift_TransportException(
'Expected response code ' . implode('/', $wanted) . ' but got code ' .
'"' . $code . '", with message "' . $response . '"'
)
);
}
}
/** Get an entire multi-line response using its sequence number */
protected function _getFullResponse($seq)
{
$response = '';
try
{
do
{
$line = $this->_buffer->readLine($seq);
$response .= $line;
}
while (null !== $line && false !== $line && ' ' != $line{3});
}
catch (Swift_TransportException $e)
{
$this->_throwException($e);
}
return $response;
}
// -- Private methods
/** Send an email to the given recipients from the given reverse path */
private function _doMailTransaction($message, $reversePath,
array $recipients, array &$failedRecipients)
{
$sent = 0;
$this->_doMailFromCommand($reversePath);
foreach ($recipients as $forwardPath)
{
try
{
$this->_doRcptToCommand($forwardPath);
$sent++;
}
catch (Swift_TransportException $e)
{
$failedRecipients[] = $forwardPath;
}
}
if ($sent != 0)
{
$this->_doDataCommand();
$this->_streamMessage($message);
}
else
{
$this->reset();
}
return $sent;
}
/** Send a message to the given To: recipients */
private function _sendTo(Swift_Mime_Message $message, $reversePath,
array $to, array &$failedRecipients)
{
if (empty($to))
{
return 0;
}
return $this->_doMailTransaction($message, $reversePath, array_keys($to),
$failedRecipients);
}
/** Send a message to the given Cc: recipients */
private function _sendCc(Swift_Mime_Message $message, $reversePath,
array $cc, array &$failedRecipients)
{
if (empty($cc))
{
return 0;
}
return $this->_doMailTransaction($message, $reversePath, array_keys($cc),
$failedRecipients);
}
/** Send a message to all Bcc: recipients */
private function _sendBcc(Swift_Mime_Message $message, $reversePath,
array $bcc, array &$failedRecipients)
{
$sent = 0;
foreach ($bcc as $forwardPath => $name)
{
$message->setBcc(array($forwardPath => $name));
$sent += $this->_doMailTransaction(
$message, $reversePath, array($forwardPath), $failedRecipients
);
}
return $sent;
}
/** Try to determine the hostname of the server this is run on */
private function _lookupHostname()
{
if (!empty($_SERVER['SERVER_NAME'])
&& $this->_isFqdn($_SERVER['SERVER_NAME']))
{
$this->_domain = $_SERVER['SERVER_NAME'];
}
elseif (!empty($_SERVER['SERVER_ADDR']))
{
$this->_domain = sprintf('[%s]', $_SERVER['SERVER_ADDR']);
}
}
/** Determine is the $hostname is a fully-qualified name */
private function _isFqdn($hostname)
{
//We could do a really thorough check, but there's really no point
if (false !== $dotPos = strpos($hostname, '.'))
{
return ($dotPos > 0) && ($dotPos != strlen($hostname) - 1);
}
else
{
return false;
}
}
/**
* Destructor.
*/
public function __destruct()
{
$this->stop();
}
}

View File

@@ -0,0 +1,88 @@
<?php
/*
* This file is part of SwiftMailer.
* (c) 2004-2009 Chris Corbyn
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
//@require 'Swift/Transport/Esmtp/Authenticator.php';
//@require 'Swift/Transport/SmtpAgent.php';
//@require 'Swift/TransportException.php';
/**
* Handles CRAM-MD5 authentication.
* @package Swift
* @subpackage Transport
* @author Chris Corbyn
*/
class Swift_Transport_Esmtp_Auth_CramMd5Authenticator
implements Swift_Transport_Esmtp_Authenticator
{
/**
* Get the name of the AUTH mechanism this Authenticator handles.
* @return string
*/
public function getAuthKeyword()
{
return 'CRAM-MD5';
}
/**
* Try to authenticate the user with $username and $password.
* @param Swift_Transport_SmtpAgent $agent
* @param string $username
* @param string $password
* @return boolean
*/
public function authenticate(Swift_Transport_SmtpAgent $agent,
$username, $password)
{
try
{
$challenge = $agent->executeCommand("AUTH CRAM-MD5\r\n", array(334));
$challenge = base64_decode(substr($challenge, 4));
$message = base64_encode(
$username . ' ' . $this->_getResponse($password, $challenge)
);
$agent->executeCommand(sprintf("%s\r\n", $message), array(235));
return true;
}
catch (Swift_TransportException $e)
{
$agent->executeCommand("RSET\r\n", array(250));
return false;
}
}
/**
* Generate a CRAM-MD5 response from a server challenge.
* @param string $secret
* @param string $challenge
* @return string
*/
private function _getResponse($secret, $challenge)
{
if (strlen($secret) > 64)
{
$secret = pack('H32', md5($secret));
}
if (strlen($secret) < 64)
{
$secret = str_pad($secret, 64, chr(0));
}
$k_ipad = substr($secret, 0, 64) ^ str_repeat(chr(0x36), 64);
$k_opad = substr($secret, 0, 64) ^ str_repeat(chr(0x5C), 64);
$inner = pack('H32', md5($k_ipad . $challenge));
$digest = md5($k_opad . $inner);
return $digest;
}
}

View File

@@ -0,0 +1,58 @@
<?php
/*
* This file is part of SwiftMailer.
* (c) 2004-2009 Chris Corbyn
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
//@require 'Swift/Transport/Esmtp/Authenticator.php';
//@require 'Swift/Transport/SmtpAgent.php';
//@require 'Swift/TransportException.php';
/**
* Handles LOGIN authentication.
* @package Swift
* @subpackage Transport
* @author Chris Corbyn
*/
class Swift_Transport_Esmtp_Auth_LoginAuthenticator
implements Swift_Transport_Esmtp_Authenticator
{
/**
* Get the name of the AUTH mechanism this Authenticator handles.
* @return string
*/
public function getAuthKeyword()
{
return 'LOGIN';
}
/**
* Try to authenticate the user with $username and $password.
* @param Swift_Transport_SmtpAgent $agent
* @param string $username
* @param string $password
* @return boolean
*/
public function authenticate(Swift_Transport_SmtpAgent $agent,
$username, $password)
{
try
{
$agent->executeCommand("AUTH LOGIN\r\n", array(334));
$agent->executeCommand(sprintf("%s\r\n", base64_encode($username)), array(334));
$agent->executeCommand(sprintf("%s\r\n", base64_encode($password)), array(235));
return true;
}
catch (Swift_TransportException $e)
{
$agent->executeCommand("RSET\r\n", array(250));
return false;
}
}
}

View File

@@ -0,0 +1,57 @@
<?php
/*
* This file is part of SwiftMailer.
* (c) 2004-2009 Chris Corbyn
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
//@require 'Swift/Transport/Esmtp/Authenticator.php';
//@require 'Swift/Transport/SmtpAgent.php';
//@require 'Swift/TransportException.php';
/**
* Handles PLAIN authentication.
* @package Swift
* @subpackage Transport
* @author Chris Corbyn
*/
class Swift_Transport_Esmtp_Auth_PlainAuthenticator
implements Swift_Transport_Esmtp_Authenticator
{
/**
* Get the name of the AUTH mechanism this Authenticator handles.
* @return string
*/
public function getAuthKeyword()
{
return 'PLAIN';
}
/**
* Try to authenticate the user with $username and $password.
* @param Swift_Transport_SmtpAgent $agent
* @param string $username
* @param string $password
* @return boolean
*/
public function authenticate(Swift_Transport_SmtpAgent $agent,
$username, $password)
{
try
{
$message = base64_encode($username . chr(0) . $username . chr(0) . $password);
$agent->executeCommand(sprintf("AUTH PLAIN %s\r\n", $message), array(235));
return true;
}
catch (Swift_TransportException $e)
{
$agent->executeCommand("RSET\r\n", array(250));
return false;
}
}
}

View File

@@ -0,0 +1,262 @@
<?php
/*
* This file is part of SwiftMailer.
* (c) 2004-2009 Chris Corbyn
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
//@require 'Swift/TransportException.php';
//@require 'Swift/Transport/EsmtpHandler.php';
//@require 'Swift/Transport/SmtpAgent.php';
/**
* An ESMTP handler for AUTH support.
* @package Swift
* @subpackage Transport
* @author Chris Corbyn
*/
class Swift_Transport_Esmtp_AuthHandler implements Swift_Transport_EsmtpHandler
{
/**
* Authenticators available to process the request.
* @var Swift_Transport_Esmtp_Authenticator[]
* @access private
*/
private $_authenticators = array();
/**
* The username for authentication.
* @var string
* @access private
*/
private $_username;
/**
* The password for authentication.
* @var string
* @access private
*/
private $_password;
/**
* The auth mode for authentication.
* @var string
* @access private
*/
private $_auth_mode;
/**
* The ESMTP AUTH parameters available.
* @var string[]
* @access private
*/
private $_esmtpParams = array();
/**
* Create a new AuthHandler with $authenticators for support.
* @param Swift_Transport_Esmtp_Authenticator[] $authenticators
*/
public function __construct(array $authenticators)
{
$this->setAuthenticators($authenticators);
}
/**
* Set the Authenticators which can process a login request.
* @param Swift_Transport_Esmtp_Authenticator[] $authenticators
*/
public function setAuthenticators(array $authenticators)
{
$this->_authenticators = $authenticators;
}
/**
* Get the Authenticators which can process a login request.
* @return Swift_Transport_Esmtp_Authenticator[]
*/
public function getAuthenticators()
{
return $this->_authenticators;
}
/**
* Set the username to authenticate with.
* @param string $username
*/
public function setUsername($username)
{
$this->_username = $username;
}
/**
* Get the username to authenticate with.
* @return string
*/
public function getUsername()
{
return $this->_username;
}
/**
* Set the password to authenticate with.
* @param string $password
*/
public function setPassword($password)
{
$this->_password = $password;
}
/**
* Get the password to authenticate with.
* @return string
*/
public function getPassword()
{
return $this->_password;
}
/**
* Set the auth mode to use to authenticate.
* @param string $mode
*/
public function setAuthMode($mode)
{
$this->_auth_mode = $mode;
}
/**
* Get the auth mode to use to authenticate.
* @return string
*/
public function getAuthMode()
{
return $this->_auth_mode;
}
/**
* Get the name of the ESMTP extension this handles.
* @return boolean
*/
public function getHandledKeyword()
{
return 'AUTH';
}
/**
* Set the parameters which the EHLO greeting indicated.
* @param string[] $parameters
*/
public function setKeywordParams(array $parameters)
{
$this->_esmtpParams = $parameters;
}
/**
* Runs immediately after a EHLO has been issued.
* @param Swift_Transport_SmtpAgent $agent to read/write
*/
public function afterEhlo(Swift_Transport_SmtpAgent $agent)
{
if ($this->_username)
{
$count = 0;
foreach ($this->_getAuthenticatorsForAgent() as $authenticator)
{
if (in_array(strtolower($authenticator->getAuthKeyword()),
array_map('strtolower', $this->_esmtpParams)))
{
$count++;
if ($authenticator->authenticate($agent, $this->_username, $this->_password))
{
return;
}
}
}
throw new Swift_TransportException(
'Failed to authenticate on SMTP server with username "' .
$this->_username . '" using ' . $count . ' possible authenticators'
);
}
}
/**
* Not used.
*/
public function getMailParams()
{
return array();
}
/**
* Not used.
*/
public function getRcptParams()
{
return array();
}
/**
* Not used.
*/
public function onCommand(Swift_Transport_SmtpAgent $agent,
$command, $codes = array(), &$failedRecipients = null, &$stop = false)
{
}
/**
* Returns +1, -1 or 0 according to the rules for usort().
* This method is called to ensure extensions can be execute in an appropriate order.
* @param string $esmtpKeyword to compare with
* @return int
*/
public function getPriorityOver($esmtpKeyword)
{
return 0;
}
/**
* Returns an array of method names which are exposed to the Esmtp class.
* @return string[]
*/
public function exposeMixinMethods()
{
return array('setUsername', 'getUsername', 'setPassword', 'getPassword', 'setAuthMode', 'getAuthMode');
}
/**
* Not used.
*/
public function resetState()
{
}
// -- Protected methods
/**
* Returns the authenticator list for the given agent.
* @param Swift_Transport_SmtpAgent $agent
* @return array
* @access protected
*/
protected function _getAuthenticatorsForAgent()
{
if (!$mode = strtolower($this->_auth_mode))
{
return $this->_authenticators;
}
foreach ($this->_authenticators as $authenticator)
{
if (strtolower($authenticator->getAuthKeyword()) == $mode)
{
return array($authenticator);
}
}
throw new Swift_TransportException('Auth mode '.$mode.' is invalid');
}
}

View File

@@ -0,0 +1,38 @@
<?php
/*
* This file is part of SwiftMailer.
* (c) 2004-2009 Chris Corbyn
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
//@require 'Swift/Transport/SmtpAgent.php';
/**
* An Authentication mechanism.
* @package Swift
* @subpackage Transport
* @author Chris Corbyn
*/
interface Swift_Transport_Esmtp_Authenticator
{
/**
* Get the name of the AUTH mechanism this Authenticator handles.
* @return string
*/
public function getAuthKeyword();
/**
* Try to authenticate the user with $username and $password.
* @param Swift_Transport_SmtpAgent $agent
* @param string $username
* @param string $password
* @return boolean
*/
public function authenticate(Swift_Transport_SmtpAgent $agent,
$username, $password);
}

View File

@@ -0,0 +1,82 @@
<?php
/*
* This file is part of SwiftMailer.
* (c) 2004-2009 Chris Corbyn
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
//@require 'Swift/Transport/EsmtpBufferWrapper.php';
/**
* An ESMTP handler.
* @package Swift
* @subpackage Transport
* @author Chris Corbyn
*/
interface Swift_Transport_EsmtpHandler
{
/**
* Get the name of the ESMTP extension this handles.
* @return boolean
*/
public function getHandledKeyword();
/**
* Set the parameters which the EHLO greeting indicated.
* @param string[] $parameters
*/
public function setKeywordParams(array $parameters);
/**
* Runs immediately after a EHLO has been issued.
* @param Swift_Transport_SmtpAgent $agent to read/write
*/
public function afterEhlo(Swift_Transport_SmtpAgent $agent);
/**
* Get params which are appended to MAIL FROM:<>.
* @return string[]
*/
public function getMailParams();
/**
* Get params which are appended to RCPT TO:<>.
* @return string[]
*/
public function getRcptParams();
/**
* Runs when a command is due to be sent.
* @param Swift_Transport_SmtpAgent $agent to read/write
* @param string $command to send
* @param int[] $codes expected in response
* @param string[] &$failedRecipients
* @param boolean &$stop to be set true if the command is now sent
*/
public function onCommand(Swift_Transport_SmtpAgent $agent,
$command, $codes = array(), &$failedRecipients = null, &$stop = false);
/**
* Returns +1, -1 or 0 according to the rules for usort().
* This method is called to ensure extensions can be execute in an appropriate order.
* @param string $esmtpKeyword to compare with
* @return int
*/
public function getPriorityOver($esmtpKeyword);
/**
* Returns an array of method names which are exposed to the Esmtp class.
* @return string[]
*/
public function exposeMixinMethods();
/**
* Tells this handler to clear any buffers and reset its state.
*/
public function resetState();
}

View File

@@ -0,0 +1,340 @@
<?php
/*
* This file is part of SwiftMailer.
* (c) 2004-2009 Chris Corbyn
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
//@require 'Swift/Transport/AbstractSmtpTransport.php';
//@require 'Swift/Transport/EsmtpHandler.php';
//@require 'Swift/Transport/IoBuffer.php';
//@require 'Swift/Transport/SmtpAgent.php';
//@require 'Swift/TransportException.php';
//@require 'Swift/Mime/Message.php';
//@require 'Swift/Events/EventDispatcher.php';
/**
* Sends Messages over SMTP with ESMTP support.
* @package Swift
* @subpackage Transport
* @author Chris Corbyn
*/
class Swift_Transport_EsmtpTransport
extends Swift_Transport_AbstractSmtpTransport
implements Swift_Transport_SmtpAgent
{
/**
* ESMTP extension handlers.
* @var Swift_Transport_EsmtpHandler[]
* @access private
*/
private $_handlers = array();
/**
* ESMTP capabilities.
* @var string[]
* @access private
*/
private $_capabilities = array();
/**
* Connection buffer parameters.
* @var array
* @access protected
*/
private $_params = array(
'protocol' => 'tcp',
'host' => 'localhost',
'port' => 25,
'timeout' => 30,
'blocking' => 1,
'type' => Swift_Transport_IoBuffer::TYPE_SOCKET
);
/**
* Creates a new EsmtpTransport using the given I/O buffer.
* @param Swift_Transport_IoBuffer $buf
* @param Swift_Transport_EsmtpHandler[] $extensionHandlers
* @param Swift_Events_EventDispatcher $dispatcher
*/
public function __construct(Swift_Transport_IoBuffer $buf,
array $extensionHandlers, Swift_Events_EventDispatcher $dispatcher)
{
parent::__construct($buf, $dispatcher);
$this->setExtensionHandlers($extensionHandlers);
}
/**
* Set the host to connect to.
* @param string $host
*/
public function setHost($host)
{
$this->_params['host'] = $host;
return $this;
}
/**
* Get the host to connect to.
* @return string
*/
public function getHost()
{
return $this->_params['host'];
}
/**
* Set the port to connect to.
* @param int $port
*/
public function setPort($port)
{
$this->_params['port'] = (int) $port;
return $this;
}
/**
* Get the port to connect to.
* @return int
*/
public function getPort()
{
return $this->_params['port'];
}
/**
* Set the connection timeout.
* @param int $timeout seconds
*/
public function setTimeout($timeout)
{
$this->_params['timeout'] = (int) $timeout;
return $this;
}
/**
* Get the connection timeout.
* @return int
*/
public function getTimeout()
{
return $this->_params['timeout'];
}
/**
* Set the encryption type (tls or ssl)
* @param string $encryption
*/
public function setEncryption($enc)
{
$this->_params['protocol'] = $enc;
return $this;
}
/**
* Get the encryption type.
* @return string
*/
public function getEncryption()
{
return $this->_params['protocol'];
}
/**
* Set ESMTP extension handlers.
* @param Swift_Transport_EsmtpHandler[] $handlers
*/
public function setExtensionHandlers(array $handlers)
{
$assoc = array();
foreach ($handlers as $handler)
{
$assoc[$handler->getHandledKeyword()] = $handler;
}
uasort($assoc, array($this, '_sortHandlers'));
$this->_handlers = $assoc;
$this->_setHandlerParams();
return $this;
}
/**
* Get ESMTP extension handlers.
* @return Swift_Transport_EsmtpHandler[]
*/
public function getExtensionHandlers()
{
return array_values($this->_handlers);
}
/**
* Run a command against the buffer, expecting the given response codes.
* If no response codes are given, the response will not be validated.
* If codes are given, an exception will be thrown on an invalid response.
* @param string $command
* @param int[] $codes
* @param string[] &$failures
* @return string
*/
public function executeCommand($command, $codes = array(), &$failures = null)
{
$failures = (array) $failures;
$stopSignal = false;
$response = null;
foreach ($this->_getActiveHandlers() as $handler)
{
$response = $handler->onCommand(
$this, $command, $codes, $failures, $stopSignal
);
if ($stopSignal)
{
return $response;
}
}
return parent::executeCommand($command, $codes, $failures);
}
// -- Mixin invocation code
/** Mixin handling method for ESMTP handlers */
public function __call($method, $args)
{
foreach ($this->_handlers as $handler)
{
if (in_array(strtolower($method),
array_map('strtolower', (array) $handler->exposeMixinMethods())
))
{
$return = call_user_func_array(array($handler, $method), $args);
//Allow fluid method calls
if (is_null($return) && substr($method, 0, 3) == 'set')
{
return $this;
}
else
{
return $return;
}
}
}
trigger_error('Call to undefined method ' . $method, E_USER_ERROR);
}
// -- Protected methods
/** Get the params to initialize the buffer */
protected function _getBufferParams()
{
return $this->_params;
}
/** Overridden to perform EHLO instead */
protected function _doHeloCommand()
{
try
{
$response = $this->executeCommand(
sprintf("EHLO %s\r\n", $this->_domain), array(250)
);
}
catch (Swift_TransportException $e)
{
return parent::_doHeloCommand();
}
$this->_capabilities = $this->_getCapabilities($response);
$this->_setHandlerParams();
foreach ($this->_getActiveHandlers() as $handler)
{
$handler->afterEhlo($this);
}
}
/** Overridden to add Extension support */
protected function _doMailFromCommand($address)
{
$handlers = $this->_getActiveHandlers();
$params = array();
foreach ($handlers as $handler)
{
$params = array_merge($params, (array) $handler->getMailParams());
}
$paramStr = !empty($params) ? ' ' . implode(' ', $params) : '';
$this->executeCommand(
sprintf("MAIL FROM: <%s>%s\r\n", $address, $paramStr), array(250)
);
}
/** Overridden to add Extension support */
protected function _doRcptToCommand($address)
{
$handlers = $this->_getActiveHandlers();
$params = array();
foreach ($handlers as $handler)
{
$params = array_merge($params, (array) $handler->getRcptParams());
}
$paramStr = !empty($params) ? ' ' . implode(' ', $params) : '';
$this->executeCommand(
sprintf("RCPT TO: <%s>%s\r\n", $address, $paramStr), array(250, 251, 252)
);
}
// -- Private methods
/** Determine ESMTP capabilities by function group */
private function _getCapabilities($ehloResponse)
{
$capabilities = array();
$ehloResponse = trim($ehloResponse);
$lines = explode("\r\n", $ehloResponse);
array_shift($lines);
foreach ($lines as $line)
{
if (preg_match('/^[0-9]{3}[ -]([A-Z0-9-]+)((?:[ =].*)?)$/Di', $line, $matches))
{
$keyword = strtoupper($matches[1]);
$paramStr = strtoupper(ltrim($matches[2], ' ='));
$params = !empty($paramStr) ? explode(' ', $paramStr) : array();
$capabilities[$keyword] = $params;
}
}
return $capabilities;
}
/** Set parameters which are used by each extension handler */
private function _setHandlerParams()
{
foreach ($this->_handlers as $keyword => $handler)
{
if (array_key_exists($keyword, $this->_capabilities))
{
$handler->setKeywordParams($this->_capabilities[$keyword]);
}
}
}
/** Get ESMTP handlers which are currently ok to use */
private function _getActiveHandlers()
{
$handlers = array();
foreach ($this->_handlers as $keyword => $handler)
{
if (array_key_exists($keyword, $this->_capabilities))
{
$handlers[] = $handler;
}
}
return $handlers;
}
/** Custom sort for extension handler ordering */
private function _sortHandlers($a, $b)
{
return $a->getPriorityOver($b->getHandledKeyword());
}
}

View File

@@ -0,0 +1,97 @@
<?php
/*
* This file is part of SwiftMailer.
* (c) 2004-2009 Chris Corbyn
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
//@require 'Swift/Transport/LoadBalancedTransport.php';
//@require 'Swift/Mime/Message.php';
/**
* Contains a list of redundant Transports so when one fails, the next is used.
* @package Swift
* @subpackage Transport
* @author Chris Corbyn
*/
class Swift_Transport_FailoverTransport
extends Swift_Transport_LoadBalancedTransport
{
/**
* Registered transport curently used.
* @var Swift_Transport
* @access private
*/
private $_currentTransport;
/**
* Creates a new FailoverTransport.
*/
public function __construct()
{
parent::__construct();
}
/**
* Send the given Message.
* Recipient/sender data will be retreived from the Message API.
* The return value is the number of recipients who were accepted for delivery.
* @param Swift_Mime_Message $message
* @param string[] &$failedRecipients to collect failures by-reference
* @return int
*/
public function send(Swift_Mime_Message $message, &$failedRecipients = null)
{
$maxTransports = count($this->_transports);
$sent = 0;
for ($i = 0; $i < $maxTransports
&& $transport = $this->_getNextTransport(); ++$i)
{
try
{
if (!$transport->isStarted())
{
$transport->start();
}
return $transport->send($message, $failedRecipients);
}
catch (Swift_TransportException $e)
{
$this->_killCurrentTransport();
}
}
if (count($this->_transports) == 0)
{
throw new Swift_TransportException(
'All Transports in FailoverTransport failed, or no Transports available'
);
}
return $sent;
}
// -- Protected methods
protected function _getNextTransport()
{
if (!isset($this->_currentTransport))
{
$this->_currentTransport = parent::_getNextTransport();
}
return $this->_currentTransport;
}
protected function _killCurrentTransport()
{
$this->_currentTransport = null;
parent::_killCurrentTransport();
}
}

View File

@@ -0,0 +1,65 @@
<?php
/*
* This file is part of SwiftMailer.
* (c) 2004-2009 Chris Corbyn
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
//@require 'Swift/InputByteStream.php';
//@require 'Swift/OutputByteStream.php';
/**
* Buffers input and output to a resource.
* @package Swift
* @subpackage Transport
* @author Chris Corbyn
*/
interface Swift_Transport_IoBuffer
extends Swift_InputByteStream, Swift_OutputByteStream
{
/** A socket buffer over TCP */
const TYPE_SOCKET = 0x0001;
/** A process buffer with I/O support */
const TYPE_PROCESS = 0x0010;
/**
* Perform any initialization needed, using the given $params.
* Parameters will vary depending upon the type of IoBuffer used.
* @param array $params
*/
public function initialize(array $params);
/**
* Set an individual param on the buffer (e.g. switching to SSL).
* @param string $param
* @param mixed $value
*/
public function setParam($param, $value);
/**
* Perform any shutdown logic needed.
*/
public function terminate();
/**
* Set an array of string replacements which should be made on data written
* to the buffer. This could replace LF with CRLF for example.
* @param string[] $replacements
*/
public function setWriteTranslations(array $replacements);
/**
* Get a line of output (including any CRLF).
* The $sequence number comes from any writes and may or may not be used
* depending upon the implementation.
* @param int $sequence of last write to scan from
* @return string
*/
public function readLine($sequence);
}

View File

@@ -0,0 +1,188 @@
<?php
/*
* This file is part of SwiftMailer.
* (c) 2004-2009 Chris Corbyn
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
//@require 'Swift/Transport.php';
//@require 'Swift/Mime/Message.php';
//@require 'Swift/Events/EventListener.php';
/**
* Redudantly and rotationally uses several Transports when sending.
*
* @package Swift
* @subpackage Transport
* @author Chris Corbyn
*/
class Swift_Transport_LoadBalancedTransport implements Swift_Transport
{
/** Transports which are deemed useless */
private $_deadTransports = array();
/**
* The Transports which are used in rotation.
*
* @var array Swift_Transport
* @access protected
*/
protected $_transports = array();
/**
* Creates a new LoadBalancedTransport.
*/
public function __construct()
{
}
/**
* Set $transports to delegate to.
*
* @param array $transports Swift_Transport
*/
public function setTransports(array $transports)
{
$this->_transports = $transports;
$this->_deadTransports = array();
}
/**
* Get $transports to delegate to.
*
* @return array Swift_Transport
*/
public function getTransports(array $transports)
{
return array_merge($this->_transports, $this->_deadTransports);
}
/**
* Test if this Transport mechanism has started.
*
* @return boolean
*/
public function isStarted()
{
return count($this->_transports) > 0;
}
/**
* Start this Transport mechanism.
*/
public function start()
{
$this->_transports = array_merge($this->_transports, $this->_deadTransports);
}
/**
* Stop this Transport mechanism.
*/
public function stop()
{
foreach ($this->_transports as $transport)
{
$transport->stop();
}
}
/**
* Send the given Message.
*
* Recipient/sender data will be retreived from the Message API.
* The return value is the number of recipients who were accepted for delivery.
*
* @param Swift_Mime_Message $message
* @param string[] &$failedRecipients to collect failures by-reference
* @return int
*/
public function send(Swift_Mime_Message $message, &$failedRecipients = null)
{
$maxTransports = count($this->_transports);
$sent = 0;
for ($i = 0; $i < $maxTransports
&& $transport = $this->_getNextTransport(); ++$i)
{
try
{
if (!$transport->isStarted())
{
$transport->start();
}
if ($sent = $transport->send($message, $failedRecipients))
{
break;
}
}
catch (Swift_TransportException $e)
{
$this->_killCurrentTransport();
}
}
if (count($this->_transports) == 0)
{
throw new Swift_TransportException(
'All Transports in LoadBalancedTransport failed, or no Transports available'
);
}
return $sent;
}
/**
* Register a plugin.
*
* @param Swift_Events_EventListener $plugin
*/
public function registerPlugin(Swift_Events_EventListener $plugin)
{
foreach ($this->_transports as $transport)
{
$transport->registerPlugin($plugin);
}
}
// -- Protected methods
/**
* Rotates the transport list around and returns the first instance.
*
* @return Swift_Transport
* @access protected
*/
protected function _getNextTransport()
{
if ($next = array_shift($this->_transports))
{
$this->_transports[] = $next;
}
return $next;
}
/**
* Tag the currently used (top of stack) transport as dead/useless.
*
* @access protected
*/
protected function _killCurrentTransport()
{
if ($transport = array_pop($this->_transports))
{
try
{
$transport->stop();
}
catch (Exception $e)
{
}
$this->_deadTransports[] = $transport;
}
}
}

View File

@@ -0,0 +1,36 @@
<?php
/*
* This file is part of SwiftMailer.
* (c) 2004-2009 Chris Corbyn
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
/**
* This interface intercepts calls to the mail() function.
*
* @package Swift
* @subpackage Transport
* @author Chris Corbyn
*/
interface Swift_Transport_MailInvoker
{
/**
* Send mail via the mail() function.
*
* This method takes the same arguments as PHP mail().
*
* @param string $to
* @param string $subject
* @param string $body
* @param string $headers
* @param string $extraParams
*
* @return boolean
*/
public function mail($to, $subject, $body, $headers = null, $extraParams = null);
}

View File

@@ -0,0 +1,242 @@
<?php
/*
* This file is part of SwiftMailer.
* (c) 2004-2009 Chris Corbyn
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
//@require 'Swift/Transport.php';
//@require 'Swift/Transport/MailInvoker.php';
//@require 'Swift/Mime/Message.php';
//@require 'Swift/Events/EventListener.php';
/**
* Sends Messages using the mail() function.
*
* It is advised that users do not use this transport if at all possible
* since a number of plugin features cannot be used in conjunction with this
* transport due to the internal interface in PHP itself.
*
* The level of error reporting with this transport is incredibly weak, again
* due to limitations of PHP's internal mail() function. You'll get an
* all-or-nothing result from sending.
*
* @package Swift
* @subpackage Transport
* @author Chris Corbyn
*/
class Swift_Transport_MailTransport implements Swift_Transport
{
/** Addtional parameters to pass to mail() */
private $_extraParams = '-f%s';
/** The event dispatcher from the plugin API */
private $_eventDispatcher;
/** An invoker that calls the mail() function */
private $_invoker;
/**
* Create a new MailTransport with the $log.
* @param Swift_Transport_Log $log
*/
public function __construct(Swift_Transport_MailInvoker $invoker,
Swift_Events_EventDispatcher $eventDispatcher)
{
$this->_invoker = $invoker;
$this->_eventDispatcher = $eventDispatcher;
}
/**
* Not used.
*/
public function isStarted()
{
return false;
}
/**
* Not used.
*/
public function start()
{
}
/**
* Not used.
*/
public function stop()
{
}
/**
* Set the additional parameters used on the mail() function.
*
* This string is formatted for sprintf() where %s is the sender address.
*
* @param string $params
*/
public function setExtraParams($params)
{
$this->_extraParams = $params;
return $this;
}
/**
* Get the additional parameters used on the mail() function.
*
* This string is formatted for sprintf() where %s is the sender address.
*
* @return string
*/
public function getExtraParams()
{
return $this->_extraParams;
}
/**
* Send the given Message.
*
* Recipient/sender data will be retreived from the Message API.
* The return value is the number of recipients who were accepted for delivery.
*
* @param Swift_Mime_Message $message
* @param string[] &$failedRecipients to collect failures by-reference
* @return int
*/
public function send(Swift_Mime_Message $message, &$failedRecipients = null)
{
$failedRecipients = (array) $failedRecipients;
if ($evt = $this->_eventDispatcher->createSendEvent($this, $message))
{
$this->_eventDispatcher->dispatchEvent($evt, 'beforeSendPerformed');
if ($evt->bubbleCancelled())
{
return 0;
}
}
$count = (
count((array) $message->getTo())
+ count((array) $message->getCc())
+ count((array) $message->getBcc())
);
$toHeader = $message->getHeaders()->get('To');
$subjectHeader = $message->getHeaders()->get('Subject');
$to = $toHeader->getFieldBody();
$subject = $subjectHeader->getFieldBody();
$reversePath = $this->_getReversePath($message);
//Remove headers that would otherwise be duplicated
$message->getHeaders()->remove('To');
$message->getHeaders()->remove('Subject');
$messageStr = $message->toString();
$message->getHeaders()->set($toHeader);
$message->getHeaders()->set($subjectHeader);
//Separate headers from body
if (false !== $endHeaders = strpos($messageStr, "\r\n\r\n"))
{
$headers = substr($messageStr, 0, $endHeaders) . "\r\n"; //Keep last EOL
$body = substr($messageStr, $endHeaders + 4);
}
else
{
$headers = $messageStr . "\r\n";
$body = '';
}
unset($messageStr);
if ("\r\n" != PHP_EOL) //Non-windows (not using SMTP)
{
$headers = str_replace("\r\n", PHP_EOL, $headers);
$body = str_replace("\r\n", PHP_EOL, $body);
}
else //Windows, using SMTP
{
$headers = str_replace("\r\n.", "\r\n..", $headers);
$body = str_replace("\r\n.", "\r\n..", $body);
}
if ($this->_invoker->mail($to, $subject, $body, $headers,
sprintf($this->_extraParams, $reversePath)))
{
if ($evt)
{
$evt->setResult(Swift_Events_SendEvent::RESULT_SUCCESS);
$evt->setFailedRecipients($failedRecipients);
$this->_eventDispatcher->dispatchEvent($evt, 'sendPerformed');
}
}
else
{
$failedRecipients = array_merge(
$failedRecipients,
array_keys((array) $message->getTo()),
array_keys((array) $message->getCc()),
array_keys((array) $message->getBcc())
);
if ($evt)
{
$evt->setResult(Swift_Events_SendEvent::RESULT_FAILED);
$evt->setFailedRecipients($failedRecipients);
$this->_eventDispatcher->dispatchEvent($evt, 'sendPerformed');
}
$message->generateId();
$count = 0;
}
return $count;
}
/**
* Register a plugin.
*
* @param Swift_Events_EventListener $plugin
*/
public function registerPlugin(Swift_Events_EventListener $plugin)
{
$this->_eventDispatcher->bindEventListener($plugin);
}
// -- Private methods
/** Determine the best-use reverse path for this message */
private function _getReversePath(Swift_Mime_Message $message)
{
$return = $message->getReturnPath();
$sender = $message->getSender();
$from = $message->getFrom();
$path = null;
if (!empty($return))
{
$path = $return;
}
elseif (!empty($sender))
{
$keys = array_keys($sender);
$path = array_shift($keys);
}
elseif (!empty($from))
{
$keys = array_keys($from);
$path = array_shift($keys);
}
return $path;
}
}

View File

@@ -0,0 +1,173 @@
<?php
/*
* This file is part of SwiftMailer.
* (c) 2004-2009 Chris Corbyn
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
//@require 'Swift/Transport/EsmtpTransport.php';
//@require 'Swift/Transport/IoBuffer.php';
//@require 'Swift/Transport/Log.php';
//@require 'Swift/Events/EventDispatcher.php';
/**
* SendmailTransport for sending mail through a sendmail/postfix (etc..) binary.
*
* Supported modes are -bs and -t, with any additional flags desired.
* It is advised to use -bs mode since error reporting with -t mode is not
* possible.
*
* @package Swift
* @subpackage Transport
* @author Chris Corbyn
*/
class Swift_Transport_SendmailTransport
extends Swift_Transport_AbstractSmtpTransport
{
/**
* Connection buffer parameters.
* @var array
* @access protected
*/
private $_params = array(
'timeout' => 30,
'blocking' => 1,
'command' => '/usr/sbin/sendmail -bs',
'type' => Swift_Transport_IoBuffer::TYPE_PROCESS
);
/**
* Create a new SendmailTransport with $buf for I/O.
* @param Swift_Transport_IoBuffer $buf
* @param Swift_Events_EventDispatcher $dispatcher
*/
public function __construct(Swift_Transport_IoBuffer $buf,
Swift_Events_EventDispatcher $dispatcher)
{
parent::__construct($buf, $dispatcher);
}
/**
* Start the standalone SMTP session if running in -bs mode.
*/
public function start()
{
if (false !== strpos($this->getCommand(), ' -bs'))
{
parent::start();
}
}
/**
* Set the command to invoke.
* If using -t mode you are strongly advised to include -oi or -i in the
* flags. For example: /usr/sbin/sendmail -oi -t
* Swift will append a -f<sender> flag if one is not present.
* The recommended mode is "-bs" since it is interactive and failure notifications
* are hence possible.
* @param string $command
*/
public function setCommand($command)
{
$this->_params['command'] = $command;
return $this;
}
/**
* Get the sendmail command which will be invoked.
* @return string
*/
public function getCommand()
{
return $this->_params['command'];
}
/**
* Send the given Message.
* Recipient/sender data will be retreived from the Message API.
* The return value is the number of recipients who were accepted for delivery.
* NOTE: If using 'sendmail -t' you will not be aware of any failures until
* they bounce (i.e. send() will always return 100% success).
* @param Swift_Mime_Message $message
* @param string[] &$failedRecipients to collect failures by-reference
* @return int
*/
public function send(Swift_Mime_Message $message, &$failedRecipients = null)
{
$failedRecipients = (array) $failedRecipients;
$command = $this->getCommand();
$buffer = $this->getBuffer();
if (false !== strpos($command, ' -t'))
{
if ($evt = $this->_eventDispatcher->createSendEvent($this, $message))
{
$this->_eventDispatcher->dispatchEvent($evt, 'beforeSendPerformed');
if ($evt->bubbleCancelled())
{
return 0;
}
}
if (false === strpos($command, ' -f'))
{
$command .= ' -f' . $this->_getReversePath($message);
}
$buffer->initialize(array_merge($this->_params, array('command' => $command)));
if (false === strpos($command, ' -i') && false === strpos($command, ' -oi'))
{
$buffer->setWriteTranslations(array("\r\n" => "\n", "\n." => "\n.."));
}
else
{
$buffer->setWriteTranslations(array("\r\n"=>"\n"));
}
$count = count((array) $message->getTo())
+ count((array) $message->getCc())
+ count((array) $message->getBcc())
;
$message->toByteStream($buffer);
$buffer->flushBuffers();
$buffer->setWriteTranslations(array());
$buffer->terminate();
if ($evt)
{
$evt->setResult(Swift_Events_SendEvent::RESULT_SUCCESS);
$evt->setFailedRecipients($failedRecipients);
$this->_eventDispatcher->dispatchEvent($evt, 'sendPerformed');
}
$message->generateId();
}
elseif (false !== strpos($command, ' -bs'))
{
$count = parent::send($message, $failedRecipients);
}
else
{
$this->_throwException(new Swift_TransportException(
'Unsupported sendmail command flags [' . $command . ']. ' .
'Must be one of "-bs" or "-t" but can include additional flags.'
));
}
return $count;
}
// -- Protected methods
/** Get the params to initialize the buffer */
protected function _getBufferParams()
{
return $this->_params;
}
}

View File

@@ -0,0 +1,58 @@
<?php
/*
Invokes the mail() function in Swift Mailer.
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
//@require 'Swift/Transport/MailInvoker.php';
/**
* This is the implementation class for {@link Swift_Transport_MailInvoker}.
*
* @package Swift
* @subpackage Transport
* @author Chris Corbyn
*/
class Swift_Transport_SimpleMailInvoker implements Swift_Transport_MailInvoker
{
/**
* Send mail via the mail() function.
*
* This method takes the same arguments as PHP mail().
*
* @param string $to
* @param string $subject
* @param string $body
* @param string $headers
* @param string $extraParams
*
* @return boolean
*/
public function mail($to, $subject, $body, $headers = null, $extraParams = null)
{
if (!ini_get('safe_mode'))
{
return mail($to, $subject, $body, $headers, $extraParams);
}
else
{
return mail($to, $subject, $body, $headers);
}
}
}

View File

@@ -0,0 +1,36 @@
<?php
/*
* This file is part of SwiftMailer.
* (c) 2004-2009 Chris Corbyn
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
/**
* Wraps an IoBuffer to send/receive SMTP commands/responses.
* @package Swift
* @subpackage Transport
* @author Chris Corbyn
*/
interface Swift_Transport_SmtpAgent
{
/**
* Get the IoBuffer where read/writes are occurring.
* @return Swift_Transport_IoBuffer
*/
public function getBuffer();
/**
* Run a command against the buffer, expecting the given response codes.
* If no response codes are given, the response will not be validated.
* If codes are given, an exception will be thrown on an invalid response.
* @param string $command
* @param int[] $codes
* @param string[] &$failures
*/
public function executeCommand($command, $codes = array(), &$failures = null);
}

View File

@@ -0,0 +1,276 @@
<?php
/*
* This file is part of SwiftMailer.
* (c) 2004-2009 Chris Corbyn
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
//@require 'Swift/ByteStream/AbstractFilterableInputStream.php';
//@require 'Swift/ReplacementFilterFactory.php';
//@require 'Swift/Transport/IoBuffer.php';
//@require 'Swift/TransportException.php';
/**
* A generic IoBuffer implementation supporting remote sockets and local processes.
* @package Swift
* @subpackage Transport
* @author Chris Corbyn
*/
class Swift_Transport_StreamBuffer
extends Swift_ByteStream_AbstractFilterableInputStream
implements Swift_Transport_IoBuffer
{
/** A primary socket */
private $_stream;
/** The input stream */
private $_in;
/** The output stream */
private $_out;
/** Buffer initialization parameters */
private $_params = array();
/** The ReplacementFilterFactory */
private $_replacementFactory;
/** Translations performed on data being streamed into the buffer */
private $_translations = array();
/**
* Create a new StreamBuffer using $replacementFactory for transformations.
* @param Swift_ReplacementFilterFactory $replacementFactory
*/
public function __construct(
Swift_ReplacementFilterFactory $replacementFactory)
{
$this->_replacementFactory = $replacementFactory;
}
/**
* Perform any initialization needed, using the given $params.
* Parameters will vary depending upon the type of IoBuffer used.
* @param array $params
*/
public function initialize(array $params)
{
$this->_params = $params;
switch ($params['type'])
{
case self::TYPE_PROCESS:
$this->_establishProcessConnection();
break;
case self::TYPE_SOCKET:
default:
$this->_establishSocketConnection();
break;
}
}
/**
* Set an individual param on the buffer (e.g. switching to SSL).
* @param string $param
* @param mixed $value
*/
public function setParam($param, $value)
{
if (isset($this->_stream))
{
switch ($param)
{
case 'protocol':
if (!array_key_exists('protocol', $this->_params)
|| $value != $this->_params['protocol'])
{
if ('tls' == $value)
{
stream_socket_enable_crypto(
$this->_stream, true, STREAM_CRYPTO_METHOD_TLS_CLIENT
);
}
}
break;
}
}
$this->_params[$param] = $value;
}
/**
* Perform any shutdown logic needed.
*/
public function terminate()
{
if (isset($this->_stream))
{
switch ($this->_params['type'])
{
case self::TYPE_PROCESS:
fclose($this->_in);
fclose($this->_out);
proc_close($this->_stream);
break;
case self::TYPE_SOCKET:
default:
fclose($this->_stream);
break;
}
}
$this->_stream = null;
$this->_out = null;
$this->_in = null;
}
/**
* Set an array of string replacements which should be made on data written
* to the buffer. This could replace LF with CRLF for example.
* @param string[] $replacements
*/
public function setWriteTranslations(array $replacements)
{
foreach ($this->_translations as $search => $replace)
{
if (!isset($replacements[$search]))
{
$this->removeFilter($search);
unset($this->_translations[$search]);
}
}
foreach ($replacements as $search => $replace)
{
if (!isset($this->_translations[$search]))
{
$this->addFilter(
$this->_replacementFactory->createFilter($search, $replace), $search
);
$this->_translations[$search] = true;
}
}
}
/**
* Get a line of output (including any CRLF).
* The $sequence number comes from any writes and may or may not be used
* depending upon the implementation.
* @param int $sequence of last write to scan from
* @return string
*/
public function readLine($sequence)
{
if (isset($this->_out) && !feof($this->_out))
{
$line = fgets($this->_out);
return $line;
}
}
/**
* Reads $length bytes from the stream into a string and moves the pointer
* through the stream by $length. If less bytes exist than are requested the
* remaining bytes are given instead. If no bytes are remaining at all, boolean
* false is returned.
* @param int $length
* @return string
*/
public function read($length)
{
if (isset($this->_out) && !feof($this->_out))
{
$ret = fread($this->_out, $length);
return $ret;
}
}
/** Not implemented */
public function setReadPointer($byteOffset)
{
}
// -- Protected methods
/** Flush the stream contents */
protected function _flush()
{
if (isset($this->_in))
{
fflush($this->_in);
}
}
/** Write this bytes to the stream */
protected function _commit($bytes)
{
if (isset($this->_in)
&& fwrite($this->_in, $bytes))
{
return ++$this->_sequence;
}
}
// -- Private methods
/**
* Establishes a connection to a remote server.
* @access private
*/
private function _establishSocketConnection()
{
$host = $this->_params['host'];
if (!empty($this->_params['protocol']))
{
$host = $this->_params['protocol'] . '://' . $host;
}
$timeout = 15;
if (!empty($this->_params['timeout']))
{
$timeout = $this->_params['timeout'];
}
if (!$this->_stream = fsockopen($host, $this->_params['port'], $errno, $errstr, $timeout))
{
throw new Swift_TransportException(
'Connection could not be established with host ' . $this->_params['host'] .
' [' . $errstr . ' #' . $errno . ']'
);
}
if (!empty($this->_params['blocking']))
{
stream_set_blocking($this->_stream, 1);
}
else
{
stream_set_blocking($this->_stream, 0);
}
$this->_in =& $this->_stream;
$this->_out =& $this->_stream;
}
/**
* Opens a process for input/output.
* @access private
*/
private function _establishProcessConnection()
{
$command = $this->_params['command'];
$descriptorSpec = array(
0 => array('pipe', 'r'),
1 => array('pipe', 'w'),
2 => array('pipe', 'w')
);
$this->_stream = proc_open($command, $descriptorSpec, $pipes);
stream_set_blocking($pipes[2], 0);
if ($err = stream_get_contents($pipes[2]))
{
throw new Swift_TransportException(
'Process could not be started [' . $err . ']'
);
}
$this->_in =& $pipes[0];
$this->_out =& $pipes[1];
}
}