2009-05-31 00:05:56 +03:00
|
|
|
<?php defined('SYSPATH') or die('No direct script access.');
|
2008-12-05 03:37:18 +02:00
|
|
|
/**
|
|
|
|
* Acts as an object wrapper for HTML pages with embedded PHP, called "views".
|
|
|
|
* Variables can be assigned with the view object and referenced locally within
|
|
|
|
* the view.
|
|
|
|
*
|
2009-03-21 00:01:47 +02:00
|
|
|
* @package Kohana
|
2008-12-05 03:37:18 +02:00
|
|
|
* @author Kohana Team
|
2009-02-28 13:40:13 +02:00
|
|
|
* @copyright (c) 2008-2009 Kohana Team
|
2008-12-05 03:37:18 +02:00
|
|
|
* @license http://kohanaphp.com/license.html
|
|
|
|
*/
|
|
|
|
class View_Core {
|
|
|
|
|
|
|
|
// Array of global variables
|
2009-03-21 00:17:32 +02:00
|
|
|
protected static $_global_data = array();
|
2008-12-05 03:37:18 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns a new View object.
|
|
|
|
*
|
|
|
|
* @chainable
|
|
|
|
* @param string view filename
|
|
|
|
* @param array array of values
|
|
|
|
* @return View
|
|
|
|
*/
|
2009-02-28 13:40:13 +02:00
|
|
|
public static function factory($file = NULL, array $data = NULL)
|
2008-12-05 03:37:18 +02:00
|
|
|
{
|
|
|
|
return new View($file, $data);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Captures the output that is generated when a view is included.
|
|
|
|
* The view data will be extracted to make local variables. This method
|
|
|
|
* is static to prevent object scope resolution.
|
|
|
|
*
|
|
|
|
* @param string filename
|
|
|
|
* @param array variables
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
protected static function capture($kohana_view_filename, array $kohana_view_data)
|
|
|
|
{
|
|
|
|
// Import the view variables to local namespace
|
|
|
|
extract($kohana_view_data, EXTR_SKIP);
|
|
|
|
|
|
|
|
// Capture the view output
|
|
|
|
ob_start();
|
|
|
|
|
2009-05-31 20:41:10 +03:00
|
|
|
try
|
|
|
|
{
|
|
|
|
// Load the view within the current scope
|
|
|
|
include $kohana_view_filename;
|
|
|
|
}
|
|
|
|
catch (Exception $e)
|
|
|
|
{
|
|
|
|
// Delete the output buffer
|
|
|
|
ob_end_clean();
|
|
|
|
|
|
|
|
// Re-throw the exception
|
|
|
|
throw $e;
|
|
|
|
}
|
2008-12-05 03:37:18 +02:00
|
|
|
|
|
|
|
// Get the captured output and close the buffer
|
|
|
|
return ob_get_clean();
|
|
|
|
}
|
|
|
|
|
|
|
|
// View filename
|
2009-03-21 00:17:32 +02:00
|
|
|
protected $_file;
|
2008-12-05 03:37:18 +02:00
|
|
|
|
|
|
|
// Array of local variables
|
2009-03-21 00:17:32 +02:00
|
|
|
protected $_data = array();
|
2008-12-05 03:37:18 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets the initial view filename and local data.
|
|
|
|
*
|
|
|
|
* @param string view filename
|
|
|
|
* @param array array of values
|
|
|
|
* @return void
|
|
|
|
*/
|
2009-02-28 13:40:13 +02:00
|
|
|
public function __construct($file = NULL, array $data = NULL)
|
2008-12-05 03:37:18 +02:00
|
|
|
{
|
|
|
|
if ( ! empty($file))
|
|
|
|
{
|
|
|
|
$this->set_filename($file);
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( ! empty($data))
|
|
|
|
{
|
2009-03-21 00:17:32 +02:00
|
|
|
$this->_data = array_merge($this->_data, $data);
|
2008-12-05 03:37:18 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Magic method, searches for the given variable and returns its value.
|
|
|
|
* Local variables will be returned before global variables.
|
|
|
|
*
|
|
|
|
* @param string variable name
|
|
|
|
* @return mixed
|
|
|
|
*/
|
|
|
|
public function __get($key)
|
|
|
|
{
|
2009-03-21 00:17:32 +02:00
|
|
|
if (isset($this->_data[$key]))
|
2008-12-05 03:37:18 +02:00
|
|
|
{
|
2009-03-21 00:17:32 +02:00
|
|
|
return $this->_data[$key];
|
2008-12-05 03:37:18 +02:00
|
|
|
}
|
2009-03-21 00:17:32 +02:00
|
|
|
elseif (isset(View::$_global_data[$key]))
|
2008-12-05 03:37:18 +02:00
|
|
|
{
|
2009-03-21 00:17:32 +02:00
|
|
|
return View::$_global_data[$key];
|
2008-12-05 03:37:18 +02:00
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Magic method, calls set() with the same parameters.
|
|
|
|
*
|
|
|
|
* @param string variable name
|
|
|
|
* @param mixed value
|
|
|
|
* @return void
|
|
|
|
*/
|
|
|
|
public function __set($key, $value)
|
|
|
|
{
|
|
|
|
$this->set($key, $value);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Magic method, returns the output of render(). If any exceptions are
|
|
|
|
* thrown, the exception output will be returned instead.
|
|
|
|
*
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
public function __toString()
|
|
|
|
{
|
|
|
|
try
|
|
|
|
{
|
|
|
|
return $this->render();
|
|
|
|
}
|
2009-04-19 21:42:34 +03:00
|
|
|
catch (Exception $e)
|
2008-12-05 03:37:18 +02:00
|
|
|
{
|
2009-04-19 21:42:34 +03:00
|
|
|
return (string) $e->getMessage().' in '.Kohana::debug_path($e->getFile()).' [ '.$e->getLine().' ]';
|
2008-12-05 03:37:18 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets the view filename. If the view file cannot be found, an exception
|
|
|
|
* will be thrown.
|
|
|
|
*
|
|
|
|
* @chainable
|
|
|
|
* @throws Kohana_Exception
|
|
|
|
* @param string filename
|
|
|
|
* @return View
|
|
|
|
*/
|
|
|
|
public function set_filename($file)
|
|
|
|
{
|
2009-04-28 00:20:18 +03:00
|
|
|
if ($path = Kohana::find_file('views', $file))
|
2008-12-05 03:37:18 +02:00
|
|
|
{
|
2009-04-28 00:20:18 +03:00
|
|
|
$this->_file = $path;
|
2008-12-05 03:37:18 +02:00
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
2009-04-28 00:20:18 +03:00
|
|
|
throw new Kohana_Exception('The requested :type :file was not found',
|
|
|
|
array(':type' => 'view', ':file' => $file));
|
2008-12-05 03:37:18 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Assigns a variable by name. Assigned values will be available as a
|
|
|
|
* variable within the view file:
|
|
|
|
*
|
|
|
|
* // This value can be accessed as $foo within the view
|
|
|
|
* $view->set('foo', 'my value');
|
|
|
|
*
|
|
|
|
* @chainable
|
|
|
|
* @param string variable name or an array of variables
|
|
|
|
* @param mixed value
|
|
|
|
* @return View
|
|
|
|
*/
|
|
|
|
public function set($key, $value = NULL)
|
|
|
|
{
|
|
|
|
if (is_array($key))
|
|
|
|
{
|
|
|
|
foreach ($key as $key2 => $value)
|
|
|
|
{
|
2009-03-21 00:17:32 +02:00
|
|
|
$this->_data[$key2] = $value;
|
2008-12-05 03:37:18 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
2009-03-21 00:17:32 +02:00
|
|
|
$this->_data[$key] = $value;
|
2008-12-05 03:37:18 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Exactly the same as set, but assigns the value globally.
|
|
|
|
*
|
|
|
|
* @chainable
|
|
|
|
* @param string variable name or an array of variables
|
|
|
|
* @param mixed value
|
|
|
|
* @return View
|
|
|
|
*/
|
|
|
|
public function set_global($key, $value = NULL)
|
|
|
|
{
|
|
|
|
if (is_array($key))
|
|
|
|
{
|
|
|
|
foreach ($key as $key2 => $value)
|
|
|
|
{
|
2009-03-21 00:17:32 +02:00
|
|
|
View::$_global_data[$key2] = $value;
|
2008-12-05 03:37:18 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
2009-03-21 00:17:32 +02:00
|
|
|
View::$_global_data[$key] = $value;
|
2008-12-05 03:37:18 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Assigns a value by reference. The benefit of binding is that values can
|
|
|
|
* be altered without re-setting them. It is also possible to bind variables
|
|
|
|
* before they have values. Assigned values will be available as a
|
|
|
|
* variable within the view file:
|
|
|
|
*
|
|
|
|
* // This reference can be accessed as $ref within the view
|
|
|
|
* $view->bind('ref', $bar);
|
|
|
|
*
|
|
|
|
* @chainable
|
|
|
|
* @param string variable name
|
|
|
|
* @param mixed referenced variable
|
|
|
|
* @return View
|
|
|
|
*/
|
|
|
|
public function bind($key, & $value)
|
|
|
|
{
|
2009-03-21 00:17:32 +02:00
|
|
|
$this->_data[$key] =& $value;
|
2008-12-05 03:37:18 +02:00
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Exactly the same as bind, but assigns the value globally.
|
|
|
|
*
|
|
|
|
* @chainable
|
|
|
|
* @param string variable name
|
|
|
|
* @param mixed referenced variable
|
|
|
|
* @return View
|
|
|
|
*/
|
|
|
|
public function bind_global($key, & $value)
|
|
|
|
{
|
2009-03-21 00:17:32 +02:00
|
|
|
View::$_global_data[$key] =& $value;
|
2008-12-05 03:37:18 +02:00
|
|
|
|
|
|
|
return $this;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Renders the view object to a string. Global and local data are merged
|
|
|
|
* and extracted to create local variables within the view file.
|
|
|
|
* Optionally, the view filename can be set before rendering.
|
|
|
|
*
|
|
|
|
* @throws Kohana_Exception
|
|
|
|
* @param string filename
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
public function render($file = NULL)
|
|
|
|
{
|
|
|
|
if ( ! empty($file))
|
|
|
|
{
|
|
|
|
$this->set_filename($file);
|
|
|
|
}
|
|
|
|
|
2009-03-21 00:17:32 +02:00
|
|
|
if (empty($this->_file))
|
2008-12-05 03:37:18 +02:00
|
|
|
{
|
2009-03-21 00:17:32 +02:00
|
|
|
// The user has not specified a view file yet
|
|
|
|
throw new Kohana_Exception('No file specified for view, unable to render');
|
2008-12-05 03:37:18 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
// Combine global and local data. Global variables with the same name
|
|
|
|
// will be overwritten by local variables.
|
2009-03-21 00:17:32 +02:00
|
|
|
$data = array_merge(View::$_global_data, $this->_data);
|
2008-12-05 03:37:18 +02:00
|
|
|
|
2009-03-21 00:17:32 +02:00
|
|
|
return View::capture($this->_file, $data);
|
2008-12-05 03:37:18 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
} // End View
|