mirror of
https://github.com/smarty-php/smarty.git
synced 2025-10-31 04:11:37 +01:00
286 lines
8.3 KiB
PHP
286 lines
8.3 KiB
PHP
<?php
|
|
|
|
/**
|
|
* Smarty Resource Data Object
|
|
* Meta Data Container for Template Files
|
|
*
|
|
* @package Smarty
|
|
* @subpackage TemplateResources
|
|
* @author Rodney Rehm
|
|
* @property integer $timestamp Source Timestamp
|
|
* @property boolean $exists Source Existence
|
|
* @property boolean $template Extended Template reference
|
|
* @property string $content Source Content
|
|
*/
|
|
class Smarty_Template_Source
|
|
{
|
|
/**
|
|
* Name of the Class to compile this resource's contents with
|
|
*
|
|
* @var string
|
|
*/
|
|
public $compiler_class = null;
|
|
|
|
/**
|
|
* Name of the Class to tokenize this resource's contents with
|
|
*
|
|
* @var string
|
|
*/
|
|
public $template_lexer_class = null;
|
|
|
|
/**
|
|
* Name of the Class to parse this resource's contents with
|
|
*
|
|
* @var string
|
|
*/
|
|
public $template_parser_class = null;
|
|
|
|
/**
|
|
* Unique Template ID
|
|
*
|
|
* @var string
|
|
*/
|
|
public $uid = null;
|
|
|
|
/**
|
|
* Template Resource (Smarty_Internal_Template::$template_resource)
|
|
*
|
|
* @var string
|
|
*/
|
|
public $resource = null;
|
|
|
|
/**
|
|
* Resource Type
|
|
*
|
|
* @var string
|
|
*/
|
|
public $type = null;
|
|
|
|
/**
|
|
* Resource Name
|
|
*
|
|
* @var string
|
|
*/
|
|
public $name = null;
|
|
|
|
/**
|
|
* Unique Resource Name
|
|
*
|
|
* @var string
|
|
*/
|
|
public $unique_resource = null;
|
|
|
|
/**
|
|
* Source Filepath
|
|
*
|
|
* @var string
|
|
*/
|
|
public $filepath = null;
|
|
/**
|
|
* Source File Base name
|
|
*
|
|
* @var string
|
|
*/
|
|
public $basename = null;
|
|
|
|
/**
|
|
* The Components an extended template is made of
|
|
*
|
|
* @var array
|
|
*/
|
|
public $components = null;
|
|
|
|
/**
|
|
* Resource Handler
|
|
*
|
|
* @var Smarty_Resource
|
|
*/
|
|
public $handler = null;
|
|
|
|
/**
|
|
* Smarty instance
|
|
*
|
|
* @var Smarty
|
|
*/
|
|
public $smarty = null;
|
|
/**
|
|
* Resource is source
|
|
*
|
|
* @var bool
|
|
*/
|
|
public $isConfig = false;
|
|
/**
|
|
* Source is bypassing compiler
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $uncompiled = false;
|
|
|
|
/**
|
|
* Source must be recompiled on every occasion
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $recompiled = false;
|
|
/**
|
|
* cache for Smarty_Template_Compiled instances
|
|
*
|
|
* @var array
|
|
*/
|
|
public $compileds = array();
|
|
|
|
/**
|
|
* create Source Object container
|
|
*
|
|
* @param Smarty_Resource $handler Resource Handler this source object communicates with
|
|
* @param Smarty $smarty Smarty instance this source object belongs to
|
|
* @param string $resource full template_resource
|
|
* @param string $type type of resource
|
|
* @param string $name resource name
|
|
*
|
|
* @internal param string $unique_resource unique resource name
|
|
*/
|
|
public function __construct(Smarty_Resource $handler, Smarty $smarty, $resource, $type, $name)
|
|
{
|
|
$this->handler = $handler; // Note: prone to circular references
|
|
|
|
$this->recompiled = $handler->recompiled;
|
|
$this->uncompiled = $handler->uncompiled;
|
|
$this->compiler_class = $handler->compiler_class;
|
|
$this->template_lexer_class = $handler->template_lexer_class;
|
|
$this->template_parser_class = $handler->template_parser_class;
|
|
|
|
$this->smarty = $smarty;
|
|
$this->resource = $resource;
|
|
$this->type = $type;
|
|
$this->name = $name;
|
|
}
|
|
|
|
/**
|
|
* initialize Source Object for given resource
|
|
* Either [$_template] or [$smarty, $template_resource] must be specified
|
|
*
|
|
* @param Smarty_Internal_Template $_template template object
|
|
* @param Smarty $smarty smarty object
|
|
* @param string $template_resource resource identifier
|
|
*
|
|
* @return Smarty_Template_Source Source Object
|
|
* @throws SmartyException
|
|
*/
|
|
public static function load(Smarty_Internal_Template $_template = null, Smarty $smarty = null, $template_resource = null)
|
|
{
|
|
if ($_template) {
|
|
$smarty = $_template->smarty;
|
|
$template_resource = $_template->template_resource;
|
|
}
|
|
if (empty($template_resource)) {
|
|
throw new SmartyException('Missing template name');
|
|
}
|
|
// parse resource_name, load resource handler, identify unique resource name
|
|
list($name, $type) = Smarty_Resource::parseResourceName($template_resource, $smarty->default_resource_type);
|
|
$resource = Smarty_Resource::load($smarty, $type);
|
|
// if resource is not recompiling and resource name is not dotted we can check the source cache
|
|
if ($smarty->resource_caching && !$resource->recompiled && !(isset($name[1]) && $name[0] == '.' && ($name[1] == '.' || $name[1] == '/'))) {
|
|
$unique_resource = $resource->buildUniqueResourceName($smarty, $name);
|
|
if (isset($smarty->source_objects[$unique_resource])) {
|
|
return $smarty->source_objects[$unique_resource];
|
|
}
|
|
} else {
|
|
$unique_resource = null;
|
|
}
|
|
// create new source object
|
|
$source = new Smarty_Template_Source($resource, $smarty, $template_resource, $type, $name);
|
|
$resource->populate($source, $_template);
|
|
if ((!isset($source->exists) || !$source->exists) && isset($_template->smarty->default_template_handler_func)) {
|
|
Smarty_Internal_Extension_DefaultTemplateHandler::_getDefault($_template, $source, $resObj);
|
|
}
|
|
// on recompiling resources we are done
|
|
if ($smarty->resource_caching && !$resource->recompiled) {
|
|
// may by we have already $unique_resource
|
|
$is_relative = false;
|
|
if (!isset($unique_resource)) {
|
|
$is_relative = isset($name[1]) && $name[0] == '.' && ($name[1] == '.' || $name[1] == '/') &&
|
|
($type == 'file' || (isset($_template->parent->source) && $_template->parent->source->type == 'extends'));
|
|
$unique_resource = $resource->buildUniqueResourceName($smarty, $is_relative ? $source->filepath . $name : $name);
|
|
}
|
|
$source->unique_resource = $unique_resource;
|
|
// save in runtime cache if not relative
|
|
if (!$is_relative) {
|
|
$smarty->source_objects[$unique_resource] = $source;
|
|
}
|
|
}
|
|
return $source;
|
|
}
|
|
|
|
/**
|
|
* render the uncompiled source
|
|
*
|
|
* @param Smarty_Internal_Template $_template template object
|
|
*/
|
|
public function renderUncompiled(Smarty_Internal_Template $_template)
|
|
{
|
|
$level = ob_get_level();
|
|
ob_start();
|
|
try {
|
|
$this->handler->renderUncompiled($_template->source, $_template);
|
|
return ob_get_clean();
|
|
}
|
|
catch (Exception $e) {
|
|
while (ob_get_level() > $level) {
|
|
ob_end_clean();
|
|
}
|
|
throw $e;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* <<magic>> Generic Setter.
|
|
*
|
|
* @param string $property_name valid: timestamp, exists, content, template
|
|
* @param mixed $value new value (is not checked)
|
|
*
|
|
* @throws SmartyException if $property_name is not valid
|
|
*/
|
|
public function __set($property_name, $value)
|
|
{
|
|
switch ($property_name) {
|
|
// regular attributes
|
|
case 'timestamp':
|
|
case 'exists':
|
|
case 'content':
|
|
// required for extends: only
|
|
case 'template':
|
|
$this->$property_name = $value;
|
|
break;
|
|
|
|
default:
|
|
throw new SmartyException("source property '$property_name' does not exist.");
|
|
}
|
|
}
|
|
|
|
/**
|
|
* <<magic>> Generic getter.
|
|
*
|
|
* @param string $property_name valid: timestamp, exists, content
|
|
*
|
|
* @return mixed
|
|
* @throws SmartyException if $property_name is not valid
|
|
*/
|
|
public function __get($property_name)
|
|
{
|
|
switch ($property_name) {
|
|
case 'timestamp':
|
|
case 'exists':
|
|
$this->handler->populateTimestamp($this);
|
|
|
|
return $this->$property_name;
|
|
|
|
case 'content':
|
|
return $this->content = $this->handler->getContent($this);
|
|
|
|
default:
|
|
throw new SmartyException("source property '$property_name' does not exist.");
|
|
}
|
|
}
|
|
}
|