first commit of 2.0

laravel/view.php

@@ -0,0 +1,245 @@
+<?php namespace Laravel;
+
+class View {
+
+	/**
+	 * The name of the view.
+	 *
+	 * @var string
+	 */
+	public $view;
+
+	/**
+	 * The view data.
+	 *
+	 * @var array
+	 */
+	public $data = array();
+
+	/**
+	 * The module that contains the view.
+	 *
+	 * @var string
+	 */
+	public $module;
+
+	/**
+	 * The path to the view.
+	 *
+	 * @var string
+	 */
+	public $path;
+
+	/**
+	 * The defined view composers.
+	 *
+	 * @var array
+	 */
+	public static $composers;
+
+	/**
+	 * Create a new view instance.
+	 *
+	 * @param  string  $view
+	 * @param  array   $data
+	 * @return void
+	 */
+	public function __construct($view, $data = array())
+	{
+		$this->data = $data;
+
+		list($this->module, $this->path, $this->view) = static::parse($view);
+
+		$this->compose();
+	}
+
+	/**
+	 * Create a new view instance.
+	 *
+	 * @param  string  $view
+	 * @param  array   $data
+	 * @return View
+	 */
+	public static function make($view, $data = array())
+	{
+		return new static($view, $data);
+	}
+
+	/**
+	 * Create a new view instance from a view name.
+	 *
+	 * The view names for the active module will be searched first, followed by the view names
+	 * for the default module. Finally, the names for all modules will be searched.
+	 *
+	 * @param  string  $name
+	 * @param  array   $data
+	 * @return View
+	 */
+	protected static function of($name, $data = array())
+	{
+		foreach (array_unique(array_merge(array(ACTIVE_MODULE, DEFAULT_MODULE), Module::$modules)) as $module)
+		{
+			static::load_composers($module);
+
+			foreach (static::$composers[$module] as $key => $value)
+			{
+				if ($name === $value or (isset($value['name']) and $name === $value['name']))
+				{
+					return new static($key, $data);
+				}
+			}
+		}
+
+		throw new \Exception("Named view [$name] is not defined.");
+	}
+
+	/**
+	 * Parse a view identifier and get the module, path, and view name.
+	 *
+	 * @param  string  $view
+	 * @return array
+	 */
+	protected static function parse($view)
+	{
+		list($module, $view) = Module::parse($view);
+
+		return array($module, Module::path($module).'views/', $view);
+	}
+
+	/**
+	 * Call the composer for the view instance.
+	 *
+	 * @return void
+	 */
+	protected function compose()
+	{
+		static::load_composers($this->module);
+
+		if (isset(static::$composers[$this->module][$this->view]))
+		{
+			foreach ((array) static::$composers[$this->module][$this->view] as $key => $value)
+			{
+				if (is_callable($value)) return call_user_func($value, $this);
+			}
+		}
+	}
+
+	/**
+	 * Load the view composers for a given module.
+	 *
+	 * @param  string  $module
+	 * @return void
+	 */
+	protected static function load_composers($module)
+	{
+		if (isset(static::$composers[$module])) return;
+
+		$composers = Module::path($module).'composers'.EXT;
+
+		static::$composers[$module] = (file_exists($composers)) ? require $composers : array();
+	}
+
+	/**
+	 * Get the parsed content of the view.
+	 *
+	 * @return string
+	 */
+	public function get()
+	{
+		$view = str_replace('.', '/', $this->view);
+
+		if ( ! file_exists($this->path.$view.EXT))
+		{
+			Exception\Handler::make(new Exception("View [$view] does not exist."))->handle();
+		}
+
+		foreach ($this->data as &$data)
+		{
+			if ($data instanceof View or $data instanceof Response) $data = (string) $data;
+		}
+
+		ob_start() and extract($this->data, EXTR_SKIP);
+
+		try { include $this->path.$view.EXT; } catch (\Exception $e) { Exception\Handler::make($e)->handle(); }
+
+		return ob_get_clean();
+	}
+
+	/**
+	 * Add a view instance to the view data.
+	 *
+	 * @param  string  $key
+	 * @param  string  $view
+	 * @param  array   $data
+	 * @return View
+	 */
+	public function partial($key, $view, $data = array())
+	{
+		return $this->bind($key, new static($view, $data));
+	}
+
+	/**
+	 * Add a key / value pair to the view data.
+	 *
+	 * @param  string  $key
+	 * @param  mixed   $value
+	 * @return View
+	 */
+	public function bind($key, $value)
+	{
+		$this->data[$key] = $value;
+		return $this;
+	}
+
+	/**
+	 * Magic Method for handling the dynamic creation of named views.
+	 */
+	public static function __callStatic($method, $parameters)
+	{
+		if (strpos($method, 'of_') === 0)
+		{
+			return static::of(substr($method, 3), Arr::get($parameters, 0, array()));
+		}
+	}
+
+	/**
+	 * Magic Method for getting items from the view data.
+	 */
+	public function __get($key)
+	{
+		return $this->data[$key];
+	}
+
+	/**
+	 * Magic Method for setting items in the view data.
+	 */
+	public function __set($key, $value)
+	{
+		$this->bind($key, $value);
+	}
+
+	/**
+	 * Magic Method for determining if an item is in the view data.
+	 */
+	public function __isset($key)
+	{
+		return array_key_exists($key, $this->data);
+	}
+
+	/**
+	 * Magic Method for removing an item from the view data.
+	 */
+	public function __unset($key)
+	{
+		unset($this->data[$key]);
+	}
+
+	/**
+	 * Get the parsed content of the View.
+	 */
+	public function __toString()
+	{
+		return $this->get();
+	}
+
+}