version 2.2.0

Author: ddrv

README.md

@@ -1,3 +1,7 @@
+[![Latest Stable Version](https://poser.pugx.org/ddrv/mailer/v/stable?format=flat-square)](https://packagist.org/packages/ddrv/mailer)
+[![Total Downloads](https://poser.pugx.org/ddrv/mailer/downloads?format=flat-square)](https://packagist.org/packages/ddrv/mailer)
+[![License](https://poser.pugx.org/ddrv/mailer/license?format=flat-square)](https://packagist.org/packages/ddrv/mailer)
+
 # Mailer
 PHP Class for sending email.
 
@@ -73,4 +77,40 @@ $mailer->removeAddress('[email protected]');
  * Send email to addresses
  */
 $mailer->send();
-```
+```
+
+## Templates
+
+Content of file /path/to/template.tmpl:
+```text
+<h1>This template</h1>
+<p>Hello, {username}!</p>
+<p>This message generated automatically.</p>
+<p>{date}</p>
+```
+
+PHP code:
+```php
+/**
+ * You can using templates for your mails
+ */
+ 
+/**
+ * Add template from string
+ */
+$mailer->addTemplateFromString('tmpl1', '<p>Hello, {username}</p>');
+
+/**
+ * Add template from file
+ */
+$mailer->addTemplateFromFile('tmpl2', '/path/to/template.tmpl');
+
+/**
+ * Set body from template
+ */
+$context = [
+    'username' => 'Anonymous',
+    'date' => date('Y-m-d'),
+];
+$mailer->template('tmpl2',$context);
+```

composer.json

@@ -1,6 +1,6 @@
 {
     "name": "ddrv/mailer",
-    "version":"2.1.0",
+    "version":"2.2.0",
     "require":{
         "php":">=5.4.0"
     },

src/Mailer.php

@@ -15,6 +15,7 @@
  * @property array    $body
  * @property array    $attachments
  * @property array    $address
+ * @property array    $templates
  * @property string   $log
  * @property boolean  $smtp
  * @property resource $socket
@@ -23,7 +24,7 @@ class Mailer {
     /**
      * Version of Mailer
      */
-    const MAILER_VERSION = '2.1.0';
+    const MAILER_VERSION = '2.2.0';
 
     /**
      * End of line symbol
@@ -72,6 +73,13 @@ class Mailer {
      */
     protected $address;
 
+    /**
+     * Templates.
+     *
+     * @var array
+     */
+    protected $templates;
+
     /**
      * SMTP Socket.
      *
@@ -202,7 +210,7 @@ public function subject($subject)
     }
 
     /**
-     * Set body of message.
+     * Set body of message from string.
      *
      * @param string $text
      * @void
@@ -217,6 +225,38 @@ public function body($text)
         ];
     }
 
+    /**
+     * Set body of message from template.
+     *
+     * @param string $key
+     * @param array $context
+     * @void
+     */
+    public function template($key,$context)
+    {
+        $key = (string)$key;
+        $context = (array)$context;
+        if (empty($this->templates[$key]['type'])) return;
+        $text = '';
+        switch ($this->templates[$key]['type']) {
+            case 'string':
+                $text = (string)$this->templates[$key]['tmpl'];
+                break;
+            case 'file':
+                $text = is_readable($this->templates[$key]['tmpl'])?file_get_contents($this->templates[$key]['tmpl']):'';
+                break;
+        }
+        foreach ($context as $placeholder=>$value) {
+            $text = str_replace('{'.$placeholder.'}', $value, $text);
+        }
+        $this->body = [
+            'headers' => [
+                'Content-Type' => 'text/html; charset=utf8',
+            ],
+            'content' => $text,
+        ];
+    }
+
     /**
      * Add attachment from string.
      *
@@ -306,6 +346,44 @@ public function getLog()
         return $this->log;
     }
 
+    /**
+     * Add template from string
+     *
+     * @param string $key
+     * @param string $template
+     * @void
+     */
+    public function addTemplateFromString($key,$template)
+    {
+        $key = (string)$key;
+        $template = (string)$template;
+        if ($key && $template) {
+            $this->templates[$key] = [
+                'tmpl' => $template,
+                'type' => 'string',
+            ];
+        }
+    }
+
+    /**
+     * Add template from file
+     *
+     * @param string $key
+     * @param string $template
+     * @void
+     */
+    public function addTemplateFromFile($key,$template)
+    {
+        $key = (string)$key;
+        $template = (string)$template;
+        if ($key && is_readable($template)) {
+            $this->templates[$key] = [
+                'tmpl' => $template,
+                'type' => 'file',
+            ];
+        }
+    }
+
     /**
      * Reset body and headers for nex mail
      * @void