Allow mailable to be rendered directly to views.

This also makes Mailables “Renderable” allowing you to return them
directly from a route for easier viewing, etc.

Author: taylorotwell

src/Illuminate/Mail/Mailable.php

@@ -8,11 +8,12 @@
 use Illuminate\Support\Str;
 use Illuminate\Support\Collection;
 use Illuminate\Container\Container;
+use Illuminate\Contracts\Support\Renderable;
 use Illuminate\Contracts\Queue\Factory as Queue;
 use Illuminate\Contracts\Mail\Mailer as MailerContract;
 use Illuminate\Contracts\Mail\Mailable as MailableContract;
 
-class Mailable implements MailableContract
+class Mailable implements MailableContract, Renderable
 {
     /**
      * The person the message is from.
@@ -159,6 +160,20 @@ public function later($delay, Queue $queue)
         );
     }
 
+    /**
+     * Render the mailable into a view.
+     *
+     * @return \Illuminate\View\View
+     */
+    public function render()
+    {
+        Container::getInstance()->call([$this, 'build']);
+
+        return Container::getInstance()->make('mailer')->render(
+            $this->buildView(), $this->buildViewData()
+        );
+    }
+
     /**
      * Build the view for the message.
      *

src/Illuminate/Mail/Mailer.php

@@ -171,6 +171,25 @@ public function plain($view, array $data, $callback)
         return $this->send(['text' => $view], $data, $callback);
     }
 
+    /**
+     * Render the given message as a view.
+     *
+     * @param  string|array  $view
+     * @param  array  $data
+     * @return \Illuminate\View\View
+     */
+    public function render($view, array $data = [])
+    {
+        // First we need to parse the view, which could either be a string or an array
+        // containing both an HTML and plain text versions of the view which should
+        // be used when sending an e-mail. We will extract both of them out here.
+        list($view, $plain, $raw) = $this->parseView($view);
+
+        $data['message'] = $this->createMessage();
+
+        return $this->renderView($view, $data);
+    }
+
     /**
      * Send a new message using a view.
      *