Files
spa-api/laravel/view.php

363 lines
7.1 KiB
PHP
Raw Normal View History

2011-08-18 20:21:37 -05:00
<?php namespace Laravel;
2011-06-08 23:45:08 -05:00
2011-09-21 21:46:16 -05:00
class View_Factory {
2011-08-26 21:42:04 -05:00
2011-08-29 19:27:02 -05:00
/**
2011-09-21 21:46:16 -05:00
* The directory containing the views.
2011-08-29 19:27:02 -05:00
*
* @var string
2011-08-29 19:27:02 -05:00
*/
2011-09-21 21:46:16 -05:00
public $path;
/**
2011-09-21 21:46:16 -05:00
* The view composer instance.
2011-08-29 19:27:02 -05:00
*
2011-09-21 21:46:16 -05:00
* @var View_Composer
2011-08-29 19:27:02 -05:00
*/
2011-09-21 21:46:16 -05:00
protected $composer;
2011-08-29 19:27:02 -05:00
2011-08-26 21:42:04 -05:00
/**
2011-09-21 21:46:16 -05:00
* Create a new view factory instance.
2011-08-26 21:42:04 -05:00
*
2011-09-21 21:46:16 -05:00
* @param View_Composer $composer
* @param string $path
2011-08-26 21:42:04 -05:00
* @return void
*/
2011-09-21 21:46:16 -05:00
public function __construct(View_Composer $composer, $path)
2011-08-26 21:42:04 -05:00
{
2011-09-21 21:46:16 -05:00
$this->path = $path;
$this->composer = $composer;
2011-08-26 21:42:04 -05:00
}
/**
* Create a new view instance.
*
2011-09-21 21:46:16 -05:00
* The name of the view given to this method should correspond to a view
* within your application views directory. Dots or slashes may used to
* reference views within sub-directories.
*
* @param string $view
* @param array $data
* @return View
*/
2011-09-21 21:46:16 -05:00
public function make($view, $data = array())
{
2011-09-21 21:46:16 -05:00
return new View($this, $this->composer, $view, $data, $this->path($view));
}
2011-08-26 21:42:04 -05:00
/**
* Create a new view instance from a view name.
*
2011-09-08 17:49:16 -05:00
* View names are defined in the application composers file.
*
2011-08-26 21:42:04 -05:00
* @param string $name
* @param array $data
* @return View
*/
2011-09-21 21:46:16 -05:00
protected function of($name, $data = array())
2011-08-26 21:42:04 -05:00
{
2011-09-21 21:46:16 -05:00
if ( ! is_null($view = $this->composer->name($name)))
2011-08-26 21:42:04 -05:00
{
2011-09-21 21:46:16 -05:00
return $this->make($view, $data);
2011-08-26 21:42:04 -05:00
}
throw new \Exception("Named view [$name] is not defined.");
}
2011-08-29 00:07:10 -05:00
/**
* Get the path to a given view on disk.
*
* @param string $view
* @return string
*/
protected function path($view)
{
2011-09-08 17:49:16 -05:00
$view = str_replace('.', '/', $view);
2011-09-21 21:46:16 -05:00
if (file_exists($path = $this->path.$view.BLADE_EXT))
2011-09-08 17:49:16 -05:00
{
return $path;
}
2011-09-21 21:46:16 -05:00
elseif (file_exists($path = $this->path.$view.EXT))
2011-09-08 17:49:16 -05:00
{
return $path;
}
throw new \Exception('View ['.$view.'] does not exist.');
2011-08-29 00:07:10 -05:00
}
2011-09-21 21:46:16 -05:00
/**
* Magic Method for handling the dynamic creation of named views.
*/
public function __call($method, $parameters)
{
if (strpos($method, 'of_') === 0)
{
return $this->of(substr($method, 3), Arr::get($parameters, 0, array()));
}
}
}
class View_Composer {
/**
* The view composers.
*
* @var array
*/
protected $composers;
/**
* Create a new view composer instance.
*
* @param array $composers
* @return void
*/
public function __construct($composers)
{
$this->composers = $composers;
}
/**
* Find the key for a view by name.
*
* @param string $name
* @return string
*/
public function name($name)
{
foreach ($this->composers as $key => $value)
{
if ($name === $value or (isset($value['name']) and $name === $value['name'])) { return $key; }
}
}
/**
* Call the composer for the view instance.
*
* @param View $view
* @return void
*/
public function compose(View $view)
{
if (isset($this->composers['shared'])) call_user_func($this->composers['shared'], $view);
if (isset($this->composers[$view->view]))
{
foreach ((array) $this->composers[$view->view] as $key => $value)
{
if ($value instanceof \Closure) return call_user_func($value, $view);
}
}
}
}
class View {
/**
* The name of the view.
*
* @var string
*/
public $view;
/**
* The view data.
*
* @var array
*/
public $data;
/**
* The path to the view on disk.
*
* @var string
*/
protected $path;
/**
* The view composer instance.
*
* @var View_Composer
*/
protected $composer;
/**
* The view factory instance, which is used to create sub-views.
*
* @var View_Factory
*/
protected $factory;
/**
* Create a new view instance.
*
* @param View_Factory $factory
* @param View_Composer $composer
* @param string $view
* @param array $data
* @param string $path
* @return void
*/
public function __construct(View_Factory $factory, View_Composer $composer, $view, $data, $path)
{
$this->view = $view;
$this->data = $data;
$this->path = $path;
$this->factory = $factory;
$this->composer = $composer;
}
/**
* Create a new view instance.
*
* The name of the view given to this method should correspond to a view
* within your application views directory. Dots or slashes may used to
* reference views within sub-directories.
*
* @param string $view
* @param array $data
* @return View
*/
public static function make($view, $data = array())
{
return IoC::container()->resolve('laravel.view')->make($view, $data);
}
/**
* Create a new view instance from a view name.
*
* View names are defined in the application composers file.
*
* @param string $name
* @param array $data
* @return View
*/
protected function of($name, $data = array())
{
return IoC::container()->resolve('laravel.view')->of($name, $data);
}
2011-08-05 11:11:26 -05:00
/**
* Get the evaluated string content of the view.
2011-06-08 23:45:08 -05:00
*
* If the view has a composer, it will be executed. All sub-views and responses will
* also be evaluated and converted to their string values.
*
2011-06-08 23:45:08 -05:00
* @return string
*/
public function render()
2011-06-08 23:45:08 -05:00
{
2011-09-21 21:46:16 -05:00
$this->composer->compose($this);
2011-08-05 13:21:31 -05:00
foreach ($this->data as &$data)
{
2011-08-26 21:42:04 -05:00
if ($data instanceof View or $data instanceof Response) $data = $data->render();
}
2011-08-08 14:54:54 -05:00
ob_start() and extract($this->data, EXTR_SKIP);
2011-06-08 23:45:08 -05:00
2011-09-21 21:46:16 -05:00
$file = ($this->bladed()) ? $this->compile() : $this->path;
2011-09-08 17:49:16 -05:00
2011-09-21 21:46:16 -05:00
try { include $file; } catch (Exception $e) { ob_get_clean(); throw $e; }
2011-06-08 23:45:08 -05:00
return ob_get_clean();
}
2011-09-08 17:49:16 -05:00
/**
* Determine if the view is using the blade view engine.
*
* @return bool
*/
protected function bladed()
{
return (strpos($this->path, '.blade'.EXT) !== false);
}
/**
2011-09-21 21:46:16 -05:00
* Compile the Bladed view and return the path to the compiled view.
*
2011-09-21 21:46:16 -05:00
* If view will only be re-compiled if the view has been modified since the last compiled
* version of the view was created or no compiled view exists. Otherwise, the path will
* be returned without re-compiling.
2011-09-08 17:49:16 -05:00
*
2011-09-21 21:46:16 -05:00
* @return string
*/
protected function compile()
{
$compiled = $this->factory->path.'compiled/'.md5($this->view);
if ((file_exists($compiled) and filemtime($this->path) > filemtime($compiled)) or ! file_exists($compiled))
{
file_put_contents($compiled, Blade::parse($this->path));
}
return $path;
}
/**
* Add a view instance to the view data.
2011-09-08 17:49:16 -05:00
*
* @param string $key
* @param string $view
* @param array $data
* @return View
*/
public function partial($key, $view, $data = array())
{
2011-09-21 21:46:16 -05:00
return $this->with($key, $this->factory->make($view, $data));
}
/**
* Add a key / value pair to the view data.
*
* Bound data will be available to the view as variables.
*
* @param string $key
* @param mixed $value
* @return View
*/
public function with($key, $value)
{
$this->data[$key] = $value;
2011-09-21 21:46:16 -05:00
return $this;
}
2011-06-08 23:45:08 -05:00
/**
* 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->with($key, $value);
2011-06-08 23:45:08 -05:00
}
/**
* 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]);
}
2011-09-21 21:46:16 -05:00
}