| | |
| | | +-----------------------------------------------------------------------+ |
| | | | program/include/rcube_message.php | |
| | | | | |
| | | | This file is part of the RoundCube Webmail client | |
| | | | Copyright (C) 2008-2010, RoundCube Dev. - Switzerland | |
| | | | This file is part of the Roundcube Webmail client | |
| | | | Copyright (C) 2008-2010, Roundcube Dev. - Switzerland | |
| | | | Licensed under the GNU GPL | |
| | | | | |
| | | | PURPOSE: | |
| | |
| | | */ |
| | | class rcube_message |
| | | { |
| | | /** |
| | | * Instace of rcmail. |
| | | * |
| | | * @var rcmail |
| | | */ |
| | | private $app; |
| | | |
| | | /** |
| | | * Instance of imap class |
| | | * |
| | | * @var rcube_imap |
| | | */ |
| | | private $imap; |
| | | private $opt = array(); |
| | | private $inline_parts = array(); |
| | |
| | | { |
| | | $this->app = rcmail::get_instance(); |
| | | $this->imap = $this->app->imap; |
| | | $this->imap->get_all_headers = true; |
| | | |
| | | $this->uid = $uid; |
| | | $this->headers = $this->imap->get_headers($uid, NULL, true, true); |
| | |
| | | /** |
| | | * Return a (decoded) message header |
| | | * |
| | | * @param string Header name |
| | | * @param bool Don't mime-decode the value |
| | | * @param string $name Header name |
| | | * @param bool $row Don't mime-decode the value |
| | | * @return string Header value |
| | | */ |
| | | public function get_header($name, $raw = false) |
| | | { |
| | | $value = $this->headers->$name; |
| | | if ($this->headers->$name) |
| | | $value = $this->headers->$name; |
| | | else if ($this->headers->others[$name]) |
| | | $value = $this->headers->others[$name]; |
| | | |
| | | return $raw ? $value : $this->imap->decode_header($value); |
| | | } |
| | | |
| | |
| | | /** |
| | | * Set is_safe var and session data |
| | | * |
| | | * @param bool enable/disable |
| | | * @param bool $safe enable/disable |
| | | */ |
| | | public function set_safe($safe = true) |
| | | { |
| | |
| | | /** |
| | | * Compose a valid URL for getting a message part |
| | | * |
| | | * @param string Part MIME-ID |
| | | * @param string $mime_id Part MIME-ID |
| | | * @return string URL or false if part does not exist |
| | | */ |
| | | public function get_part_url($mime_id) |
| | |
| | | /** |
| | | * Get content of a specific part of this message |
| | | * |
| | | * @param string Part MIME-ID |
| | | * @param resource File pointer to save the message part |
| | | * @param string $mime_id Part MIME-ID |
| | | * @param resource $fp File pointer to save the message part |
| | | * @return string Part content |
| | | */ |
| | | public function get_part_content($mime_id, $fp=NULL) |
| | |
| | | /** |
| | | * Return the first text part of this message |
| | | * |
| | | * @param rcube_message_part $part Reference to the part if found |
| | | * @return string Plain text message/part content |
| | | */ |
| | | function first_text_part() |
| | | function first_text_part(&$part=null) |
| | | { |
| | | // no message structure, return complete body |
| | | if (empty($this->parts)) |
| | | return $this->body; |
| | | |
| | | $out = null; |
| | | |
| | | // check all message parts |
| | | foreach ($this->mime_parts as $mime_id => $part) { |
| | | $mimetype = $part->ctype_primary . '/' . $part->ctype_secondary; |
| | | |
| | | if ($mimetype == 'text/plain') { |
| | | $out = $this->imap->get_message_part($this->uid, $mime_id, $part); |
| | | |
| | | // re-format format=flowed content |
| | | if ($part->ctype_secondary == 'plain' && $part->ctype_parameters['format'] == 'flowed') |
| | | $out = self::unfold_flowed($out); |
| | | break; |
| | | return $this->imap->get_message_part($this->uid, $mime_id, $part); |
| | | } |
| | | else if ($mimetype == 'text/html') { |
| | | $html_part = $this->imap->get_message_part($this->uid, $mime_id, $part); |
| | | $out = $this->imap->get_message_part($this->uid, $mime_id, $part); |
| | | |
| | | // remove special chars encoding |
| | | $trans = array_flip(get_html_translation_table(HTML_ENTITIES)); |
| | | $html_part = strtr($html_part, $trans); |
| | | $out = strtr($out, $trans); |
| | | |
| | | // create instance of html2text class |
| | | $txt = new html2text($html_part); |
| | | $out = $txt->get_text(); |
| | | break; |
| | | $txt = new html2text($out); |
| | | return $txt->get_text(); |
| | | } |
| | | } |
| | | |
| | | return $out; |
| | | $part = null; |
| | | return null; |
| | | } |
| | | |
| | | |
| | |
| | | * Raad the message structure returend by the IMAP server |
| | | * and build flat lists of content parts and attachments |
| | | * |
| | | * @param object rcube_message_part Message structure node |
| | | * @param bool True when called recursively |
| | | * @param rcube_message_part $structure Message structure node |
| | | * @param bool $recursive True when called recursively |
| | | */ |
| | | private function parse_structure($structure, $recursive = false) |
| | | { |
| | | $message_ctype_primary = $structure->ctype_primary; |
| | | $message_ctype_secondary = $structure->ctype_secondary; |
| | | $mimetype = $structure->mimetype; |
| | | |
| | | // real content-type of message/rfc822 part |
| | | if ($mimetype == 'message/rfc822') { |
| | | if ($structure->real_mimetype) { |
| | | $mimetype = $structure->real_mimetype; |
| | | list($message_ctype_primary, $message_ctype_secondary) = explode('/', $mimetype); |
| | | } |
| | | } |
| | | if ($structure->mimetype == 'message/rfc822' && $structure->real_mimetype) |
| | | $mimetype = $structure->real_mimetype; |
| | | else |
| | | $mimetype = $structure->mimetype; |
| | | |
| | | // show message headers |
| | | if ($recursive && is_array($structure->headers) && isset($structure->headers['subject'])) { |
| | |
| | | $c->headers = &$structure->headers; |
| | | $this->parts[] = $c; |
| | | } |
| | | |
| | | // Allow plugins to handle message parts |
| | | $plugin = $this->app->plugins->exec_hook('message_part_structure', |
| | | array('object' => $this, 'structure' => $structure, |
| | | 'mimetype' => $mimetype, 'recursive' => $recursive)); |
| | | |
| | | if ($plugin['abort']) |
| | | return; |
| | | |
| | | $structure = $plugin['structure']; |
| | | list($message_ctype_primary, $message_ctype_secondary) = explode('/', $plugin['mimetype']); |
| | | |
| | | // print body if message doesn't have multiple parts |
| | | if ($message_ctype_primary == 'text' && !$recursive) { |
| | |
| | | $this->mime_parts[$uupart->mime_id] = $uupart; |
| | | $this->attachments[] = $uupart; |
| | | } |
| | | |
| | | // @TODO: plugin hook? |
| | | } |
| | | // the same for pgp signed messages |
| | | else if ($mimetype == 'application/pgp' && !$recursive) { |
| | |
| | | $p->ctype_secondary = 'plain'; |
| | | $p->body = rcube_label('encryptedmessage'); |
| | | $p->size = strlen($p->body); |
| | | |
| | | // maybe some plugins are able to decode this encrypted message part |
| | | $data = $this->app->plugins->exec_hook('message_part_encrypted', |
| | | array('object' => $this, 'struct' => $structure, 'part' => $p)); |
| | | |
| | | if (is_array($data['parts'])) { |
| | | $this->parts = array_merge($this->parts, $data['parts']); |
| | | } |
| | | else if ($data['part']) { |
| | | $this->parts[] = $p; |
| | | } |
| | | } |
| | | // message contains multiple parts |
| | | else if (is_array($structure->parts) && !empty($structure->parts)) { |
| | |
| | | else if ((($part_mimetype == 'text/plain' || $part_mimetype == 'text/html') && $mail_part->disposition != 'attachment') || |
| | | $part_mimetype == 'message/delivery-status' || $part_mimetype == 'message/disposition-notification' |
| | | ) { |
| | | // Allow plugins to handle also this part |
| | | $plugin = $this->app->plugins->exec_hook('message_part_structure', |
| | | array('object' => $this, 'structure' => $mail_part, |
| | | 'mimetype' => $part_mimetype, 'recursive' => true)); |
| | | |
| | | if ($plugin['abort']) |
| | | continue; |
| | | |
| | | $mail_part = $plugin['structure']; |
| | | list($primary_type, $secondary_type) = explode('/', $plugin['mimetype']); |
| | | |
| | | // add text part if it matches the prefs |
| | | if (!$this->parse_alternative || |
| | | ($secondary_type == 'html' && $this->opt['prefer_html']) || |
| | |
| | | else if ($structure->filename) { |
| | | $this->attachments[] = $structure; |
| | | } |
| | | // message is a single part non-text (without filename) |
| | | else if (preg_match('/application\//i', $mimetype)) { |
| | | $structure->filename = 'Part '.$structure->mime_id; |
| | | $this->attachments[] = $structure; |
| | | } |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Fill aflat array with references to all parts, indexed by part numbers |
| | | * |
| | | * @param object rcube_message_part Message body structure |
| | | * @param rcube_message_part $part Message body structure |
| | | */ |
| | | private function get_mime_numbers(&$part) |
| | | { |
| | | if (strlen($part->mime_id)) |
| | | $this->mime_parts[$part->mime_id] = &$part; |
| | | |
| | | |
| | | if (is_array($part->parts)) |
| | | for ($i=0; $i<count($part->parts); $i++) |
| | | $this->get_mime_numbers($part->parts[$i]); |
| | |
| | | /** |
| | | * Decode a Microsoft Outlook TNEF part (winmail.dat) |
| | | * |
| | | * @param object rcube_message_part Message part to decode |
| | | * @param rcube_message_part $part Message part to decode |
| | | * @return array |
| | | */ |
| | | function tnef_decode(&$part) |
| | | { |
| | |
| | | if (!isset($part->body)) |
| | | $part->body = $this->imap->get_message_part($this->uid, $part->mime_id, $part); |
| | | |
| | | require_once('lib/tnef_decoder.inc'); |
| | | |
| | | $parts = array(); |
| | | $tnef_arr = tnef_decode($part->body); |
| | | $tnef = new tnef_decoder; |
| | | $tnef_arr = $tnef->decompress($part->body); |
| | | |
| | | foreach ($tnef_arr as $pid => $winatt) { |
| | | $tpart = new rcube_message_part; |
| | | |
| | | $tpart->filename = trim($winatt['name']); |
| | | $tpart->encoding = 'stream'; |
| | | $tpart->ctype_primary = trim(strtolower($winatt['type0'])); |
| | | $tpart->ctype_secondary = trim(strtolower($winatt['type1'])); |
| | | $tpart->ctype_primary = trim(strtolower($winatt['type'])); |
| | | $tpart->ctype_secondary = trim(strtolower($winatt['subtype'])); |
| | | $tpart->mimetype = $tpart->ctype_primary . '/' . $tpart->ctype_secondary; |
| | | $tpart->mime_id = 'winmail.' . $part->mime_id . '.' . $pid; |
| | | $tpart->size = $winatt['size']; |
| | |
| | | $parts[] = $tpart; |
| | | unset($tnef_arr[$pid]); |
| | | } |
| | | |
| | | |
| | | return $parts; |
| | | } |
| | | |
| | |
| | | /** |
| | | * Parse message body for UUencoded attachments bodies |
| | | * |
| | | * @param object rcube_message_part Message part to decode |
| | | * @param rcube_message_part $part Message part to decode |
| | | * @return array |
| | | */ |
| | | function uu_decode(&$part) |
| | | { |
| | |
| | | unset($matches[$pid]); |
| | | } |
| | | } |
| | | |
| | | |
| | | return $parts; |
| | | } |
| | | |
| | |
| | | /** |
| | | * Interpret a format=flowed message body according to RFC 2646 |
| | | * |
| | | * @param string Raw body formatted as flowed text |
| | | * @param string $text Raw body formatted as flowed text |
| | | * @return string Interpreted text with unwrapped lines and stuffed space removed |
| | | */ |
| | | public static function unfold_flowed($text) |
| | | { |
| | | return preg_replace( |
| | | array('/-- (\r?\n)/', '/^ /m', '/(.) \r?\n/', '/--%SIGEND%(\r?\n)/'), |
| | | array('--%SIGEND%\\1', '', '\\1 ', '-- \\1'), |
| | | $text); |
| | | $text = preg_split('/\r?\n/', $text); |
| | | $last = -1; |
| | | $q_level = 0; |
| | | |
| | | foreach ($text as $idx => $line) { |
| | | if ($line[0] == '>' && preg_match('/^(>+\s*)/', $line, $regs)) { |
| | | $q = strlen(str_replace(' ', '', $regs[0])); |
| | | $line = substr($line, strlen($regs[0])); |
| | | |
| | | if ($q == $q_level && $line |
| | | && isset($text[$last]) |
| | | && $text[$last][strlen($text[$last])-1] == ' ' |
| | | ) { |
| | | $text[$last] .= $line; |
| | | unset($text[$idx]); |
| | | } |
| | | else { |
| | | $last = $idx; |
| | | } |
| | | } |
| | | else { |
| | | $q = 0; |
| | | if ($line == '-- ') { |
| | | $last = $idx; |
| | | } |
| | | else { |
| | | // remove space-stuffing |
| | | $line = preg_replace('/^\s/', '', $line); |
| | | |
| | | if (isset($text[$last]) && $line |
| | | && $text[$last] != '-- ' |
| | | && $text[$last][strlen($text[$last])-1] == ' ' |
| | | ) { |
| | | $text[$last] .= $line; |
| | | unset($text[$idx]); |
| | | } |
| | | else { |
| | | $text[$idx] = $line; |
| | | $last = $idx; |
| | | } |
| | | } |
| | | } |
| | | $q_level = $q; |
| | | } |
| | | |
| | | return implode("\r\n", $text); |
| | | } |
| | | |
| | | |
| | | /** |
| | | * Wrap the given text to comply with RFC 2646 |
| | | * |
| | | * @param string $text Text to wrap |
| | | * @param int $length Length |
| | | * @return string Wrapped text |
| | | */ |
| | | public static function format_flowed($text, $length = 72) |
| | | { |
| | | $out = ''; |
| | | |
| | | foreach (preg_split('/\r?\n/', trim($text)) as $line) { |
| | | // don't wrap quoted lines (to avoid wrapping problems) |
| | | if ($line[0] != '>') |
| | | $line = rc_wordwrap(rtrim($line), $length - 1, " \r\n"); |
| | | $text = preg_split('/\r?\n/', $text); |
| | | |
| | | $out .= $line . "\r\n"; |
| | | foreach ($text as $idx => $line) { |
| | | if ($line != '-- ') { |
| | | if ($line[0] == '>' && preg_match('/^(>+)/', $line, $regs)) { |
| | | $prefix = $regs[0]; |
| | | $level = strlen($prefix); |
| | | $line = rtrim(substr($line, $level)); |
| | | $line = $prefix . rc_wordwrap($line, $length - $level - 2, " \r\n$prefix "); |
| | | } |
| | | else if ($line) { |
| | | $line = ' ' . rc_wordwrap(rtrim($line), $length - 2, " \r\n "); |
| | | } |
| | | |
| | | $text[$idx] = $line; |
| | | } |
| | | } |
| | | |
| | | return $out; |
| | | |
| | | return implode("\r\n", $text); |
| | | } |
| | | |
| | | } |