Merge pull request #28 from bnrmth/master

Added embedded images support

Author: simonchrz

Message.php

@@ -209,6 +209,13 @@ class Message
      */
     protected $attachments = array();
 
+    /**
+    * an array of images embedded in the message
+    *
+    * @var array
+    */
+    protected $images = array();
+
     /**
      * a custom domain to use for tracking opens and clicks instead of mandrillapp.com
      *
@@ -482,6 +489,65 @@ public function addAttachmentFromPath($path, $type = '', $name = '') {
         return $this;
     }
 
+    /**
+     * Add images embedded in the message
+     *
+     * @param string $type - the MIME type of the image - must start with "image/"
+     * @param string $name - the Content-ID of the embedded image - use <img src="cid:THIS_VALUE"> to reference the image in your HTML content
+     * @param string $data - base64 encoded image data
+     *
+     * @return Message
+     */
+    public function addImage($type, $name, $data)
+    {
+        $this->images[] = array(
+            'type' => $type,
+            'name' => $name,
+            'content' => $data
+        );
+
+        return $this;
+    }
+
+    /**
+     * @param string $path - path to local or remote image file
+     * @param string $type - the MIME type of the image - must start with "image/" (optional)
+     * @param string $name - the Content-ID of the embedded image - use <img src="cid:THIS_VALUE"> to reference the image in your HTML content (optional)
+     * 
+     * @throws \Exception
+     * @return Message
+     */
+    public function addImageFromPath($path, $type = '', $name = '')
+    {
+        if (!is_readable($path)) {
+            throw new \Exception('cannot read file ' . $path);
+        }
+
+        $data = file_get_contents($path);
+
+        $base64data = base64_encode($data);
+
+        if (empty($name)) {
+            $name = basename($path);
+        }
+
+        if (empty($type)) {
+            // open fileinfo database
+            $finfo = finfo_open(FILEINFO_MIME, '/usr/share/misc/magic');
+
+            if (!$finfo) {
+                throw new \Exception('Opening fileinfo database failed, please specify type');
+            }
+
+            $type = finfo_file($finfo, $path);
+            finfo_close($finfo);
+        }
+
+        $this->addImage($type, $name, $base64data);
+
+        return $this;
+    }
+
     /**
      * an optional address to receive an exact copy of each recipient's email
      *
@@ -720,6 +786,14 @@ public function getAttachments()
         return $this->attachments;
     }
 
+    /**
+     * @return array
+     */
+    public function getImages()
+    {
+        return $this->images;
+    }
+    
     /**
      * @return boolean
      */

Tests/MessageTest.php

@@ -124,4 +124,16 @@ public function testSetSubaccount()
 
         $this->assertEquals($message->getSubaccount(), 'Subaccount Name');
     }
+    
+    public function testAddImage()
+    {
+        $message = new Message();
+        
+        $message->addImage('image/jpg', '1x1', '/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC4nICIsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL/2wBDAQkJCQwLDBgNDRgyIRwhMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjL/wAARCAABAAEDASIAAhEBAxEB/8QAFQABAQAAAAAAAAAAAAAAAAAAAAf/xAAUEAEAAAAAAAAAAAAAAAAAAAAA/8QAFAEBAAAAAAAAAAAAAAAAAAAAAP/EABQRAQAAAAAAAAAAAAAAAAAAAAD/2gAMAwEAAhEDEQA/AL+AD//Z');
+        
+        $images = $message->getImages();
+        
+        $this->assertEquals(1, count($images));
+        $this->assertEquals($images[0]['name'], '1x1');
+    }
 }