9cce1046248ff5a051e4515cf8595ac445122895
6 * Copyright (c) 2002 The SquirrelMail Project Team
7 * Licensed under the GNU GPL. For full terms see the file COPYING.
9 * This contains functions needed to handle mime messages.
15 /** message is the object that contains messages. It is a recursive
16 object in that through the $entities variable, it can contain
17 more objects of type message. See documentation in mime.txt for
18 a better description of how this works.
20 var $rfc822_header = '',
28 $parent = '', $decoded_body='',
29 $is_seen = 0, $is_answered = 0, $is_deleted = 0, $is_flagged = 0,
32 $offset = 0, /* for fetching body parts out of raw messages */
33 $length = 0, /* for fetching body parts out of raw messages */
34 $att_local_name = ''; /* location where the tempory attachment
35 is stored. For future usage in smtp.php */
37 function setEnt($ent) {
38 $this->entity_id
= $ent;
41 function addEntity ($msg) {
42 $this->entities
[] = $msg;
45 function getFilename() {
47 $filename = $this->header
->getParameter('filename');
49 $filename = $this->header
->getParameter('name');
53 $filename = 'untitled-'.$this->entity_id
;
59 function addRFC822Header($read) {
60 $header = new Rfc822Header();
61 $this->rfc822_header
= $header->parseHeader($read);
64 function getEntity($ent) {
65 $cur_ent = $this->entity_id
;
67 if (($cur_ent == '') ||
($cur_ent == '0')) {
70 $cur_ent_a = explode('.', $this->entity_id
);
72 $ent_a = explode('.', $ent);
74 for ($i = 0,$entCount = count($ent_a) - 1; $i < $entCount; ++
$i) {
75 if (isset($cur_ent_a[$i]) && ($cur_ent_a[$i] != $ent_a[$i])) {
77 $cur_ent_a = explode('.', $msg->entity_id
);
79 } else if (!isset($cur_ent_a[$i])) {
80 if (isset($msg->entities
[($ent_a[$i]-1)])) {
81 $msg = $msg->entities
[($ent_a[$i]-1)];
83 $msg = $msg->entities
[0];
86 if (($msg->type0
== 'message') && ($msg->type1
== 'rfc822')) {
87 /*this is a header for a message/rfc822 entity */
88 $msg = $msg->entities
[0];
92 if (($msg->type0
== 'message') && ($msg->type1
== 'rfc822')) {
93 /*this is a header for a message/rfc822 entity */
94 $msg = $msg->entities
[0];
97 if (isset($msg->entities
[($ent_a[$entCount])-1])) {
98 if (is_object($msg->entities
[($ent_a[$entCount])-1])) {
99 $msg = $msg->entities
[($ent_a[$entCount]-1)];
106 function setBody($s) {
107 $this->body_part
= $s;
110 function clean_up() {
112 $msg->body_part
= '';
114 foreach ($msg->entities
as $m) {
119 function getMailbox() {
121 while (is_object($msg->parent
)) {
124 return $msg->mailbox
;
128 * Bodystructure parser, a recursive function for generating the
129 * entity-tree with all the mime-parts.
131 * It follows RFC2060 and stores all the described fields in the
136 * Ask for me (Marc Groot Koerkamp, stekkel@users.sourceforge.net)
139 function parseStructure($read, &$i, $sub_msg = '') {
140 $msg = Message
::parseBodyStructure($read, $i, $sub_msg);
141 $msg->setEntIds($msg,false,0);
145 function setEntIds(&$msg,$init=false,$i=0) {
146 $iCnt = count($msg->entities
);
147 if ($init !==false) {
149 if ($msg->parent
->type0
== 'message' &&
150 $msg->parent
->type1
== 'rfc822' &&
151 $msg->type0
== 'multipart') {
155 $msg->entity_id
= "$init.$iEntSub";
157 $msg->entity_id
= $iEntSub;
164 for ($i=0;$i<$iCnt;++
$i) {
165 $msg->entities
[$i]->parent
=& $msg;
166 if (strrchr($msg->entity_id
, '.') != '.0') {
167 $msg->entities
[$i]->setEntIds($msg->entities
[$i],$msg->entity_id
,$i);
169 $msg->entities
[$i]->setEntIds($msg->entities
[$i],$msg->parent
->entity_id
,$i);
175 function parseBodyStructure($read, &$i, $sub_msg = '') {
181 $message = new Message();
184 for ($cnt = strlen($read); $i < $cnt; ++
$i) {
185 $char = strtoupper($read{$i});
191 $msg = new Message();
192 $hdr = new MessageHeader();
193 $hdr->type0
= 'text';
194 $hdr->type1
= 'plain';
195 $hdr->encoding
= 'us-ascii';
197 $msg->header
->type0
= 'multipart';
198 $msg->type0
= 'multipart';
199 while ($read{$i} == '(') {
200 $msg->addEntity($this->parseBodyStructure($read, $i, $msg));
205 /* multipart properties */
207 $arg_a[] = $this->parseProperties($read, $i);
211 if (isset($msg->type0
) && ($msg->type0
== 'multipart')) {
213 $arg_a[] = $this->parseDisposition($read, $i);
214 } else { /* properties */
215 $arg_a[] = $this->parseProperties($read, $i);
220 if (isset($msg->type0
) && ($msg->type0
== 'multipart')) {
222 $arg_a[]= $this->parseLanguage($read, $i);
225 if (($arg_a[0] == 'message') && ($arg_a[1] == 'rfc822')) {
226 $msg->header
->type0
= $arg_a[0];
227 $msg->header
->type1
= $arg_a[1];
228 $msg->type0
= $arg_a[0];
229 $msg->type1
= $arg_a[1];
230 $rfc822_hdr = new Rfc822Header();
231 $msg->rfc822_header
= $this->parseEnvelope($read, $i, $rfc822_hdr);
232 while (($i < $cnt) && ($read{$i} != '(')) {
235 $msg->addEntity($this->parseBodyStructure($read, $i,$msg));
240 $arg_a[] = $this->parseDisposition($read, $i);
245 if (($arg_a[0] == 'text') ||
(($arg_a[0] == 'message') && ($arg_a[1] == 'rfc822'))) {
246 $arg_a[] = $this->parseDisposition($read, $i);
248 $arg_a[] = $this->parseLanguage($read, $i);
253 if (($arg_a[0] == 'text') ||
(($arg_a[0] == 'message') && ($arg_a[1] == 'rfc822'))) {
255 $arg_a[] = $this->parseLanguage($read, $i);
257 $i = $this->parseParenthesis($read, $i);
258 $arg_a[] = ''; /* not yet described in rfc2060 */
263 /* unknown argument, skip this part */
264 $i = $this->parseParenthesis($read, $i);
271 /* inside an entity -> start processing */
272 $arg_s = $this->parseQuote($read, $i);
275 $arg_s = strtolower($arg_s); /* type0 and type1 */
281 /* probably NIL argument */
282 if (strtoupper(substr($read, $i, 4)) == 'NIL ') {
289 /* process the literal value */
290 $arg_s = $this->parseLiteral($read, $i);
294 case is_numeric($read{$i}):
295 /* process integers */
296 if ($read{$i} == ' ') { break; }
298 if (preg_match('/^([0-9]+).*/',substr($read,$i), $regs)) {
299 $i +
= strlen($regs[1])-1;
306 $multipart = (isset($msg->type0
) && ($msg->type0
== 'multipart'));
308 $shifted_args = (($arg_a[0] == 'text') ||
(($arg_a[0] == 'message') && ($arg_a[1] == 'rfc822')));
309 $hdr->type0
= $arg_a[0];
310 $hdr->type1
= $arg_a[1];
312 $msg->type0
= $arg_a[0];
313 $msg->type1
= $arg_a[1];
315 if (is_array($arr)) {
316 $hdr->parameters
= $arg_a[2];
318 $hdr->id
= str_replace('<', '', str_replace('>', '', $arg_a[3]));
319 $hdr->description
= $arg_a[4];
320 $hdr->encoding
= strtolower($arg_a[5]);
321 $hdr->entity_id
= $msg->entity_id
;
322 $hdr->size
= $arg_a[6];
324 $hdr->lines
= $arg_a[7];
329 $hdr->md5
= (isset($arg_a[7+
$s]) ?
$arg_a[7+
$s] : $hdr->md5
);
330 $hdr->disposition
= (isset($arg_a[8+
$s]) ?
$arg_a[8+
$s] : $hdr->disposition
);
331 $hdr->language
= (isset($arg_a[9+
$s]) ?
$arg_a[9+
$s] : $hdr->language
);
334 $hdr->type0
= 'multipart';
335 $hdr->type1
= $arg_a[0];
336 $msg->type0
= 'multipart';
337 $msg->type1
= $arg_a[0];
338 $hdr->parameters
= (isset($arg_a[1]) ?
$arg_a[1] : $hdr->parameters
);
339 $hdr->disposition
= (isset($arg_a[2]) ?
$arg_a[2] : $hdr->disposition
);
340 $hdr->language
= (isset($arg_a[3]) ?
$arg_a[3] : $hdr->language
);
347 } /* parsestructure */
349 function parseProperties($read, &$i) {
350 $properties = array();
353 for (; $read{$i} != ')'; ++
$i) {
355 if ($read{$i} == '"') {
356 $arg_s = $this->parseQuote($read, $i);
357 } else if ($read{$i} == '{') {
358 $arg_s = $this->parseLiteral($read, $i);
362 if ($prop_name == '') {
363 $prop_name = strtolower($arg_s);
364 $properties[$prop_name] = '';
365 } else if ($prop_name != '') {
366 $properties[$prop_name] = $arg_s;
374 function parseEnvelope($read, &$i, $hdr) {
378 for ($cnt = strlen($read); ($i < $cnt) && ($read{$i} != ')'); ++
$i) {
380 $char = strtoupper($read{$i});
383 $arg_a[] = $this->parseQuote($read, $i);
387 $arg_a[] = $this->parseLiteral($read, $i);
391 /* probably NIL argument */
392 if (strtoupper(substr($read, $i, 3)) == 'NIL') {
399 /* Address structure (with group support)
400 * Note: Group support is useless on SMTP connections
401 * because the protocol doesn't support it
406 for (; $i < $cnt && $read{$i} != ')'; ++
$i) {
407 if ($read{$i} == '(') {
408 $addr = $this->parseAddress($read, $i);
409 if (($addr->host
== '') && ($addr->mailbox
!= '')) {
411 $group = $addr->mailbox
;
414 } else if ($group && ($addr->host
== '') && ($addr->mailbox
== '')) {
416 if ($a == ($j+
1)) { /* no group members */
417 $group_addr->group
= $group;
418 $group_addr->mailbox
= '';
419 $group_addr->personal
= "$group: Undisclosed recipients;";
420 $addr_a[] = $group_addr;
424 $addr->group
= $group;
436 if (count($arg_a) > 9) {
437 $d = strtr($arg_a[0], array(' ' => ' '));
438 $d = explode(' ', $d);
439 if (!$arg_a[1]) $arg_1[1] = _("(no subject)");
441 $hdr->date
= getTimeStamp($d); /* argument 1: date */
442 $hdr->subject
= $arg_a[1]; /* argument 2: subject */
443 $hdr->from
= $arg_a[2][0]; /* argument 3: from */
444 $hdr->sender
= $arg_a[3][0]; /* argument 4: sender */
445 $hdr->replyto
= $arg_a[4][0]; /* argument 5: reply-to */
446 $hdr->to
= $arg_a[5]; /* argument 6: to */
447 $hdr->cc
= $arg_a[6]; /* argument 7: cc */
448 $hdr->bcc
= $arg_a[7]; /* argument 8: bcc */
449 $hdr->inreplyto
= $arg_a[8]; /* argument 9: in-reply-to */
450 $hdr->message_id
= $arg_a[9]; /* argument 10: message-id */
455 function parseLiteral($read, &$i) {
458 $iPos = strpos($read,'}',$i);
460 $lit_cnt = substr($read, $i, $iPos - $i);
461 $i +
= strlen($lit_cnt) +
3; /* } + \r + \n */
462 $lit_cnt -= 2; /* lit_cnt includes \r\n */
463 $s = ($lit_cnt ?
substr($read,$i,$lit_cnt): '');
465 } else { /* should never happen */
466 $i +
= 3; /* } + \r + \n */
472 function parseQuote($read, &$i) {
476 $iPos = strpos($read,'"',$iPos);
477 if ($iPos === false) break;
478 if ($iPos && $read{$iPos -1} != '\\') {
479 $s = substr($read,$i,($iPos-$i));
487 function parseAddress($read, &$i) {
489 for (; $read{$i} != ')'; ++
$i) {
490 $char = strtoupper($read{$i});
492 case '"': $arg_a[] = $this->parseQuote($read, $i); break;
493 case '{': $arg_a[] = $this->parseLiteral($read, $i); break;
496 if (strtoupper(substr($read, $i, 3)) == 'NIL') {
505 if (count($arg_a) == 4) {
506 $adr = new AddressStructure();
507 $adr->personal
= $arg_a[0];
508 $adr->adl
= $arg_a[1];
509 $adr->mailbox
= $arg_a[2];
510 $adr->host
= $arg_a[3];
517 function parseDisposition($read, &$i) {
519 for (; $read{$i} != ')'; ++
$i) {
521 case '"': $arg_a[] = $this->parseQuote($read, $i); break;
522 case '{': $arg_a[] = $this->parseLiteral($read, $i); break;
523 case '(': $arg_a[] = $this->parseProperties($read, $i); break;
528 if (isset($arg_a[0])) {
529 $disp = new Disposition($arg_a[0]);
530 if (isset($arg_a[1])) {
531 $disp->properties
= $arg_a[1];
535 return (is_object($disp) ?
$disp : '');
538 function parseLanguage($read, &$i) {
539 /* no idea how to process this one without examples */
542 for (; $read{$i} != ')'; ++
$i) {
544 case '"': $arg_a[] = $this->parseQuote($read, $i); break;
545 case '{': $arg_a[] = $this->parseLiteral($read, $i); break;
546 case '(': $arg_a[] = $this->parseProperties($read, $i); break;
551 if (isset($arg_a[0])) {
552 $lang = new Language($arg_a[0]);
553 if (isset($arg_a[1])) {
554 $lang->properties
= $arg_a[1];
558 return (is_object($lang) ?
$lang : '');
561 function parseParenthesis($read, $i) {
562 for (; $read{$i} != ')'; ++
$i) {
564 case '"': $this->parseQuote($read, $i); break;
565 case '{': $this->parseLiteral($read, $i); break;
566 case '(': $this->parseProperties($read, $i); break;
573 /* Function to fill the message structure in case the */
574 /* bodystructure is not available NOT FINISHED YET */
575 function parseMessage($read, $type0, $type1) {
578 $rfc822_header = true;
579 $mime_header = false;
582 $rfc822_header = false;
585 default: return $read;
588 for ($i = 1; $i < $count; ++
$i) {
589 $line = trim($body[$i]);
590 if (($mime_header ||
$rfc822_header) &&
591 (preg_match("/^.*boundary=\"?(.+(?=\")|.+).*/i", $line, $reg))) {
594 $bndreg = str_replace("\\", "\\\\", $bndreg);
595 $bndreg = str_replace("?", "\\?", $bndreg);
596 $bndreg = str_replace("+", "\\+", $bndreg);
597 $bndreg = str_replace(".", "\\.", $bndreg);
598 $bndreg = str_replace("/", "\\/", $bndreg);
599 $bndreg = str_replace("-", "\\-", $bndreg);
600 $bndreg = str_replace("(", "\\(", $bndreg);
601 $bndreg = str_replace(")", "\\)", $bndreg);
602 } else if ($rfc822_header && $line == '') {
603 $rfc822_header = false;
604 if ($msg->type0
== 'multipart') {
609 if ((($line{0} == '-') ||
$rfc822_header) && isset($boundaries[0])) {
610 $cnt = count($boundaries)-1;
611 $bnd = $boundaries[$cnt]['bnd'];
612 $bndreg = $boundaries[$cnt]['bndreg'];
614 $regstr = '/^--'."($bndreg)".".*".'/';
615 if (preg_match($regstr, $line, $reg)) {
616 $bndlen = strlen($reg[1]);
618 if (strlen($line) > ($bndlen +
3)) {
619 if (($line{$bndlen+
2} == '-') && ($line{$bndlen+
3} == '-')) {
624 /* calc offset and return $msg */
625 //$entStr = CalcEntity("$entStr", -1);
626 array_pop($boundaries);
632 //$entStr = CalcEntity("$entStr", 0);
642 function findDisplayEntity($entity = array(), $alt_order = array('text/plain', 'text/html'), $strict=false) {
644 if ($this->type0
== 'multipart') {
645 if($this->type1
== 'alternative') {
646 $msg = $this->findAlternativeEntity($alt_order);
647 if (count($msg->entities
) == 0) {
648 $entity[] = $msg->entity_id
;
650 $entity = $msg->findDisplayEntity($entity, $alt_order, $strict);
653 } else if ($this->type1
== 'related') { /* RFC 2387 */
654 $msgs = $this->findRelatedEntity();
655 foreach ($msgs as $msg) {
656 if (count($msg->entities
) == 0) {
657 $entity[] = $msg->entity_id
;
659 $entity = $msg->findDisplayEntity($entity, $alt_order, $strict);
662 if (count($msgs) > 0) {
665 } else { /* Treat as multipart/mixed */
666 foreach ($this->entities
as $ent) {
667 if((strtolower($ent->header
->disposition
->name
) != 'attachment') &&
668 (($ent->type0
!= 'message') && ($ent->type1
!= 'rfc822'))) {
669 $entity = $ent->findDisplayEntity($entity, $alt_order, $strict);
674 } else { /* If not multipart, then just compare with each entry from $alt_order */
675 $type = $this->type0
.'/'.$this->type1
;
676 // $alt_order[] = "message/rfc822";
677 foreach ($alt_order as $alt) {
678 if( ($alt == $type) && isset($this->entity_id
) ) {
679 if ((count($this->entities
) == 0) &&
680 (strtolower($this->header
->disposition
->name
) != 'attachment')) {
681 $entity[] = $this->entity_id
;
688 foreach ($this->entities
as $ent) {
689 if((strtolower($ent->header
->disposition
->name
) != 'attachment') &&
690 (($ent->type0
!= 'message') && ($ent->type1
!= 'rfc822'))) {
691 $entity = $ent->findDisplayEntity($entity, $alt_order, $strict);
697 if(!$strict && !$found) {
698 if (($this->type0
== 'text') &&
699 in_array($this->type1
, array('plain', 'html', 'message')) &&
700 isset($this->entity_id
)) {
701 if (count($this->entities
) == 0) {
702 if (strtolower($this->header
->disposition
->name
) != 'attachment') {
703 $entity[] = $this->entity_id
;
711 function findAlternativeEntity($alt_order) {
712 /* If we are dealing with alternative parts then we */
713 /* choose the best viewable message supported by SM. */
716 foreach($this->entities
as $ent) {
717 $type = $ent->header
->type0
. '/' . $ent->header
->type1
;
718 if ($type == 'multipart/related') {
719 $type = $ent->header
->getParameter('type');
721 $altCount = count($alt_order);
722 for ($j = $best_view; $j < $altCount; ++
$j) {
723 if (($alt_order[$j] == $type) && ($j >= $best_view)) {
733 function findRelatedEntity() {
736 $entCount = count($this->entities
);
737 for ($i = 0; $i < $entCount; ++
$i) {
738 $type = $this->entities
[$i]->header
->type0
.'/'.$this->entities
[$i]->header
->type1
;
739 if ($this->header
->getParameter('type') == $type) {
740 $msgs[] = $this->entities
[$i];
747 function getAttachments($exclude_id=array(), $result = array()) {
749 if (($this->type0 == 'message') &&
750 ($this->type1 == 'rfc822') &&
751 ($this->entity_id) ) {
752 $this = $this->entities[0];
755 if (count($this->entities
)) {
756 foreach ($this->entities
as $entity) {
758 foreach ($exclude_id as $excl) {
759 if ($entity->entity_id
=== $excl) {
765 if (($entity->type0
== 'multipart') &&
766 ($entity->type1
!= 'related')) {
767 $result = $entity->getAttachments($exclude_id, $result);
768 } else if ($entity->type0
!= 'multipart') {
775 foreach ($exclude_id as $excl) {
776 $exclude = $exclude ||
($this->entity_id
== $excl);
786 function initAttachment($type, $name, $location) {
787 $attachment = new Message();
788 $mime_header = new MessageHeader();
789 $mime_header->setParameter('name', $name);
790 $pos = strpos($type, '/');
792 $mime_header->type0
= substr($type, 0, $pos);
793 $mime_header->type1
= substr($type, $pos+
1);
795 $mime_header->type0
= $type;
797 $attachment->att_local_name
= $location;
798 $disposition = new Disposition('attachment');
799 $disposition->properties
['filename'] = $name;
800 $mime_header->disposition
= $disposition;
801 $attachment->mime_header
= $mime_header;
802 $this->entities
[]=$attachment;