* @version $Id$ */ namespace EGroupware\Api; use Horde_Mime_Mail; use Horde_Mime_Part; use Horde_Mail_Rfc822_List; use Horde_Mail_Exception; use Horde_Mail_Transport; use Horde_Mail_Transport_Null; use Horde_Mime_Headers_MessageId; use Horde_Text_Flowed; use Horde_Stream; use Horde_Stream_Wrapper_Combine; use Horde_Mime_Headers; /** * Sending mail via Horde_Mime_Mail * * Log mails to log file specified in $GLOBALS['egw_info']['server']['log_mail'] * or regular error_log for true (can be set either in DB or header.inc.php). */ class Mailer extends Horde_Mime_Mail { /** * Mail account used for sending mail * * @var Mail\Account */ protected $account; /** * Header / recipients set via Add(Address|Cc|Bcc|Replyto) * * @var Horde_Mail_Rfc822_List */ protected $to; protected $cc; protected $bcc; protected $replyto; /** * Translates between interal Horde_Mail_Rfc822_List attributes and header names * * @var array */ static $type2header = array( 'to' => 'To', 'cc' => 'Cc', 'bcc' => 'Bcc', 'replyto' => 'Reply-To', ); /** * Constructor: always throw exceptions instead of echoing errors and EGw pathes * * @param int|Mail\Account|boolean $account =null mail account to use, default use Mail\Account::get_default($smtp=true) * false: no NOT initialise account and set other EGroupware specific headers, used to parse mails (not sending them!) */ function __construct($account=null) { // Horde use locale for translation of error messages Preferences::setlocale(LC_MESSAGES); parent::__construct(); if ($account !== false) { $this->_headers->setUserAgent('EGroupware API '.$GLOBALS['egw_info']['server']['versions']['phpgwapi']); $this->setAccount($account); $this->is_html = false; $this->clearAllRecipients(); $this->clearReplyTos(); $this->clearParts(); } } /** * Clear all recipients: to, cc, bcc (but NOT reply-to!) */ function clearAllRecipients() { // clear all addresses $this->clearAddresses(); $this->clearCCs(); $this->clearBCCs(); } /** * Set mail account to use for sending * * @param int|Mail\Account $account =null mail account to use, default use Mail\Account::get_default($smtp=true) * @throws Exception\NotFound if account was not found (or not valid for current user) */ function setAccount($account=null) { if (is_a($account, 'Mail\Account')) { $this->account = $account; } elseif ($account > 0) { $this->account = Mail\Account::read($account); } else { if (!($this->account = Mail\Account::get_default(true))) // true = need an SMTP (not just IMAP) account { throw new Exception\NotFound('SMTP: '.lang('Account not found!')); } } try { $identity = Mail\Account::read_identity($this->account->ident_id, true, null, $this->account); } catch(Exception $e) { unset($e); error_log(__METHOD__.__LINE__.' Could not read_identity for account:'.$account['acc_id'].' with IdentID:'.$account['ident_id']); $identity['ident_email'] = $this->account->ident_email; $identity['ident_realname'] = $this->account->ident_realname ? $this->account->ident_realname : $this->account->ident_email; } // use smpt-username as sender/return-path, if available, but only if it is a full email address $sender = $this->account->acc_smtp_username && strpos($this->account->acc_smtp_username, '@') !== false ? $this->account->acc_smtp_username : $identity['ident_email']; $this->addHeader('Return-Path', '<'.$sender.'>', true); $this->setFrom($identity['ident_email'], $identity['ident_realname']); } /** * Set From header * * @param string $address * @param string $personal ='' */ public function setFrom($address, $personal='') { $this->addHeader('From', self::add_personal($address, $personal)); } /** * Add one or multiple addresses to To, Cc, Bcc or Reply-To * * @param string|array|Horde_Mail_Rfc822_List $address * @param string $personal ='' only used if $address is a string * @param string $type ='to' type of address to add "to", "cc", "bcc" or "replyto" */ function addAddress($address, $personal='', $type='to') { if (!isset(self::$type2header[$type])) { throw new Exception\WrongParameter("Unknown type '$type'!"); } if ($personal) $address = self::add_personal ($address, $personal); // add to our local list $this->$type->add($address); // add as header $this->addHeader(self::$type2header[$type], $this->$type, true); } /** * Remove all addresses from To, Cc, Bcc or Reply-To * * @param string $type ='to' type of address to add "to", "cc", "bcc" or "replyto" */ function clearAddresses($type='to') { $this->$type = new Horde_Mail_Rfc822_List(); $this->removeHeader(self::$type2header[$type]); } /** * Get set to addressses * * @param string $type ='to' type of address to add "to", "cc", "bcc" or "replyto" * @param boolean $return_array =false true: return array of string, false: Horde_Mail_Rfc822_List * @return array|Horde_Mail_Rfc822_List supporting arrayAccess and Iterable */ function getAddresses($type='to', $return_array=false) { if ($return_array) { $addresses = array(); foreach($this->$type as $addr) { $addresses[] = (string)$addr; } return $addresses; } return $this->$type; } /** * Write Bcc as header for storing in sent or as draft * * Bcc is normally only add to recipients while sending, but not added visible as header. * * This function is should only be called AFTER calling send, or when NOT calling send at all! */ function forceBccHeader() { $this->_headers->removeHeader('Bcc'); // only add Bcc header, if we have bcc's if (count($this->bcc)) { $this->_headers->addHeader('Bcc', $this->bcc); } } /** * Add personal part to email address * * @param string $address * @param string $personal * @return string Rfc822 address */ static function add_personal($address, $personal) { if (is_string($address) && !empty($personal)) { //if (!preg_match('/^[!#$%&\'*+/0-9=?A-Z^_`a-z{|}~-]+$/u', $personal)) // that's how I read the rfc(2)822 if ($personal && !preg_match('/^[0-9A-Z -]*$/iu', $personal)) // but quoting is never wrong, so quote more then necessary { $personal = '"'.str_replace(array('\\', '"'),array('\\\\', '\\"'), $personal).'"'; } $address = ($personal ? $personal.' <' : '').$address.($personal ? '>' : ''); } return $address; } /** * Add one or multiple addresses to Cc * * @param string|array|Horde_Mail_Rfc822_List $address * @param string $personal ='' only used if $address is a string */ function addCc($address, $personal=null) { $this->addAddress($address, $personal, 'cc'); } /** * Clear all cc */ function clearCCs() { $this->clearAddresses('cc'); } /** * Add one or multiple addresses to Bcc * * @param string|array|Horde_Mail_Rfc822_List $address * @param string $personal ='' only used if $address is a string */ function addBcc($address, $personal=null) { $this->addAddress($address, $personal, 'bcc'); } /** * Clear all bcc */ function clearBCCs() { $this->clearAddresses('bcc'); } /** * Add one or multiple addresses to Reply-To * * @param string|array|Horde_Mail_Rfc822_List $address * @param string $personal ='' only used if $address is a string */ function addReplyTo($address, $personal=null) { $this->addAddress($address, $personal, 'replyto'); } /** * Clear all reply-to */ function clearReplyTos() { $this->clearAddresses('replyto'); } /** * Get set ReplyTo addressses * * @return Horde_Mail_Rfc822_List supporting arrayAccess and Iterable */ function getReplyTo() { return $this->replyto; } /** * Adds an attachment * * "text/calendar; method=..." get automatic detected and added as highest priority alternative * * @param string|resource $data Path to the attachment or open file-descriptor * @param string $name The file name to use for the attachment. * @param string $type The content type of the file. * @param string $charset The character set of the part, only relevant for text parts. * @return integer part-number * @throws Exception\NotFound if $file could not be opened for reading */ public function addAttachment($data, $name = null, $type = null, $charset = 'us-ascii') { // deprecated PHPMailer::AddAttachment($path, $name = '', $encoding = 'base64', $type = 'application/octet-stream') call if ($type === 'base64') { $type = $charset; $charset = 'us-ascii'; } // pass file as resource to Horde_Mime_Part::setContent() if (is_resource($data)) { $resource = $data; } elseif (!($resource = fopen($data, 'r'))) { throw new Exception\NotFound("File '$data' not found!"); } if (empty($type) && !is_resource($data)) $type = Vfs::mime_content_type($data); // set "text/calendar; method=*" as alternativ body $matches = null; if (preg_match('|^text/calendar; method=([^;]+)|i', $type, $matches)) { $this->setAlternativBody($resource, $type, array('method' => $matches[1]), 'utf-8'); return; } $part = new Horde_Mime_Part(); $part->setType($type); $part->setContents($resource); // setting name, also sets content-disposition attachment (!), therefore we have to do it after "text/calendar; method=" handling if ($name || !is_resource($data)) $part->setName($name ? $name : Vfs::basename($data)); // this should not be necessary, because binary data get detected by mime-type, // but at least Cyrus complains about NUL characters $part->setTransferEncoding('base64', array('send' => true)); $part->setDisposition('attachment'); return $this->addMimePart($part); } /** * Adds an embedded image or other inline attachment * * @param string|resource $data Path to the attachment or open file-descriptor * @param string $cid Content ID of the attachment. Use this to identify * the Id for accessing the image in an HTML form. * @param string $name Overrides the attachment name. * @param string $type File extension (MIME) type. * @return integer part-number */ public function addEmbeddedImage($data, $cid, $name = '', $type = 'application/octet-stream') { // deprecated PHPMailer::AddEmbeddedImage($path, $cid, $name='', $encoding='base64', $type='application/octet-stream') call if ($type === 'base64' || func_num_args() == 5) { $type = func_get_arg(4); } $part_id = $this->addAttachment($data, $name, $type); //error_log(__METHOD__."(".array2string($data).", '$cid', '$name', '$type') added with (temp.) part_id=$part_id"); $part = $this->_parts[$part_id]; $part->setDisposition('inline'); $part->setContentId($cid); return $part_id; } /** * Adds a string or binary attachment (non-filesystem) to the list. * * "text/calendar; method=..." get automatic detected and added as highest priority alternative, * overwriting evtl. existing html body! * * @param string|resource $content String attachment data or open file descriptor * @param string $filename Name of the attachment. We assume that this is NOT a path * @param string $type File extension (MIME) type. * @return int part-number */ public function addStringAttachment($content, $filename, $type = 'application/octet-stream') { // deprecated PHPMailer::AddStringAttachment($content, $filename = '', $encoding = 'base64', $type = 'application/octet-stream') call if ($type === 'base64' || func_num_args() == 4) { $type = func_get_arg(3); } // set "text/calendar; method=*" as alternativ body $matches = null; if (preg_match('|^text/calendar; method=([^;]+)|i', $type, $matches)) { $this->setAlternativBody($content, $type, array('method' => $matches[1]), 'utf-8'); return; } $part = new Horde_Mime_Part(); $part->setType($type); $part->setCharset('utf-8'); $part->setContents($content); // this should not be necessary, because binary data get detected by mime-type, // but at least Cyrus complains about NUL characters $part->setTransferEncoding('base64', array('send' => true)); $part->setName($filename); $part->setDisposition('attachment'); return $this->addMimePart($part); } /** * Highest/last alternativ body part. * * @var Horde_Mime_Part */ protected $_alternativBody; /** * Sets an alternativ body, eg. text/calendar has highest / last alternativ * * @param string|resource $content * @param string $type eg. "text/calendar" * @param array $parameters =array() eg. array('method' => 'REQUEST') * @param string $charset =null default to $this->_charset="utf-8" */ function setAlternativBody($content, $type, $parameters=array(), $charset=null) { $this->_alternativBody = new Horde_Mime_Part(); $this->_alternativBody->setType($type); foreach($parameters as $label => $data) { $this->_alternativBody->setContentTypeParameter($label, $data); } $this->_alternativBody->setCharset($charset ? $charset : $this->_charset); $this->_alternativBody->setContents($content); $this->_base = null; } /** * Send mail, injecting mail transport from account * * Log mails to log file specified in $GLOBALS['egw_info']['server']['log_mail'] * or regular error_log for true (can be set either in DB or header.inc.php). * * @param Horde_Mail_Transport $transport =null using transport from mail-account * specified in construct, or default one, if not specified * @param boolean $resend =true allways true in EGroupware! * @param boolean $flowed =null send message in flowed text format, * default null used flowed by default for everything but multipart/encrypted, * unless disabled in site configuration ("disable_rfc3676_flowed") * * @throws Exception\NotFound for no smtp account available * @throws Horde_Mime_Exception */ function send(Horde_Mail_Transport $transport=null, $resend=true, $flowed=null) { unset($resend); // parameter is not used, but required by function signature if (!($message_id = $this->getHeader('Message-ID')) && class_exists('Horde_Mime_Headers_MessageId')) // since 2.5.0 { $message_id = Horde_Mime_Headers_MessageId::create('EGroupware'); $this->addHeader('Message-ID', $message_id); } $body_sha1 = null; // skip sha1, it requires whole mail in memory, which we traing to avoid now $mail_id = $GLOBALS['egw']->hooks->process(array( 'location' => 'send_mail', 'subject' => $subject=$this->getHeader('Subject'), 'from' => $this->getHeader('Return-Path') ? $this->getHeader('Return-Path') : $this->getHeader('From'), 'to' => $to=$this->getAddresses('to', true), 'cc' => $cc=$this->getAddresses('cc', true), 'bcc' => $bcc=$this->getAddresses('bcc', true), 'body_sha1' => $body_sha1, 'message_id' => (string)$message_id, ), array(), true); // true = call all apps // check if we are sending an html mail with inline images if (!empty($this->_htmlBody) && count($this->_parts)) { $related = null; foreach($this->_parts as $n => $part) { if ($part->getDisposition() == 'inline' && $part->getContentId()) { // we need to send a multipart/related with html-body as first part and inline images as further parts if (!isset($related)) { $related = new Horde_Mime_Part(); $related->setType('multipart/related'); $related[] = $this->_htmlBody; $this->_htmlBody = $related; } $related[] = $part; unset($this->_parts[$n]); } } } try { // no flowed for encrypted messages if (!isset($flowed)) $flowed = $this->_body && $this->_body->getType() != 'multipart/encrypted'; // check if flowed is disabled in mail site configuration if (($config = config::read('mail')) && $config['disable_rfc3676_flowed']) { $flowed = false; } // handling of alternativ body if (!empty($this->_alternativBody)) { $body = new Horde_Mime_Part(); $body->setType('multipart/alternative'); if (!empty($this->_body)) { // Send in flowed format. if ($flowed) { $text_flowed = new Horde_Text_Flowed($this->_body->getContents(), $this->_body->getCharset()); $text_flowed->setDelSp(true); $this->_body->setContentTypeParameter('format', 'flowed'); $this->_body->setContentTypeParameter('DelSp', 'Yes'); $this->_body->setContents($text_flowed->toFlowed()); } $body[] = $this->_body; } if (!empty($this->_htmlBody)) { $body[] = $this->_htmlBody; unset($this->_htmlBody); } $body[] = $this->_alternativBody; unset($this->_alternativBody); $this->_body = $body; $flowed = false; } parent::send($transport ? $transport : $this->account->smtpTransport(), true, $flowed); // true: keep Message-ID } catch (\Exception $e) { // in case of errors/exceptions call hook again with previous returned mail_id and error-message to log $GLOBALS['egw']->hooks->process(array( 'location' => 'send_mail', 'subject' => $subject, 'from' => $this->getHeader('Return-Path') ? $this->getHeader('Return-Path') : $this->getHeader('From'), 'to' => $to, 'cc' => $cc, 'bcc' => $bcc, 'body_sha1' => $body_sha1, 'message_id' => (string)$message_id, 'mail_id' => $mail_id, 'error' => $e->getMessage(), ), array(), true); // true = call all apps } // log mails to file specified in $GLOBALS['egw_info']['server']['log_mail'] or error_log for true if ($GLOBALS['egw_info']['server']['log_mail']) { $msg = $GLOBALS['egw_info']['server']['log_mail'] !== true ? date('Y-m-d H:i:s')."\n" : ''; $msg .= (isset($e) ? 'Mail send' : 'Mail NOT send'). ' to '.implode(', ', $to).' with subject: "'.$subject.'"'; $msg .= ' from instance '.$GLOBALS['egw_info']['user']['domain'].' and IP '.Session::getuser_ip(); $msg .= ' from user #'.$GLOBALS['egw_info']['user']['account_id']; if ($GLOBALS['egw_info']['user']['account_id'] && class_exists(__NAMESPACE__.'\\Accounts',false)) { $msg .= ' ('.Accounts::username($GLOBALS['egw_info']['user']['account_id']).')'; } if (isset($e)) { $msg .= $GLOBALS['egw_info']['server']['log_mail'] !== true ? "\n" : ': '; $msg .= 'ERROR '.$e->getMessage(); } $msg .= ' cc='.implode(', ', $cc).', bcc='.implode(', ', $bcc); if ($GLOBALS['egw_info']['server']['log_mail'] !== true) $msg .= "\n\n"; error_log($msg,$GLOBALS['egw_info']['server']['log_mail'] === true ? 0 : 3, $GLOBALS['egw_info']['server']['log_mail']); } // rethrow error if (isset($e)) throw $e; } /** * Reset all Settings to send multiple Messages */ function clearAll() { $this->__construct($this->account); } /** * Get value of a header set with addHeader() * * @param string $header * @return string|array */ function getHeader($header) { return $this->_headers ? $this->_headers->getValue($header) : null; } /** * Get the raw email data sent by this object. * * Reimplement to be able to call it for saveAsDraft by calling * $this->send(new Horde_Mail_Transport_Null()), * if no base-part is set, because send is not called before. * * @param boolean $stream If true, return a stream resource, otherwise * @return stream|string The raw email data. */ function getRaw($stream=true) { try { $this->getBasePart(); } catch(Horde_Mail_Exception $e) { unset($e); parent::send(new Horde_Mail_Transport_Null(), true); // true: keep Message-ID } // code copied from Horde_Mime_Mail::getRaw(), as there is no way to inject charset in // _headers->toString(), which is required to encode headers containing non-ascii chars correct if ($stream) { $hdr = new Horde_Stream(); $hdr->add($this->_headers->toString(array('charset' => 'utf-8', 'canonical' => true)), true); return Horde_Stream_Wrapper_Combine::getStream( array($hdr->stream, $this->getBasePart()->toString( array('stream' => true, 'canonical' => true, 'encode' => Horde_Mime_Part::ENCODE_7BIT | Horde_Mime_Part::ENCODE_8BIT | Horde_Mime_Part::ENCODE_BINARY)) ) ); } return $this->_headers->toString(array('charset' => 'utf-8', 'canonical' => true)) . $this->getBasePart()->toString(array('canonical' => true)); } /** * Convert charset of text-parts of message to utf-8 * * @param string|resource $message * @param boolean $stream =false return stream or string (default) * @param string $charset ='utf-8' charset to convert to * @param boolean &$converted =false on return if conversation was necessary * @return string|stream */ static function convert($message, $stream=false, $charset='utf-8', &$converted=false) { $mailer = new Mailer(false); // false = no default headers and mail account $mailer->addHeaders(Horde_Mime_Headers::parseHeaders($message)); $base = Horde_Mime_Part::parseMessage($message); foreach($base->partIterator() as $part) { if ($part->getPrimaryType()== 'text') { $charset = $part->getContentTypeParameter('charset'); if ($charset && $charset != 'utf-8') { $content = Translation::convert($part->toString(array( 'encode' => Horde_Mime_Part::ENCODE_BINARY, // otherwise we cant recode charset )), $charset, 'utf-8'); $part->setContents($content, array( 'encode' => Horde_Mime_Part::ENCODE_BINARY, // $content is NOT encoded )); $part->setContentTypeParameter('charset', 'utf-8'); if ($part === $base) { $mailer->addHeader('Content-Type', $part->getType(true)); // need to set Transfer-Encoding used by base-part, it always seems to be "quoted-printable" $mailer->addHeader('Content-Transfer-Encoding', 'quoted-printable'); } $converted = true; } } elseif ($part->getType() == 'message/rfc822') { $part->setContents(self::convert($part->toString(), $stream, $charset, $converted)); } } if ($converted) { $mailer->setBasePart($base); return $mailer->getRaw($stream); } return $message; } /** * Find body: 1. part with mimetype "text/$subtype" * * Use getContents() on non-null return-value to get string content * * @param string $subtype =null * @return Horde_Mime_Part part with body or null */ function findBody($subtype=null) { try { $base = $this->getBasePart(); if (!($part_id = $base->findBody($subtype))) return null; return $base->getPart($part_id); } catch (Exception $e) { unset($e); return $subtype == 'html' ? $this->_htmlBody : $this->_body; } } /** * Parse base-part into _body, _htmlBody, _alternativBody and _parts to eg. add further attachments */ function parseBasePart() { try { $base = $this->getBasePart(); $plain_id = $base->findBody('plain'); $html_id = $base->findBody('html'); // find further alternativ part if ($base->getType() == 'multipart/alternativ' && count($base) !== ($html_id ? $html_id : $plain_id)) { $alternativ_id = (string)count($base); } $this->_body = $this->_htmlBody = $this->_alternativBody = null; $this->clearParts(); foreach($base->partIterator() as $part) { $id = $part->getMimeId(); //error_log(__METHOD__."() plain=$plain_id, html=$html_id: $id: ".$part->getType()); switch($id) { case '0': // base-part itself continue 2; case $plain_id: $this->_body = $part; break; case $html_id: $this->_htmlBody = $part; break; case $alternativ_id: $this->_alternativBody = $part; break; default: $this->_parts[] = $part; } } $this->setBasePart(null); } catch (\Exception $e) { // ignore that there is no base-part yet, so nothing to do unset($e); } } /** * Adds a MIME message part. * * Reimplemented to add parts / attachments if message was parsed / already has a base-part * * @param Horde_Mime_Part $part A Horde_Mime_Part object. * @return integer The part number. */ public function addMimePart($part) { if ($this->_base) $this->parseBasePart(); return parent::addMimePart($part); } /** * Sets OpenPGP encrypted body according to rfc3156, section 4 * * @param string $body The message content. * @link https://tools.ietf.org/html/rfc3156#section-4 */ public function setOpenPgpBody($body) { $this->_body = new Horde_Mime_Part(); $this->_body->setType('multipart/encrypted'); $this->_body->setContentTypeParameter('protocol', 'application/pgp-encrypted'); $this->_body->setContents(''); $part1 = new Horde_Mime_Part(); $part1->setType('application/pgp-encrypted'); $part1->setContents("Version: 1\r\n", array('encoding' => '7bit')); $this->_body->addPart($part1); $part2 = new Horde_Mime_Part(); $part2->setType('application/octet-stream'); $part2->setContents($body, array('encoding' => '7bit')); $this->_body->addPart($part2); $this->_base = null; } /** * Clear all non-standard headers * * Used in merge-print to remove headers before sending "new" mail */ function clearCustomHeaders() { foreach($this->_headers->toArray() as $header => $value) { if (stripos($header, 'x-') === 0 || $header == 'Received') { $this->_headers->removeHeader($header); } unset($value); } } }