+ /** Setting up the objects that have the structure for the message **/
+
+ class msg_header {
+ /** msg_header contains generic variables for values that **/
+ /** could be in a header. **/
+
+ var $type0, $type1, $boundary, $charset, $encoding;
+ var $to, $from, $date, $cc, $bcc, $reply_to, $subject;
+ var $id, $mailbox, $description;
+ var $entity_id, $message_id;
+ }
+
+ class message {
+ /** message is the object that contains messages. It is a recursive
+ object in that through the $entities variable, it can contain
+ more objects of type message. See documentation in mime.txt for
+ a better description of how this works.
+ **/
+ var $header;
+ var $entities;
+
+ function addEntity ($msg) {
+ $this->entities[count($this->entities)] = $msg;
+ }
+ }
+
+
+
+ /* --------------------------------------------------------------------------------- */
+ /* MIME DECODING */
+ /* --------------------------------------------------------------------------------- */
+
+ // This function gets the structure of a message and stores it in the "message" class.
+ // It will return this object for use with all relevant header information and
+ // fully parsed into the standard "message" object format.
+ function mime_structure ($imap_stream, $header) {
+ global $debug_mime;
+ sqimap_messages_flag ($imap_stream, $header->id, $header->id, "Seen");
+
+ $id = $header->id;
+ fputs ($imap_stream, "a001 FETCH $id BODYSTRUCTURE\r\n");
+ $read = fgets ($imap_stream, 10000);
+ $read = strtolower($read);
+
+ if ($debug_mime) echo "<tt>$read</tt><br><br>";
+ // isolate the body structure and remove beginning and end parenthesis
+ $read = trim(substr ($read, strpos($read, "bodystructure") + 13));
+ $read = trim(substr ($read, 0, -1));
+ $end = mime_match_parenthesis(0, $read);
+ while ($end == strlen($read)-1) {
+ $read = trim(substr ($read, 0, -1));
+ $read = trim(substr ($read, 1));
+ $end = mime_match_parenthesis(0, $read);
+ }
+
+ if ($debug_mime) echo "<tt>$read</tt><br><br>";
+
+ $msg = mime_parse_structure ($read);
+ $msg->header = $header;
+ return $msg;
+ }
+
+ // this starts the parsing of a particular structure. It is called recursively,
+ // so it can be passed different structures. It returns an object of type
+ // $message.
+ // First, it checks to see if it is a multipart message. If it is, then it
+ // handles that as it sees is necessary. If it is just a regular entity,
+ // then it parses it and adds the necessary header information (by calling out
+ // to mime_get_elements()
+ function mime_parse_structure ($structure, $ent_id) {
+ global $debug_mime;
+ if ($debug_mime) echo "<font color=008800><tt>START: mime_parse_structure()</tt></font><br>";
+ $msg = new message();
+ if (substr($structure, 0, 1) == "(") {
+ $ent_id = mime_new_element_level($ent_id);
+ $start = $end = -1;
+ if ($debug_mime) echo "<br><font color=0000aa><tt>$structure</tt></font><br>";
+ do {
+ if ($debug_mime) echo "<font color=008800><tt>Found entity...</tt></font><br>";
+ $start = $end+1;
+ $end = mime_match_parenthesis ($start, $structure);
+
+ $element = substr($structure, $start+1, ($end - $start)-1);
+ $ent_id = mime_increment_id ($ent_id);
+ $newmsg = mime_parse_structure ($element, $ent_id);
+ $msg->addEntity ($newmsg);
+ } while (substr($structure, $end+1, 1) == "(");
+ } else {
+ // parse the elements
+ if ($debug_mime) echo "<br><font color=0000aa><tt>$structure</tt></font><br>";
+ $msg = mime_get_element (&$structure, $msg, $ent_id);
+ if ($debug_mime) echo "<br>";
+ }
+ return $msg;
+ if ($debug_mime) echo "<font color=008800><tt> END: mime_parse_structure()</tt></font><br>";
+ }
+
+ // Increments the element ID. An element id can look like any of
+ // the following: 1, 1.2, 4.3.2.4.1, etc. This function increments
+ // the last number of the element id, changing 1.2 to 1.3.
+ function mime_increment_id ($id) {
+ global $debug_mime;
+ if (strpos($id, ".")) {
+ $first = substr($id, 0, strrpos($id, "."));
+ $last = substr($id, strrpos($id, ".")+1);
+ $last++;
+ $new = $first . "." .$last;
+ } else {
+ $new = $id + 1;
+ }
+ if ($debug_mime) echo "<b>INCREMENT: $new</b><br>";
+ return $new;
+ }
+
+ // See comment for mime_increment_id().
+ // This adds another level on to the entity_id changing 1.3 to 1.3.0
+ // NOTE: 1.3.0 is not a valid element ID. It MUST be incremented
+ // before it can be used. I left it this way so as not to have
+ // to make a special case if it is the first entity_id. It
+ // always increments it, and that works fine.
+ function mime_new_element_level ($id) {
+ if (!$id) $id = 0;
+ else $id = $id . ".0";
+
+ return $id;
+ }
+
+ function mime_get_element (&$structure, $msg, $ent_id) {
+ global $debug_mime;
+ $elem_num = 1;
+ $msg->header = new msg_header();
+ $msg->header->entity_id = $ent_id;
+
+ while (strlen($structure) > 0) {
+ $structure = trim($structure);
+ $char = substr($structure, 0, 1);
+
+ if (substr($structure, 0, 3) == "nil") {
+ $text = "";
+ $structure = substr($structure, 3);
+ } else if ($char == "\"") {
+ // loop through until we find the matching quote, and return that as a string
+ $pos = 1;
+ $char = substr($structure, $pos, 1);
+ while ($char != "\"" && $pos < strlen($structure)) {
+ $text .= $char;
+ $pos++;
+ $char = substr($structure, $pos, 1);
+ }
+ $structure = substr($structure, strlen($text) + 2);
+ } else if ($char == "(") {
+ // comment me
+ $end = mime_match_parenthesis (0, $structure);
+ $sub = substr($structure, 1, $end-1);
+ $properties = mime_get_props($properties, $sub);
+ $structure = substr($structure, strlen($sub) + 2);
+ } else {
+ // loop through until we find a space or an end parenthesis
+ $pos = 0;
+ $char = substr($structure, $pos, 1);
+ while ($char != " " && $char != ")" && $pos < strlen($structure)) {
+ $text .= $char;
+ $pos++;
+ $char = substr($structure, $pos, 1);
+ }
+ $structure = substr($structure, strlen($text));
+ }
+ if ($debug_mime) echo "<tt>$elem_num : $text</tt><br>";
+
+ // This is where all the text parts get put into the header
+ switch ($elem_num) {
+ case 1:
+ $msg->header->type0 = $text;
+ if ($debug_mime) echo "<tt>type0 = $text</tt><br>";
+ break;
+ case 2:
+ $msg->header->type1 = $text;
+ if ($debug_mime) echo "<tt>type1 = $text</tt><br>";
+ break;
+ case 5:
+ $msg->header->description = $text;
+ if ($debug_mime) echo "<tt>description = $text</tt><br>";
+ break;
+ case 6:
+ $msg->header->encoding = $text;
+ if ($debug_mime) echo "<tt>encoding = $text</tt><br>";
+ break;
+ case 7:
+ $msg->header->size = $text;
+ if ($debug_mime) echo "<tt>size = $text</tt><br>";
+ break;
+ default:
+ if ($msg->header->type0 == "text" && $elem_num == 8) {
+ // This is a plain text message, so lets get the number of lines
+ // that it contains.
+ $msg->header->num_lines = $text;
+ if ($debug_mime) echo "<tt>num_lines = $text</tt><br>";
+
+ } else if ($msg->header->type0 == "message" && $msg->header->type1 == "rfc822" && $elem_num == 8) {
+ // This is an encapsulated message, so lets start all over again and
+ // parse this message adding it on to the existing one.
+ $structure = trim($structure);
+ if (substr($structure, 0, 1) == "(") {
+ $e = mime_match_parenthesis (0, $structure);
+ $structure = substr($structure, 0, $e);
+ $structure = substr($structure, 1);
+ $m = mime_parse_structure($structure, $msg->header->entity_id);
+
+ // the following conditional is there to correct a bug that wasn't
+ // incrementing the entity IDs correctly because of the special case
+ // that message/rfc822 is. This fixes it fine.
+ if (substr($structure, 1, 1) != "(")
+ $m->header->entity_id = mime_increment_id(mime_new_element_level($ent_id));
+
+ // Now we'll go through and reformat the results.
+ if ($m->entities) {
+ for ($i=0; $i < count($m->entities); $i++) {
+ $msg->addEntity($m->entities[$i]);
+ }
+ } else {
+ $msg->addEntity($m);
+ }
+ $structure = "";