mirror of
https://github.com/kamilwylegala/cakephp2-php8.git
synced 2024-11-15 11:28:25 +00:00
6c902a19b3
Fixes exceptions being raised when you tried to render elements inside blocks. Instead compare the number of open blocks. This should not change before/after rendering a view.
1062 lines
29 KiB
PHP
1062 lines
29 KiB
PHP
<?php
|
|
/**
|
|
* Methods for displaying presentation data in the view.
|
|
*
|
|
* PHP 5
|
|
*
|
|
* CakePHP(tm) : Rapid Development Framework (http://cakephp.org)
|
|
* Copyright 2005-2011, Cake Software Foundation, Inc. (http://cakefoundation.org)
|
|
*
|
|
* Licensed under The MIT License
|
|
* Redistributions of files must retain the above copyright notice.
|
|
*
|
|
* @copyright Copyright 2005-2011, Cake Software Foundation, Inc. (http://cakefoundation.org)
|
|
* @link http://cakephp.org CakePHP(tm) Project
|
|
* @package Cake.View
|
|
* @since CakePHP(tm) v 0.10.0.1076
|
|
* @license MIT License (http://www.opensource.org/licenses/mit-license.php)
|
|
*/
|
|
|
|
App::uses('HelperCollection', 'View');
|
|
App::uses('AppHelper', 'View/Helper');
|
|
App::uses('Router', 'Routing');
|
|
App::uses('ViewBlock', 'View');
|
|
App::uses('CakeEvent', 'Event');
|
|
App::uses('CakeEventManager', 'Event');
|
|
|
|
/**
|
|
* View, the V in the MVC triad. View interacts with Helpers and view variables passed
|
|
* in from the controller to render the results of the controller action. Often this is HTML,
|
|
* but can also take the form of JSON, XML, PDF's or streaming files.
|
|
*
|
|
* CakePHP uses a two-step-view pattern. This means that the view content is rendered first,
|
|
* and then inserted into the selected layout. This also means you can pass data from the view to the
|
|
* layout using `$this->set()`
|
|
*
|
|
*
|
|
* @package Cake.View
|
|
* @property CacheHelper $Cache
|
|
* @property FormHelper $Form
|
|
* @property HtmlHelper $Html
|
|
* @property JsHelper $Js
|
|
* @property NumberHelper $Number
|
|
* @property PaginatorHelper $Paginator
|
|
* @property RssHelper $Rss
|
|
* @property SessionHelper $Session
|
|
* @property TextHelper $Text
|
|
* @property TimeHelper $Time
|
|
* @property ViewBlock $Blocks
|
|
*/
|
|
class View extends Object {
|
|
|
|
/**
|
|
* Helpers collection
|
|
*
|
|
* @var HelperCollection
|
|
*/
|
|
public $Helpers;
|
|
|
|
/**
|
|
* ViewBlock instance.
|
|
*
|
|
* @var ViewBlock
|
|
*/
|
|
public $Blocks;
|
|
|
|
/**
|
|
* Name of the plugin.
|
|
*
|
|
* @link http://manual.cakephp.org/chapter/plugins
|
|
* @var string
|
|
*/
|
|
public $plugin = null;
|
|
|
|
/**
|
|
* Name of the controller.
|
|
*
|
|
* @var string Name of controller
|
|
*/
|
|
public $name = null;
|
|
|
|
/**
|
|
* Current passed params
|
|
*
|
|
* @var mixed
|
|
*/
|
|
public $passedArgs = array();
|
|
|
|
/**
|
|
* An array of names of built-in helpers to include.
|
|
*
|
|
* @var mixed A single name as a string or a list of names as an array.
|
|
*/
|
|
public $helpers = array('Html');
|
|
|
|
/**
|
|
* Path to View.
|
|
*
|
|
* @var string Path to View
|
|
*/
|
|
public $viewPath = null;
|
|
|
|
/**
|
|
* Variables for the view
|
|
*
|
|
* @var array
|
|
*/
|
|
public $viewVars = array();
|
|
|
|
/**
|
|
* Name of view to use with this View.
|
|
*
|
|
* @var string
|
|
*/
|
|
public $view = null;
|
|
|
|
/**
|
|
* Name of layout to use with this View.
|
|
*
|
|
* @var string
|
|
*/
|
|
public $layout = 'default';
|
|
|
|
/**
|
|
* Path to Layout.
|
|
*
|
|
* @var string Path to Layout
|
|
*/
|
|
public $layoutPath = null;
|
|
|
|
/**
|
|
* Turns on or off Cake's conventional mode of applying layout files. On by default.
|
|
* Setting to off means that layouts will not be automatically applied to rendered views.
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $autoLayout = true;
|
|
|
|
/**
|
|
* File extension. Defaults to Cake's template ".ctp".
|
|
*
|
|
* @var string
|
|
*/
|
|
public $ext = '.ctp';
|
|
|
|
/**
|
|
* Sub-directory for this view file. This is often used for extension based routing.
|
|
* Eg. With an `xml` extension, $subDir would be `xml/`
|
|
*
|
|
* @var string
|
|
*/
|
|
public $subDir = null;
|
|
|
|
/**
|
|
* Theme name. If you are using themes, you should remember to use ThemeView as well.
|
|
*
|
|
* @var string
|
|
*/
|
|
public $theme = null;
|
|
|
|
/**
|
|
* Used to define methods a controller that will be cached.
|
|
*
|
|
* @see Controller::$cacheAction
|
|
* @var mixed
|
|
*/
|
|
public $cacheAction = false;
|
|
|
|
/**
|
|
* Holds current errors for the model validation.
|
|
*
|
|
* @var array
|
|
*/
|
|
public $validationErrors = array();
|
|
|
|
/**
|
|
* True when the view has been rendered.
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $hasRendered = false;
|
|
|
|
/**
|
|
* List of generated DOM UUIDs.
|
|
*
|
|
* @var array
|
|
*/
|
|
public $uuids = array();
|
|
|
|
/**
|
|
* An instance of a CakeRequest object that contains information about the current request.
|
|
* This object contains all the information about a request and several methods for reading
|
|
* additional information about the request.
|
|
*
|
|
* @var CakeRequest
|
|
*/
|
|
public $request;
|
|
|
|
/**
|
|
* The Cache configuration View will use to store cached elements. Changing this will change
|
|
* the default configuration elements are stored under. You can also choose a cache config
|
|
* per element.
|
|
*
|
|
* @var string
|
|
* @see View::element()
|
|
*/
|
|
public $elementCache = 'default';
|
|
|
|
/**
|
|
* List of variables to collect from the associated controller.
|
|
*
|
|
* @var array
|
|
*/
|
|
protected $_passedVars = array(
|
|
'viewVars', 'autoLayout', 'ext', 'helpers', 'view', 'layout', 'name',
|
|
'layoutPath', 'viewPath', 'request', 'plugin', 'passedArgs', 'cacheAction'
|
|
);
|
|
|
|
/**
|
|
* Scripts (and/or other <head /> tags) for the layout.
|
|
*
|
|
* @var array
|
|
*/
|
|
protected $_scripts = array();
|
|
|
|
/**
|
|
* Holds an array of paths.
|
|
*
|
|
* @var array
|
|
*/
|
|
protected $_paths = array();
|
|
|
|
/**
|
|
* Indicate that helpers have been loaded.
|
|
*
|
|
* @var boolean
|
|
*/
|
|
protected $_helpersLoaded = false;
|
|
|
|
/**
|
|
* The names of views and their parents used with View::extend();
|
|
*
|
|
* @var array
|
|
*/
|
|
protected $_parents = array();
|
|
|
|
/**
|
|
* The currently rendering view file. Used for resolving parent files.
|
|
*
|
|
* @var string
|
|
*/
|
|
protected $_current = null;
|
|
|
|
/**
|
|
* Currently rendering an element. Used for finding parent fragments
|
|
* for elements.
|
|
*
|
|
* @var string
|
|
*/
|
|
protected $_currentType = '';
|
|
|
|
/**
|
|
* Content stack, used for nested templates that all use View::extend();
|
|
*
|
|
* @var array
|
|
*/
|
|
protected $_stack = array();
|
|
|
|
/**
|
|
* Instance of the CakeEventManager this View object is using
|
|
* to dispatch inner events. Usually the manager is shared with
|
|
* the controller, so it it possible to register view events in
|
|
* the controller layer.
|
|
*
|
|
* @var CakeEventManager
|
|
*/
|
|
protected $_eventManager = null;
|
|
|
|
/**
|
|
* Whether the event manager was already configured for this object
|
|
*
|
|
* @var boolean
|
|
*/
|
|
protected $_eventManagerConfigured = false;
|
|
|
|
const TYPE_VIEW = 'view';
|
|
const TYPE_ELEMENT = 'element';
|
|
const TYPE_LAYOUT = 'layout';
|
|
|
|
/**
|
|
* Constructor
|
|
*
|
|
* @param Controller $controller A controller object to pull View::_passedVars from.
|
|
*/
|
|
public function __construct($controller) {
|
|
if (is_object($controller)) {
|
|
$count = count($this->_passedVars);
|
|
for ($j = 0; $j < $count; $j++) {
|
|
$var = $this->_passedVars[$j];
|
|
$this->{$var} = $controller->{$var};
|
|
}
|
|
$this->_eventManager = $controller->getEventManager();
|
|
}
|
|
$this->Helpers = new HelperCollection($this);
|
|
$this->Blocks = new ViewBlock();
|
|
parent::__construct();
|
|
}
|
|
|
|
/**
|
|
* Returns the CakeEventManager manager instance that is handling any callbacks.
|
|
* You can use this instance to register any new listeners or callbacks to the
|
|
* controller events, or create your own events and trigger them at will.
|
|
*
|
|
* @return CakeEventManager
|
|
*/
|
|
public function getEventManager() {
|
|
if (empty($this->_eventManager) || !$this->_eventManagerConfigured) {
|
|
$this->_eventManager = new CakeEventManager();
|
|
$this->_eventManager->attach($this->Helpers);
|
|
$this->_eventManagerConfigured = true;
|
|
}
|
|
return $this->_eventManager;
|
|
}
|
|
|
|
/**
|
|
* Renders a piece of PHP with provided parameters and returns HTML, XML, or any other string.
|
|
*
|
|
* This realizes the concept of Elements, (or "partial layouts") and the $params array is used to send
|
|
* data to be used in the element. Elements can be cached improving performance by using the `cache` option.
|
|
*
|
|
* @param string $name Name of template file in the/app/View/Elements/ folder,
|
|
* or `MyPlugin.template` to use the template element from MyPlugin. If the element
|
|
* is not found in the plugin, the normal view path cascade will be searched.
|
|
* @param array $data Array of data to be made available to the rendered view (i.e. the Element)
|
|
* @param array $options Array of options. Possible keys are:
|
|
* - `cache` - Can either be `true`, to enable caching using the config in View::$elementCache. Or an array
|
|
* If an array, the following keys can be used:
|
|
* - `config` - Used to store the cached element in a custom cache configuration.
|
|
* - `key` - Used to define the key used in the Cache::write(). It will be prefixed with `element_`
|
|
* - `plugin` - Load an element from a specific plugin. This option is deprecated, see below.
|
|
* - `callbacks` - Set to true to fire beforeRender and afterRender helper callbacks for this element.
|
|
* Defaults to false.
|
|
* @return string Rendered Element
|
|
* @deprecated The `$options['plugin']` is deprecated and will be removed in CakePHP 3.0. Use
|
|
* `Plugin.element_name` instead.
|
|
*/
|
|
public function element($name, $data = array(), $options = array()) {
|
|
$file = $plugin = $key = null;
|
|
$callbacks = false;
|
|
|
|
if (isset($options['plugin'])) {
|
|
$name = Inflector::camelize($options['plugin']) . '.' . $name;
|
|
}
|
|
|
|
if (isset($options['callbacks'])) {
|
|
$callbacks = $options['callbacks'];
|
|
}
|
|
|
|
if (isset($options['cache'])) {
|
|
$underscored = null;
|
|
if ($plugin) {
|
|
$underscored = Inflector::underscore($plugin);
|
|
}
|
|
$keys = array_merge(array($underscored, $name), array_keys($options), array_keys($data));
|
|
$caching = array(
|
|
'config' => $this->elementCache,
|
|
'key' => implode('_', $keys)
|
|
);
|
|
if (is_array($options['cache'])) {
|
|
$defaults = array(
|
|
'config' => $this->elementCache,
|
|
'key' => $caching['key']
|
|
);
|
|
$caching = array_merge($defaults, $options['cache']);
|
|
}
|
|
$key = 'element_' . $caching['key'];
|
|
$contents = Cache::read($key, $caching['config']);
|
|
if ($contents !== false) {
|
|
return $contents;
|
|
}
|
|
}
|
|
|
|
$file = $this->_getElementFilename($name);
|
|
|
|
if ($file) {
|
|
if (!$this->_helpersLoaded) {
|
|
$this->loadHelpers();
|
|
}
|
|
if ($callbacks) {
|
|
$this->getEventManager()->dispatch(new CakeEvent('View.beforeRender', $this, array($file)));
|
|
}
|
|
|
|
$this->_currentType = self::TYPE_ELEMENT;
|
|
$element = $this->_render($file, array_merge($this->viewVars, $data));
|
|
|
|
if ($callbacks) {
|
|
$this->getEventManager()->dispatch(new CakeEvent('View.afterRender', $this, array($file, $element)));
|
|
}
|
|
if (isset($options['cache'])) {
|
|
Cache::write($key, $element, $caching['config']);
|
|
}
|
|
return $element;
|
|
}
|
|
$file = 'Elements' . DS . $name . $this->ext;
|
|
|
|
if (Configure::read('debug') > 0) {
|
|
return "Element Not Found: " . $file;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Renders view for given view file and layout.
|
|
*
|
|
* Render triggers helper callbacks, which are fired before and after the view are rendered,
|
|
* as well as before and after the layout. The helper callbacks are called:
|
|
*
|
|
* - `beforeRender`
|
|
* - `afterRender`
|
|
* - `beforeLayout`
|
|
* - `afterLayout`
|
|
*
|
|
* If View::$autoRender is false and no `$layout` is provided, the view will be returned bare.
|
|
*
|
|
* View and layout names can point to plugin views/layouts. Using the `Plugin.view` syntax
|
|
* a plugin view/layout can be used instead of the app ones. If the chosen plugin is not found
|
|
* the view will be located along the regular view path cascade.
|
|
*
|
|
* @param string $view Name of view file to use
|
|
* @param string $layout Layout to use.
|
|
* @return string Rendered Element
|
|
* @throws CakeException if there is an error in the view.
|
|
*/
|
|
public function render($view = null, $layout = null) {
|
|
if ($this->hasRendered) {
|
|
return true;
|
|
}
|
|
if (!$this->_helpersLoaded) {
|
|
$this->loadHelpers();
|
|
}
|
|
$this->Blocks->set('content', '');
|
|
|
|
if ($view !== false && $viewFileName = $this->_getViewFileName($view)) {
|
|
$this->_currentType = self::TYPE_VIEW;
|
|
$this->getEventManager()->dispatch(new CakeEvent('View.beforeRender', $this, array($viewFileName)));
|
|
$this->Blocks->set('content', $this->_render($viewFileName));
|
|
$this->getEventManager()->dispatch(new CakeEvent('View.afterRender', $this, array($viewFileName)));
|
|
}
|
|
|
|
if ($layout === null) {
|
|
$layout = $this->layout;
|
|
}
|
|
if ($layout && $this->autoLayout) {
|
|
$this->Blocks->set('content', $this->renderLayout('', $layout));
|
|
}
|
|
$this->hasRendered = true;
|
|
return $this->Blocks->get('content');
|
|
}
|
|
|
|
/**
|
|
* Renders a layout. Returns output from _render(). Returns false on error.
|
|
* Several variables are created for use in layout.
|
|
*
|
|
* - `title_for_layout` - A backwards compatible place holder, you should set this value if you want more control.
|
|
* - `content_for_layout` - contains rendered view file
|
|
* - `scripts_for_layout` - Contains content added with addScript() as well as any content in
|
|
* the 'meta', 'css', and 'script' blocks. They are appended in that order.
|
|
*
|
|
* Deprecated features:
|
|
*
|
|
* - `$scripts_for_layout` is deprecated and will be removed in CakePHP 3.0.
|
|
* Use the block features instead. `meta`, `css` and `script` will be populated
|
|
* by the matching methods on HtmlHelper.
|
|
* - `$title_for_layout` is deprecated and will be removed in CakePHP 3.0
|
|
* - `$content_for_layout` is deprecated and will be removed in CakePHP 3.0.
|
|
* Use the `content` block instead.
|
|
*
|
|
* @param string $content Content to render in a view, wrapped by the surrounding layout.
|
|
* @param string $layout Layout name
|
|
* @return mixed Rendered output, or false on error
|
|
* @throws CakeException if there is an error in the view.
|
|
*/
|
|
public function renderLayout($content, $layout = null) {
|
|
$layoutFileName = $this->_getLayoutFileName($layout);
|
|
if (empty($layoutFileName)) {
|
|
return $this->Blocks->get('content');
|
|
}
|
|
|
|
if (!$this->_helpersLoaded) {
|
|
$this->loadHelpers();
|
|
}
|
|
if (empty($content)) {
|
|
$content = $this->Blocks->get('content');
|
|
}
|
|
$this->getEventManager()->dispatch(new CakeEvent('View.beforeLayout', $this, array($layoutFileName)));
|
|
|
|
$scripts = implode("\n\t", $this->_scripts);
|
|
$scripts .= $this->Blocks->get('meta') . $this->Blocks->get('css') . $this->Blocks->get('script');
|
|
|
|
$this->viewVars = array_merge($this->viewVars, array(
|
|
'content_for_layout' => $content,
|
|
'scripts_for_layout' => $scripts,
|
|
));
|
|
|
|
if (!isset($this->viewVars['title_for_layout'])) {
|
|
$this->viewVars['title_for_layout'] = Inflector::humanize($this->viewPath);
|
|
}
|
|
|
|
$this->_currentType = self::TYPE_LAYOUT;
|
|
$this->Blocks->set('content', $this->_render($layoutFileName));
|
|
|
|
$this->getEventManager()->dispatch(new CakeEvent('View.afterLayout', $this, array($layoutFileName)));
|
|
return $this->Blocks->get('content');
|
|
}
|
|
|
|
/**
|
|
* Render cached view. Works in concert with CacheHelper and Dispatcher to
|
|
* render cached view files.
|
|
*
|
|
* @param string $filename the cache file to include
|
|
* @param string $timeStart the page render start time
|
|
* @return boolean Success of rendering the cached file.
|
|
*/
|
|
public function renderCache($filename, $timeStart) {
|
|
ob_start();
|
|
include ($filename);
|
|
|
|
if (Configure::read('debug') > 0 && $this->layout != 'xml') {
|
|
echo "<!-- Cached Render Time: " . round(microtime(true) - $timeStart, 4) . "s -->";
|
|
}
|
|
$out = ob_get_clean();
|
|
|
|
if (preg_match('/^<!--cachetime:(\\d+)-->/', $out, $match)) {
|
|
if (time() >= $match['1']) {
|
|
@unlink($filename);
|
|
unset ($out);
|
|
return false;
|
|
} else {
|
|
if ($this->layout === 'xml') {
|
|
header('Content-type: text/xml');
|
|
}
|
|
$commentLength = strlen('<!--cachetime:' . $match['1'] . '-->');
|
|
echo substr($out, $commentLength);
|
|
return true;
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns a list of variables available in the current View context
|
|
*
|
|
* @return array Array of the set view variable names.
|
|
*/
|
|
public function getVars() {
|
|
return array_keys($this->viewVars);
|
|
}
|
|
|
|
/**
|
|
* Returns the contents of the given View variable(s)
|
|
*
|
|
* @param string $var The view var you want the contents of.
|
|
* @return mixed The content of the named var if its set, otherwise null.
|
|
* @deprecated Will be removed in 3.0 Use View::get() instead.
|
|
*/
|
|
public function getVar($var) {
|
|
return $this->get($var);
|
|
}
|
|
|
|
/**
|
|
* Returns the contents of the given View variable or a block.
|
|
* Blocks are checked before view variables.
|
|
*
|
|
* @param string $var The view var you want the contents of.
|
|
* @return mixed The content of the named var if its set, otherwise null.
|
|
*/
|
|
public function get($var) {
|
|
if (!isset($this->viewVars[$var])) {
|
|
return null;
|
|
}
|
|
return $this->viewVars[$var];
|
|
}
|
|
|
|
/**
|
|
* Get the names of all the existing blocks.
|
|
*
|
|
* @return array An array containing the blocks.
|
|
* @see ViewBlock::keys()
|
|
*/
|
|
public function blocks() {
|
|
return $this->Blocks->keys();
|
|
}
|
|
|
|
/**
|
|
* Start capturing output for a 'block'
|
|
*
|
|
* @param string $name The name of the block to capture for.
|
|
* @return void
|
|
* @see ViewBlock::start()
|
|
*/
|
|
public function start($name) {
|
|
return $this->Blocks->start($name);
|
|
}
|
|
|
|
/**
|
|
* Append to an existing or new block. Appending to a new
|
|
* block will create the block.
|
|
*
|
|
* @param string $name Name of the block
|
|
* @param string $value The content for the block.
|
|
* @return void
|
|
* @throws CakeException when you use non-string values.
|
|
* @see ViewBlock::append()
|
|
*/
|
|
public function append($name, $value = null) {
|
|
return $this->Blocks->append($name, $value);
|
|
}
|
|
|
|
/**
|
|
* Set the content for a block. This will overwrite any
|
|
* existing content.
|
|
*
|
|
* @param string $name Name of the block
|
|
* @param string $value The content for the block.
|
|
* @return void
|
|
* @throws CakeException when you use non-string values.
|
|
* @see ViewBlock::assign()
|
|
*/
|
|
public function assign($name, $value) {
|
|
return $this->Blocks->set($name, $value);
|
|
}
|
|
|
|
/**
|
|
* Fetch the content for a block. If a block is
|
|
* empty or undefined '' will be returnned.
|
|
*
|
|
* @param string $name Name of the block
|
|
* @return The block content or '' if the block does not exist.
|
|
* @see ViewBlock::fetch()
|
|
*/
|
|
public function fetch($name) {
|
|
return $this->Blocks->get($name);
|
|
}
|
|
|
|
/**
|
|
* End a capturing block. The compliment to View::start()
|
|
*
|
|
* @return void
|
|
* @see ViewBlock::start()
|
|
*/
|
|
public function end() {
|
|
return $this->Blocks->end();
|
|
}
|
|
|
|
/**
|
|
* Provides view or element extension/inheritance. Views can extends a
|
|
* parent view and populate blocks in the parent template.
|
|
*
|
|
* @param string $name The view or element to 'extend' the current one with.
|
|
* @return void
|
|
* @throws LogicException when you extend a view with itself or make extend loops.
|
|
*/
|
|
public function extend($name) {
|
|
switch ($this->_currentType) {
|
|
case self::TYPE_VIEW:
|
|
$parent = $this->_getViewFileName($name);
|
|
break;
|
|
case self::TYPE_ELEMENT:
|
|
$parent = $this->_getElementFileName($name);
|
|
break;
|
|
case self::TYPE_LAYOUT:
|
|
$parent = $this->_getLayoutFileName($name);
|
|
break;
|
|
|
|
}
|
|
if ($parent == $this->_current) {
|
|
throw new LogicException(__d('cake_dev', 'You cannot have views extend themselves.'));
|
|
}
|
|
if (isset($this->_parents[$parent]) && $this->_parents[$parent] == $this->_current) {
|
|
throw new LogicException(__d('cake_dev', 'You cannot have views extend in a loop.'));
|
|
}
|
|
$this->_parents[$this->_current] = $parent;
|
|
}
|
|
|
|
/**
|
|
* Adds a script block or other element to be inserted in $scripts_for_layout in
|
|
* the `<head />` of a document layout
|
|
*
|
|
* @param string $name Either the key name for the script, or the script content. Name can be used to
|
|
* update/replace a script element.
|
|
* @param string $content The content of the script being added, optional.
|
|
* @return void
|
|
* @deprecated Will be removed in 3.0. Supersceeded by blocks functionality.
|
|
* @see View::start()
|
|
*/
|
|
public function addScript($name, $content = null) {
|
|
if (empty($content)) {
|
|
if (!in_array($name, array_values($this->_scripts))) {
|
|
$this->_scripts[] = $name;
|
|
}
|
|
} else {
|
|
$this->_scripts[$name] = $content;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Generates a unique, non-random DOM ID for an object, based on the object type and the target URL.
|
|
*
|
|
* @param string $object Type of object, i.e. 'form' or 'link'
|
|
* @param string $url The object's target URL
|
|
* @return string
|
|
*/
|
|
public function uuid($object, $url) {
|
|
$c = 1;
|
|
$url = Router::url($url);
|
|
$hash = $object . substr(md5($object . $url), 0, 10);
|
|
while (in_array($hash, $this->uuids)) {
|
|
$hash = $object . substr(md5($object . $url . $c), 0, 10);
|
|
$c++;
|
|
}
|
|
$this->uuids[] = $hash;
|
|
return $hash;
|
|
}
|
|
|
|
/**
|
|
* Allows a template or element to set a variable that will be available in
|
|
* a layout or other element. Analogous to Controller::set().
|
|
*
|
|
* @param mixed $one A string or an array of data.
|
|
* @param mixed $two Value in case $one is a string (which then works as the key).
|
|
* Unused if $one is an associative array, otherwise serves as the values to $one's keys.
|
|
* @return void
|
|
*/
|
|
public function set($one, $two = null) {
|
|
$data = null;
|
|
if (is_array($one)) {
|
|
if (is_array($two)) {
|
|
$data = array_combine($one, $two);
|
|
} else {
|
|
$data = $one;
|
|
}
|
|
} else {
|
|
$data = array($one => $two);
|
|
}
|
|
if ($data == null) {
|
|
return false;
|
|
}
|
|
$this->viewVars = $data + $this->viewVars;
|
|
}
|
|
|
|
/**
|
|
* Magic accessor for helpers. Provides access to attributes that were deprecated.
|
|
*
|
|
* @param string $name Name of the attribute to get.
|
|
* @return mixed
|
|
*/
|
|
public function __get($name) {
|
|
if (isset($this->Helpers->{$name})) {
|
|
return $this->Helpers->{$name};
|
|
}
|
|
switch ($name) {
|
|
case 'base':
|
|
case 'here':
|
|
case 'webroot':
|
|
case 'data':
|
|
return $this->request->{$name};
|
|
case 'action':
|
|
return isset($this->request->params['action']) ? $this->request->params['action'] : '';
|
|
case 'params':
|
|
return $this->request;
|
|
case 'output':
|
|
return $this->Blocks->get('content');
|
|
default:
|
|
return $this->{$name};
|
|
}
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Magic accessor for deprecated attributes.
|
|
*
|
|
* @param string $name Name of the attribute to set.
|
|
* @param string $value Value of the attribute to set.
|
|
* @return mixed
|
|
*/
|
|
public function __set($name, $value) {
|
|
switch ($name) {
|
|
case 'output':
|
|
return $this->Blocks->set('content', $value);
|
|
default:
|
|
$this->{$name} = $value;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Magic isset check for deprecated attributes.
|
|
*
|
|
* @param string $name Name of the attribute to check.
|
|
* @return boolean
|
|
*/
|
|
public function __isset($name) {
|
|
return isset($this->name);
|
|
}
|
|
|
|
/**
|
|
* Interact with the HelperCollection to load all the helpers.
|
|
*
|
|
* @return void
|
|
*/
|
|
public function loadHelpers() {
|
|
$helpers = HelperCollection::normalizeObjectArray($this->helpers);
|
|
foreach ($helpers as $name => $properties) {
|
|
list($plugin, $class) = pluginSplit($properties['class']);
|
|
$this->{$class} = $this->Helpers->load($properties['class'], $properties['settings']);
|
|
}
|
|
$this->_helpersLoaded = true;
|
|
}
|
|
|
|
/**
|
|
* Renders and returns output for given view filename with its
|
|
* array of data. Handles parent/extended views.
|
|
*
|
|
* @param string $viewFile Filename of the view
|
|
* @param array $data Data to include in rendered view. If empty the current View::$viewVars will be used.
|
|
* @return string Rendered output
|
|
* @throws CakeException when a block is left open.
|
|
*/
|
|
protected function _render($viewFile, $data = array()) {
|
|
if (empty($data)) {
|
|
$data = $this->viewVars;
|
|
}
|
|
$this->_current = $viewFile;
|
|
$initialBlocks = count($this->Blocks->unclosed());
|
|
|
|
$this->getEventManager()->dispatch(new CakeEvent('View.beforeRenderFile', $this, array($viewFile)));
|
|
$content = $this->_evaluate($viewFile, $data);
|
|
$afterEvent = new CakeEvent('View.afterRenderFile', $this, array($viewFile, $content));
|
|
//TODO: For BC puporses, set extra info in the event object. Remove when appropriate
|
|
$afterEvent->modParams = 1;
|
|
$this->getEventManager()->dispatch($afterEvent);
|
|
$content = $afterEvent->data[1];
|
|
|
|
if (isset($this->_parents[$viewFile])) {
|
|
$this->_stack[] = $this->fetch('content');
|
|
$this->assign('content', $content);
|
|
|
|
$content = $this->_render($this->_parents[$viewFile]);
|
|
$this->assign('content', array_pop($this->_stack));
|
|
}
|
|
|
|
$remainingBlocks = count($this->Blocks->unclosed());
|
|
|
|
if ($initialBlocks !== $remainingBlocks) {
|
|
throw new CakeException(__d('cake_dev', 'The "%s" block was left open. Blocks are not allowed to cross files.', $this->Blocks->active()));
|
|
}
|
|
|
|
return $content;
|
|
}
|
|
|
|
/**
|
|
* Sandbox method to evaluate a template / view script in.
|
|
*
|
|
* @param string $___viewFn Filename of the view
|
|
* @param array $___dataForView Data to include in rendered view.
|
|
* If empty the current View::$viewVars will be used.
|
|
* @return string Rendered output
|
|
*/
|
|
protected function _evaluate($___viewFn, $___dataForView) {
|
|
extract($___dataForView, EXTR_SKIP);
|
|
ob_start();
|
|
|
|
include $___viewFn;
|
|
|
|
return ob_get_clean();
|
|
}
|
|
|
|
/**
|
|
* Loads a helper. Delegates to the `HelperCollection::load()` to load the helper
|
|
*
|
|
* @param string $helperName Name of the helper to load.
|
|
* @param array $settings Settings for the helper
|
|
* @return Helper a constructed helper object.
|
|
* @see HelperCollection::load()
|
|
*/
|
|
public function loadHelper($helperName, $settings = array()) {
|
|
return $this->Helpers->load($helperName, $settings);
|
|
}
|
|
|
|
/**
|
|
* Returns filename of given action's template file (.ctp) as a string.
|
|
* CamelCased action names will be under_scored! This means that you can have
|
|
* LongActionNames that refer to long_action_names.ctp views.
|
|
*
|
|
* @param string $name Controller action to find template filename for
|
|
* @return string Template filename
|
|
* @throws MissingViewException when a view file could not be found.
|
|
*/
|
|
protected function _getViewFileName($name = null) {
|
|
$subDir = null;
|
|
|
|
if (!is_null($this->subDir)) {
|
|
$subDir = $this->subDir . DS;
|
|
}
|
|
|
|
if ($name === null) {
|
|
$name = $this->view;
|
|
}
|
|
$name = str_replace('/', DS, $name);
|
|
list($plugin, $name) = $this->_pluginSplit($name);
|
|
|
|
if (strpos($name, DS) === false && $name[0] !== '.') {
|
|
$name = $this->viewPath . DS . $subDir . Inflector::underscore($name);
|
|
} elseif (strpos($name, DS) !== false) {
|
|
if ($name[0] === DS || $name[1] === ':') {
|
|
if (is_file($name)) {
|
|
return $name;
|
|
}
|
|
$name = trim($name, DS);
|
|
} else if ($name[0] === '.') {
|
|
$name = substr($name, 3);
|
|
} else {
|
|
$name = $this->viewPath . DS . $subDir . $name;
|
|
}
|
|
}
|
|
$paths = $this->_paths($plugin);
|
|
$exts = $this->_getExtensions();
|
|
foreach ($exts as $ext) {
|
|
foreach ($paths as $path) {
|
|
if (file_exists($path . $name . $ext)) {
|
|
return $path . $name . $ext;
|
|
}
|
|
}
|
|
}
|
|
$defaultPath = $paths[0];
|
|
|
|
if ($this->plugin) {
|
|
$pluginPaths = App::path('plugins');
|
|
foreach ($paths as $path) {
|
|
if (strpos($path, $pluginPaths[0]) === 0) {
|
|
$defaultPath = $path;
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
throw new MissingViewException(array('file' => $defaultPath . $name . $this->ext));
|
|
}
|
|
|
|
/**
|
|
* Splits a dot syntax plugin name into its plugin and filename.
|
|
* If $name does not have a dot, then index 0 will be null.
|
|
* It checks if the plugin is loaded, else filename will stay unchanged for filenames containing dot
|
|
*
|
|
* @param string $name The name you want to plugin split.
|
|
* @return array Array with 2 indexes. 0 => plugin name, 1 => filename
|
|
*/
|
|
protected function _pluginSplit($name) {
|
|
$plugin = null;
|
|
list($first, $second) = pluginSplit($name);
|
|
if (CakePlugin::loaded($first) === true) {
|
|
$name = $second;
|
|
$plugin = $first;
|
|
}
|
|
if (isset($this->plugin) && !$plugin) {
|
|
$plugin = $this->plugin;
|
|
}
|
|
return array($plugin, $name);
|
|
}
|
|
|
|
/**
|
|
* Returns layout filename for this template as a string.
|
|
*
|
|
* @param string $name The name of the layout to find.
|
|
* @return string Filename for layout file (.ctp).
|
|
* @throws MissingLayoutException when a layout cannot be located
|
|
*/
|
|
protected function _getLayoutFileName($name = null) {
|
|
if ($name === null) {
|
|
$name = $this->layout;
|
|
}
|
|
$subDir = null;
|
|
|
|
if (!is_null($this->layoutPath)) {
|
|
$subDir = $this->layoutPath . DS;
|
|
}
|
|
list($plugin, $name) = $this->_pluginSplit($name);
|
|
$paths = $this->_paths($plugin);
|
|
$file = 'Layouts' . DS . $subDir . $name;
|
|
|
|
$exts = $this->_getExtensions();
|
|
foreach ($exts as $ext) {
|
|
foreach ($paths as $path) {
|
|
if (file_exists($path . $file . $ext)) {
|
|
return $path . $file . $ext;
|
|
}
|
|
}
|
|
}
|
|
throw new MissingLayoutException(array('file' => $paths[0] . $file . $this->ext));
|
|
}
|
|
|
|
|
|
/**
|
|
* Get the extensions that view files can use.
|
|
*
|
|
* @return array Array of extensions view files use.
|
|
*/
|
|
protected function _getExtensions() {
|
|
$exts = array($this->ext);
|
|
if ($this->ext !== '.ctp') {
|
|
array_push($exts, '.ctp');
|
|
}
|
|
return $exts;
|
|
}
|
|
|
|
/**
|
|
* Finds an element filename, returns false on failure.
|
|
*
|
|
* @param string $name The name of the element to find.
|
|
* @return mixed Either a string to the element filename or false when one can't be found.
|
|
*/
|
|
protected function _getElementFileName($name) {
|
|
list($plugin, $name) = $this->_pluginSplit($name);
|
|
|
|
$paths = $this->_paths($plugin);
|
|
$exts = $this->_getExtensions();
|
|
foreach ($exts as $ext) {
|
|
foreach ($paths as $path) {
|
|
if (file_exists($path . 'Elements' . DS . $name . $ext)) {
|
|
return $path . 'Elements' . DS . $name . $ext;
|
|
}
|
|
}
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Return all possible paths to find view files in order
|
|
*
|
|
* @param string $plugin Optional plugin name to scan for view files.
|
|
* @param boolean $cached Set to true to force a refresh of view paths.
|
|
* @return array paths
|
|
*/
|
|
protected function _paths($plugin = null, $cached = true) {
|
|
if ($plugin === null && $cached === true && !empty($this->_paths)) {
|
|
return $this->_paths;
|
|
}
|
|
$paths = array();
|
|
$viewPaths = App::path('View');
|
|
$corePaths = array_flip(App::core('View'));
|
|
if (!empty($plugin)) {
|
|
$count = count($viewPaths);
|
|
for ($i = 0; $i < $count; $i++) {
|
|
if (!isset($corePaths[$viewPaths[$i]])) {
|
|
$paths[] = $viewPaths[$i] . 'Plugin' . DS . $plugin . DS;
|
|
}
|
|
}
|
|
$paths = array_merge($paths, App::path('View', $plugin));
|
|
}
|
|
|
|
$paths = array_unique(array_merge($paths, $viewPaths, array_keys($corePaths)));
|
|
if ($plugin !== null) {
|
|
return $paths;
|
|
}
|
|
return $this->_paths = $paths;
|
|
}
|
|
}
|