WIP/dirty/needs polishing/hack: added support for listing/receiving any mime part of message (can be used e.g. for parsing DSNs)

Author: jkuchar

MailLibrary/Mail.php

@@ -257,6 +257,12 @@ protected function initializeStructure()
 		$this->structure = $this->connection->getDriver()->getStructure($this->id, $this->mailbox);
 	}
 
+	/** @internal */
+	public function getStructure(): IStructure {
+		$this->structure !== NULL || $this->initializeStructure();
+		return $this->structure;
+	}
+
 	protected function initializeFlags()
 	{
 		$this->connection->getDriver()->switchMailbox($this->mailbox->getName());

MailLibrary/MimePart.php

@@ -0,0 +1,82 @@
+<?php
+/**
+ * This file is part of the imap-mail-list-extractor.
+ * Copyright (c) 2017 Grifart spol. s r.o. (https://grifart.cz)
+ */
+
+namespace greeny\MailLibrary;
+
+use greeny\MailLibrary\Drivers\IDriver;
+
+class MimePart
+{
+	/** @var string */
+	private $partId;
+
+	/** @var string */
+	private $mimeType;
+
+	/** @var string */
+	private $name;
+
+	/** @var string */
+	private $encoding;
+
+	/** @var IDriver */
+	private $driver;
+
+	/** @var string */
+	private $mailId;
+
+	public function __construct(IDriver $driver, $mailId, $partId, $mimeType, $name, $encoding)
+	{
+		$this->partId = $partId;
+		$this->mailId = $mailId;
+		$this->mimeType = $mimeType;
+		$this->name = $name;
+		$this->encoding = $encoding;
+		$this->driver = $driver;
+	}
+
+	/**
+	 * @return string
+	 */
+	public function getPartId(): string
+	{
+		return $this->partId;
+	}
+
+	/**
+	 * @return string
+	 */
+	public function getMimeType(): string
+	{
+		return $this->mimeType;
+	}
+
+	/**
+	 * @return string
+	 */
+	public function getName(): string
+	{
+		return $this->name;
+	}
+
+	/**
+	 * @return string
+	 */
+	public function getEncoding(): string
+	{
+		return $this->encoding;
+	}
+
+	public function getContent()
+	{
+		// todo: this automatically decodes content type if supported, support for getting RAW content?
+		return $this->driver->getBody($this->mailId, [[
+			'id'       => $this->partId,
+			'encoding' => $this->encoding,
+		]]);
+	}
+
+}

MailLibrary/Structures/IStructure.php

@@ -6,6 +6,7 @@
 namespace greeny\MailLibrary\Structures;
 
 use greeny\MailLibrary\Attachment;
+use greeny\MailLibrary\MimePart;
 
 interface IStructure {
 	/**
@@ -27,4 +28,7 @@ function getTextBody();
 	 * @return Attachment[]
 	 */
 	function getAttachments();
+
+	/** @return MimePart[] */
+	public function getParts(): array;
 }

MailLibrary/Structures/ImapStructure.php

@@ -8,6 +8,7 @@
 use greeny\MailLibrary\Attachment;
 use greeny\MailLibrary\Drivers\ImapDriver;
 use greeny\MailLibrary\Mailbox;
+use greeny\MailLibrary\MimePart;
 
 class ImapStructure implements IStructure {
 	const TYPE_TEXT = 0;
@@ -37,6 +38,8 @@ class ImapStructure implements IStructure {
 		self::TYPE_OTHER => 'other',
 	);
 
+	private $messageParts = [];
+
 	/** @var \greeny\MailLibrary\Drivers\ImapDriver */
 	protected $driver;
 
@@ -64,6 +67,9 @@ class ImapStructure implements IStructure {
 	/** @var Mailbox */
 	protected $mailbox;
 
+	/** @var array */
+	private $rawStructure = [];
+
 	/**
 	 * @param ImapDriver $driver
 	 * @param object     $structure
@@ -72,6 +78,7 @@ class ImapStructure implements IStructure {
 	 */
 	public function __construct(ImapDriver $driver, $structure, $mailId, Mailbox $mailbox)
 	{
+		$this->rawStructure = $structure;
 		$this->driver = $driver;
 		$this->id = $mailId;
 		$this->mailbox = $mailbox;
@@ -84,6 +91,14 @@ public function __construct(ImapDriver $driver, $structure, $mailId, Mailbox $ma
 		}
 	}
 
+	/**
+	 * @return array
+	 */
+	public function getRawStructure()
+	{
+		return $this->rawStructure;
+	}
+
 	/**
 	 * @return string
 	 */
@@ -133,6 +148,13 @@ public function getAttachments()
 		return $this->attachments;
 	}
 
+	/** @return MimePart[] */
+	public function getParts(): array
+	{
+		$this->driver->switchMailbox($this->mailbox->getName());
+		return $this->messageParts;
+	}
+
 	protected function addStructurePart($structure, $partId)
 	{
 		$type = $structure->type;
@@ -151,13 +173,24 @@ protected function addStructurePart($structure, $partId)
 			}
 		}
 
+		$this->messageParts[] = new MimePart(
+			$this->driver,
+			$this->id,
+			$partId,
+			self::$typeTable[$type]. '/' . $subtype,
+			$parameters['filename'] ?? $parameters['name'] ?? '',
+			$encoding
+		);
+
+
 		if(isset($parameters['filename']) || isset($parameters['name'])) {
 			$this->attachmentsIds[] = array(
 				'id' => $partId,
 				'encoding' => $encoding,
 				'name' => isset($parameters['filename']) ? $parameters['filename'] : $parameters['name'],
 				'type' => self::$typeTable[$type]. '/' . $subtype,
 			);
+
 		} else if($type === self::TYPE_TEXT) {
 			if($subtype === 'HTML') {
 				$this->htmlBodyIds[] = array('id' => $partId, 'encoding' => $encoding);

MailLibrary/loader.php

@@ -14,6 +14,7 @@
 		'greeny\maillibrary\contactlist' => 'ContactList.php',
 		'greeny\maillibrary\contact' => 'Contact.php',
 		'greeny\maillibrary\attachment' => 'Attachment.php',
+		'greeny\maillibrary\mimepart' => 'MimePart.php',
 		'greeny\maillibrary\structures\istructure' => 'Structures/IStructure.php',
 		'greeny\maillibrary\structures\imapstructure' => 'Structures/ImapStructure.php',
 		'greeny\maillibrary\drivers\idriver' => 'Drivers/IDriver.php',