1803 lines
48 KiB
PHP
1803 lines
48 KiB
PHP
<?php
|
|
/**
|
|
* Project: Smarty: the PHP compiling template engine
|
|
* File: Smarty.class.php
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
* For questions, help, comments, discussion, etc., please join the
|
|
* Smarty mailing list. Send a blank e-mail to
|
|
* smarty-discussion-subscribe@googlegroups.com
|
|
*
|
|
* @link http://www.smarty.net/
|
|
* @copyright 2015 New Digital Group, Inc.
|
|
* @copyright 2015 Uwe Tews
|
|
* @author Monte Ohrt <monte at ohrt dot com>
|
|
* @author Uwe Tews
|
|
* @author Rodney Rehm
|
|
* @package Smarty
|
|
* @version 3.1.27
|
|
*/
|
|
|
|
/**
|
|
* define shorthand directory separator constant
|
|
*/
|
|
if (!defined('DS')) {
|
|
define('DS', DIRECTORY_SEPARATOR);
|
|
}
|
|
|
|
/**
|
|
* set SMARTY_DIR to absolute path to Smarty library files.
|
|
* Sets SMARTY_DIR only if user application has not already defined it.
|
|
*/
|
|
if (!defined('SMARTY_DIR')) {
|
|
define('SMARTY_DIR', dirname(__FILE__) . DS);
|
|
}
|
|
|
|
/**
|
|
* set SMARTY_SYSPLUGINS_DIR to absolute path to Smarty internal plugins.
|
|
* Sets SMARTY_SYSPLUGINS_DIR only if user application has not already defined it.
|
|
*/
|
|
if (!defined('SMARTY_SYSPLUGINS_DIR')) {
|
|
define('SMARTY_SYSPLUGINS_DIR', SMARTY_DIR . 'sysplugins' . DS);
|
|
}
|
|
if (!defined('SMARTY_PLUGINS_DIR')) {
|
|
define('SMARTY_PLUGINS_DIR', SMARTY_DIR . 'plugins' . DS);
|
|
}
|
|
if (!defined('SMARTY_MBSTRING')) {
|
|
define('SMARTY_MBSTRING', function_exists('mb_get_info'));
|
|
}
|
|
if (!defined('SMARTY_RESOURCE_CHAR_SET')) {
|
|
// UTF-8 can only be done properly when mbstring is available!
|
|
/**
|
|
* @deprecated in favor of Smarty::$_CHARSET
|
|
*/
|
|
define('SMARTY_RESOURCE_CHAR_SET', SMARTY_MBSTRING ? 'UTF-8' : 'ISO-8859-1');
|
|
}
|
|
if (!defined('SMARTY_RESOURCE_DATE_FORMAT')) {
|
|
/**
|
|
* @deprecated in favor of Smarty::$_DATE_FORMAT
|
|
*/
|
|
define('SMARTY_RESOURCE_DATE_FORMAT', '%b %e, %Y');
|
|
}
|
|
|
|
/**
|
|
* Try loading the Smarty_Internal_Data class
|
|
* If we fail we must load Smarty's autoloader.
|
|
* Otherwise we may have a global autoloader like Composer
|
|
*/
|
|
if (!class_exists('Smarty_Autoloader', false)) {
|
|
if (!class_exists('Smarty_Internal_Data', true)) {
|
|
require_once 'Autoloader.php';
|
|
Smarty_Autoloader::registerBC();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Load always needed external class files
|
|
*/
|
|
|
|
if (!class_exists('Smarty_Internal_Data', false)) {
|
|
require_once SMARTY_SYSPLUGINS_DIR . 'smarty_internal_data.php';
|
|
}
|
|
require_once SMARTY_SYSPLUGINS_DIR . 'smarty_internal_templatebase.php';
|
|
require_once SMARTY_SYSPLUGINS_DIR . 'smarty_internal_template.php';
|
|
require_once SMARTY_SYSPLUGINS_DIR . 'smarty_resource.php';
|
|
require_once SMARTY_SYSPLUGINS_DIR . 'smarty_variable.php';
|
|
require_once SMARTY_SYSPLUGINS_DIR . 'smarty_template_source.php';
|
|
|
|
/**
|
|
* This is the main Smarty class
|
|
*
|
|
* @package Smarty
|
|
*/
|
|
class Smarty extends Smarty_Internal_TemplateBase
|
|
{
|
|
/**#@+
|
|
* constant definitions
|
|
*/
|
|
|
|
/**
|
|
* smarty version
|
|
*/
|
|
const SMARTY_VERSION = '3.1.27';
|
|
|
|
/**
|
|
* define variable scopes
|
|
*/
|
|
const SCOPE_LOCAL = 0;
|
|
|
|
const SCOPE_PARENT = 1;
|
|
|
|
const SCOPE_ROOT = 2;
|
|
|
|
const SCOPE_GLOBAL = 3;
|
|
|
|
/**
|
|
* define caching modes
|
|
*/
|
|
const CACHING_OFF = 0;
|
|
|
|
const CACHING_LIFETIME_CURRENT = 1;
|
|
|
|
const CACHING_LIFETIME_SAVED = 2;
|
|
|
|
/**
|
|
* define constant for clearing cache files be saved expiration datees
|
|
*/
|
|
const CLEAR_EXPIRED = - 1;
|
|
|
|
/**
|
|
* define compile check modes
|
|
*/
|
|
const COMPILECHECK_OFF = 0;
|
|
|
|
const COMPILECHECK_ON = 1;
|
|
|
|
const COMPILECHECK_CACHEMISS = 2;
|
|
|
|
/**
|
|
* define debug modes
|
|
*/
|
|
const DEBUG_OFF = 0;
|
|
|
|
const DEBUG_ON = 1;
|
|
|
|
const DEBUG_INDIVIDUAL = 2;
|
|
|
|
/**
|
|
* modes for handling of "<?php ... ?>" tags in templates.
|
|
*/
|
|
const PHP_PASSTHRU = 0; //-> print tags as plain text
|
|
|
|
const PHP_QUOTE = 1; //-> escape tags as entities
|
|
|
|
const PHP_REMOVE = 2; //-> escape tags as entities
|
|
|
|
const PHP_ALLOW = 3; //-> escape tags as entities
|
|
|
|
/**
|
|
* filter types
|
|
*/
|
|
const FILTER_POST = 'post';
|
|
|
|
const FILTER_PRE = 'pre';
|
|
|
|
const FILTER_OUTPUT = 'output';
|
|
|
|
const FILTER_VARIABLE = 'variable';
|
|
|
|
/**
|
|
* plugin types
|
|
*/
|
|
const PLUGIN_FUNCTION = 'function';
|
|
|
|
const PLUGIN_BLOCK = 'block';
|
|
|
|
const PLUGIN_COMPILER = 'compiler';
|
|
|
|
const PLUGIN_MODIFIER = 'modifier';
|
|
|
|
const PLUGIN_MODIFIERCOMPILER = 'modifiercompiler';
|
|
|
|
/**#@-*/
|
|
|
|
/**
|
|
* assigned global tpl vars
|
|
*/
|
|
public static $global_tpl_vars = array();
|
|
|
|
/**
|
|
* error handler returned by set_error_hanlder() in Smarty::muteExpectedErrors()
|
|
*/
|
|
public static $_previous_error_handler = null;
|
|
|
|
/**
|
|
* contains directories outside of SMARTY_DIR that are to be muted by muteExpectedErrors()
|
|
*/
|
|
public static $_muted_directories = array('./templates_c/' => null, './cache/' => null);
|
|
|
|
/**
|
|
* Flag denoting if Multibyte String functions are available
|
|
*/
|
|
public static $_MBSTRING = SMARTY_MBSTRING;
|
|
|
|
/**
|
|
* The character set to adhere to (e.g. "UTF-8")
|
|
*/
|
|
public static $_CHARSET = SMARTY_RESOURCE_CHAR_SET;
|
|
|
|
/**
|
|
* The date format to be used internally
|
|
* (accepts date() and strftime())
|
|
*/
|
|
public static $_DATE_FORMAT = SMARTY_RESOURCE_DATE_FORMAT;
|
|
|
|
/**
|
|
* Flag denoting if PCRE should run in UTF-8 mode
|
|
*/
|
|
public static $_UTF8_MODIFIER = 'u';
|
|
|
|
/**
|
|
* Flag denoting if operating system is windows
|
|
*/
|
|
public static $_IS_WINDOWS = false;
|
|
|
|
/**#@+
|
|
* variables
|
|
*/
|
|
|
|
/**
|
|
* auto literal on delimiters with whitspace
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $auto_literal = true;
|
|
|
|
/**
|
|
* display error on not assigned variables
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $error_unassigned = false;
|
|
|
|
/**
|
|
* look up relative filepaths in include_path
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $use_include_path = false;
|
|
|
|
/**
|
|
* template directory
|
|
*
|
|
* @var array
|
|
*/
|
|
private $template_dir = array('./templates/');
|
|
|
|
/**
|
|
* joined template directory string used in cache keys
|
|
*
|
|
* @var string
|
|
*/
|
|
public $joined_template_dir = './templates/';
|
|
|
|
/**
|
|
* joined config directory string used in cache keys
|
|
*
|
|
* @var string
|
|
*/
|
|
public $joined_config_dir = './configs/';
|
|
|
|
/**
|
|
* default template handler
|
|
*
|
|
* @var callable
|
|
*/
|
|
public $default_template_handler_func = null;
|
|
|
|
/**
|
|
* default config handler
|
|
*
|
|
* @var callable
|
|
*/
|
|
public $default_config_handler_func = null;
|
|
|
|
/**
|
|
* default plugin handler
|
|
*
|
|
* @var callable
|
|
*/
|
|
public $default_plugin_handler_func = null;
|
|
|
|
/**
|
|
* compile directory
|
|
*
|
|
* @var string
|
|
*/
|
|
private $compile_dir = './templates_c/';
|
|
|
|
/**
|
|
* plugins directory
|
|
*
|
|
* @var array
|
|
*/
|
|
private $plugins_dir = null;
|
|
|
|
/**
|
|
* cache directory
|
|
*
|
|
* @var string
|
|
*/
|
|
private $cache_dir = './cache/';
|
|
|
|
/**
|
|
* config directory
|
|
*
|
|
* @var array
|
|
*/
|
|
private $config_dir = array('./configs/');
|
|
|
|
/**
|
|
* force template compiling?
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $force_compile = false;
|
|
|
|
/**
|
|
* check template for modifications?
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $compile_check = true;
|
|
|
|
/**
|
|
* use sub dirs for compiled/cached files?
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $use_sub_dirs = false;
|
|
|
|
/**
|
|
* allow ambiguous resources (that are made unique by the resource handler)
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $allow_ambiguous_resources = false;
|
|
|
|
/**
|
|
* merge compiled includes
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $merge_compiled_includes = false;
|
|
|
|
/**
|
|
* template inheritance merge compiled includes
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $inheritance_merge_compiled_includes = true;
|
|
|
|
/**
|
|
* force cache file creation
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $force_cache = false;
|
|
|
|
/**
|
|
* template left-delimiter
|
|
*
|
|
* @var string
|
|
*/
|
|
public $left_delimiter = "{";
|
|
|
|
/**
|
|
* template right-delimiter
|
|
*
|
|
* @var string
|
|
*/
|
|
public $right_delimiter = "}";
|
|
|
|
/**#@+
|
|
* security
|
|
*/
|
|
/**
|
|
* class name
|
|
* This should be instance of Smarty_Security.
|
|
*
|
|
* @var string
|
|
* @see Smarty_Security
|
|
*/
|
|
public $security_class = 'Smarty_Security';
|
|
|
|
/**
|
|
* implementation of security class
|
|
*
|
|
* @var Smarty_Security
|
|
*/
|
|
public $security_policy = null;
|
|
|
|
/**
|
|
* controls handling of PHP-blocks
|
|
*
|
|
* @var integer
|
|
*/
|
|
public $php_handling = self::PHP_PASSTHRU;
|
|
|
|
/**
|
|
* controls if the php template file resource is allowed
|
|
*
|
|
* @var bool
|
|
*/
|
|
public $allow_php_templates = false;
|
|
|
|
/**
|
|
* Should compiled-templates be prevented from being called directly?
|
|
* {@internal
|
|
* Currently used by Smarty_Internal_Template only.
|
|
* }}
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $direct_access_security = true;
|
|
|
|
/**#@-*/
|
|
/**
|
|
* debug mode
|
|
* Setting this to true enables the debug-console.
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $debugging = false;
|
|
|
|
/**
|
|
* This determines if debugging is enable-able from the browser.
|
|
* <ul>
|
|
* <li>NONE => no debugging control allowed</li>
|
|
* <li>URL => enable debugging when SMARTY_DEBUG is found in the URL.</li>
|
|
* </ul>
|
|
*
|
|
* @var string
|
|
*/
|
|
public $debugging_ctrl = 'NONE';
|
|
|
|
/**
|
|
* Name of debugging URL-param.
|
|
* Only used when $debugging_ctrl is set to 'URL'.
|
|
* The name of the URL-parameter that activates debugging.
|
|
*
|
|
* @var string
|
|
*/
|
|
public $smarty_debug_id = 'SMARTY_DEBUG';
|
|
|
|
/**
|
|
* Path of debug template.
|
|
*
|
|
* @var string
|
|
*/
|
|
public $debug_tpl = null;
|
|
|
|
/**
|
|
* When set, smarty uses this value as error_reporting-level.
|
|
*
|
|
* @var int
|
|
*/
|
|
public $error_reporting = null;
|
|
|
|
/**
|
|
* Internal flag for getTags()
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $get_used_tags = false;
|
|
|
|
/**#@+
|
|
* config var settings
|
|
*/
|
|
|
|
/**
|
|
* Controls whether variables with the same name overwrite each other.
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $config_overwrite = true;
|
|
|
|
/**
|
|
* Controls whether config values of on/true/yes and off/false/no get converted to boolean.
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $config_booleanize = true;
|
|
|
|
/**
|
|
* Controls whether hidden config sections/vars are read from the file.
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $config_read_hidden = false;
|
|
|
|
/**#@-*/
|
|
|
|
/**#@+
|
|
* resource locking
|
|
*/
|
|
|
|
/**
|
|
* locking concurrent compiles
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $compile_locking = true;
|
|
|
|
/**
|
|
* Controls whether cache resources should emply locking mechanism
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $cache_locking = false;
|
|
|
|
/**
|
|
* seconds to wait for acquiring a lock before ignoring the write lock
|
|
*
|
|
* @var float
|
|
*/
|
|
public $locking_timeout = 10;
|
|
|
|
/**#@-*/
|
|
|
|
/**
|
|
* resource type used if none given
|
|
* Must be an valid key of $registered_resources.
|
|
*
|
|
* @var string
|
|
*/
|
|
public $default_resource_type = 'file';
|
|
|
|
/**
|
|
* caching type
|
|
* Must be an element of $cache_resource_types.
|
|
*
|
|
* @var string
|
|
*/
|
|
public $caching_type = 'file';
|
|
|
|
/**
|
|
* internal config properties
|
|
*
|
|
* @var array
|
|
*/
|
|
public $properties = array();
|
|
|
|
/**
|
|
* config type
|
|
*
|
|
* @var string
|
|
*/
|
|
public $default_config_type = 'file';
|
|
|
|
/**
|
|
* cached template objects
|
|
*
|
|
* @var array
|
|
*/
|
|
public $source_objects = array();
|
|
|
|
/**
|
|
* cached template objects
|
|
*
|
|
* @var array
|
|
*/
|
|
public $template_objects = array();
|
|
|
|
/**
|
|
* enable resource caching
|
|
*
|
|
* @var bool
|
|
*/
|
|
public $resource_caching = false;
|
|
|
|
/**
|
|
* enable template resource caching
|
|
*
|
|
* @var bool
|
|
*/
|
|
public $template_resource_caching = true;
|
|
|
|
/**
|
|
* check If-Modified-Since headers
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $cache_modified_check = false;
|
|
|
|
/**
|
|
* registered plugins
|
|
*
|
|
* @var array
|
|
*/
|
|
public $registered_plugins = array();
|
|
|
|
/**
|
|
* plugin search order
|
|
*
|
|
* @var array
|
|
*/
|
|
public $plugin_search_order = array('function', 'block', 'compiler', 'class');
|
|
|
|
/**
|
|
* registered objects
|
|
*
|
|
* @var array
|
|
*/
|
|
public $registered_objects = array();
|
|
|
|
/**
|
|
* registered classes
|
|
*
|
|
* @var array
|
|
*/
|
|
public $registered_classes = array();
|
|
|
|
/**
|
|
* registered filters
|
|
*
|
|
* @var array
|
|
*/
|
|
public $registered_filters = array();
|
|
|
|
/**
|
|
* registered resources
|
|
*
|
|
* @var array
|
|
*/
|
|
public $registered_resources = array();
|
|
|
|
/**
|
|
* resource handler cache
|
|
*
|
|
* @var array
|
|
*/
|
|
public $_resource_handlers = array();
|
|
|
|
/**
|
|
* registered cache resources
|
|
*
|
|
* @var array
|
|
*/
|
|
public $registered_cache_resources = array();
|
|
|
|
/**
|
|
* cache resource handler cache
|
|
*
|
|
* @var array
|
|
*/
|
|
public $_cacheresource_handlers = array();
|
|
|
|
/**
|
|
* autoload filter
|
|
*
|
|
* @var array
|
|
*/
|
|
public $autoload_filters = array();
|
|
|
|
/**
|
|
* default modifier
|
|
*
|
|
* @var array
|
|
*/
|
|
public $default_modifiers = array();
|
|
|
|
/**
|
|
* autoescape variable output
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $escape_html = false;
|
|
|
|
/**
|
|
* global internal smarty vars
|
|
*
|
|
* @var array
|
|
*/
|
|
public static $_smarty_vars = array();
|
|
|
|
/**
|
|
* start time for execution time calculation
|
|
*
|
|
* @var int
|
|
*/
|
|
public $start_time = 0;
|
|
|
|
/**
|
|
* default file permissions
|
|
*
|
|
* @var int
|
|
*/
|
|
public $_file_perms = 0644;
|
|
|
|
/**
|
|
* default dir permissions
|
|
*
|
|
* @var int
|
|
*/
|
|
public $_dir_perms = 0771;
|
|
|
|
/**
|
|
* block tag hierarchy
|
|
*
|
|
* @var array
|
|
*/
|
|
public $_tag_stack = array();
|
|
|
|
/**
|
|
* required by the compiler for BC
|
|
*
|
|
* @var string
|
|
*/
|
|
public $_current_file = null;
|
|
|
|
/**
|
|
* internal flag to enable parser debugging
|
|
*
|
|
* @var bool
|
|
*/
|
|
public $_parserdebug = false;
|
|
|
|
/**
|
|
* Cache of is_file results of loadPlugin()
|
|
*
|
|
* @var array
|
|
*/
|
|
public $_is_file_cache = array();
|
|
|
|
/**#@-*/
|
|
|
|
/**
|
|
* Initialize new Smarty object
|
|
*/
|
|
public function __construct()
|
|
{
|
|
if (is_callable('mb_internal_encoding')) {
|
|
mb_internal_encoding(Smarty::$_CHARSET);
|
|
}
|
|
$this->start_time = microtime(true);
|
|
// check default dirs for overloading
|
|
if ($this->template_dir[0] !== './templates/' || isset($this->template_dir[1])) {
|
|
$this->setTemplateDir($this->template_dir);
|
|
}
|
|
if ($this->config_dir[0] !== './configs/' || isset($this->config_dir[1])) {
|
|
$this->setConfigDir($this->config_dir);
|
|
}
|
|
if ($this->compile_dir !== './templates_c/') {
|
|
unset(self::$_muted_directories['./templates_c/']);
|
|
$this->setCompileDir($this->compile_dir);
|
|
}
|
|
if ($this->cache_dir !== './cache/') {
|
|
unset(self::$_muted_directories['./cache/']);
|
|
$this->setCacheDir($this->cache_dir);
|
|
}
|
|
if (isset($this->plugins_dir)) {
|
|
$this->setPluginsDir($this->plugins_dir);
|
|
} else {
|
|
$this->setPluginsDir(SMARTY_PLUGINS_DIR);
|
|
}
|
|
if (isset($_SERVER['SCRIPT_NAME'])) {
|
|
Smarty::$global_tpl_vars['SCRIPT_NAME'] = new Smarty_Variable($_SERVER['SCRIPT_NAME']);
|
|
}
|
|
|
|
// Check if we're running on windows
|
|
Smarty::$_IS_WINDOWS = strtoupper(substr(PHP_OS, 0, 3)) === 'WIN';
|
|
|
|
// let PCRE (preg_*) treat strings as ISO-8859-1 if we're not dealing with UTF-8
|
|
if (Smarty::$_CHARSET !== 'UTF-8') {
|
|
Smarty::$_UTF8_MODIFIER = '';
|
|
}
|
|
}
|
|
|
|
/**
|
|
* fetches a rendered Smarty template
|
|
*
|
|
* @param string $template the resource handle of the template file or template object
|
|
* @param mixed $cache_id cache id to be used with this template
|
|
* @param mixed $compile_id compile id to be used with this template
|
|
* @param object $parent next higher level of Smarty variables
|
|
* @param bool $display true: display, false: fetch
|
|
* @param bool $merge_tpl_vars not used - left for BC
|
|
* @param bool $no_output_filter not used - left for BC
|
|
*
|
|
* @throws Exception
|
|
* @throws SmartyException
|
|
* @return string rendered template output
|
|
*/
|
|
public function fetch($template = null, $cache_id = null, $compile_id = null, $parent = null, $display = false, $merge_tpl_vars = true, $no_output_filter = false)
|
|
{
|
|
if ($cache_id !== null && is_object($cache_id)) {
|
|
$parent = $cache_id;
|
|
$cache_id = null;
|
|
}
|
|
if ($parent === null) {
|
|
$parent = $this;
|
|
}
|
|
// get template object
|
|
$_template = is_object($template) ? $template : $this->createTemplate($template, $cache_id, $compile_id, $parent, false);
|
|
// set caching in template object
|
|
$_template->caching = $this->caching;
|
|
// fetch template content
|
|
return $_template->render(true, false, $display);
|
|
}
|
|
|
|
/**
|
|
* displays a Smarty template
|
|
*
|
|
* @param string $template the resource handle of the template file or template object
|
|
* @param mixed $cache_id cache id to be used with this template
|
|
* @param mixed $compile_id compile id to be used with this template
|
|
* @param object $parent next higher level of Smarty variables
|
|
*/
|
|
public function display($template = null, $cache_id = null, $compile_id = null, $parent = null)
|
|
{
|
|
// display template
|
|
$this->fetch($template, $cache_id, $compile_id, $parent, true);
|
|
}
|
|
|
|
/**
|
|
* Check if a template resource exists
|
|
*
|
|
* @param string $resource_name template name
|
|
*
|
|
* @return boolean status
|
|
*/
|
|
public function templateExists($resource_name)
|
|
{
|
|
// create template object
|
|
$save = $this->template_objects;
|
|
$tpl = new $this->template_class($resource_name, $this);
|
|
// check if it does exists
|
|
$result = $tpl->source->exists;
|
|
$this->template_objects = $save;
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Returns a single or all global variables
|
|
*
|
|
* @param string $varname variable name or null
|
|
*
|
|
* @return string variable value or or array of variables
|
|
*/
|
|
public function getGlobal($varname = null)
|
|
{
|
|
if (isset($varname)) {
|
|
if (isset(self::$global_tpl_vars[$varname])) {
|
|
return self::$global_tpl_vars[$varname]->value;
|
|
} else {
|
|
return '';
|
|
}
|
|
} else {
|
|
$_result = array();
|
|
foreach (self::$global_tpl_vars AS $key => $var) {
|
|
$_result[$key] = $var->value;
|
|
}
|
|
|
|
return $_result;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Empty cache folder
|
|
*
|
|
* @param integer $exp_time expiration time
|
|
* @param string $type resource type
|
|
*
|
|
* @return integer number of cache files deleted
|
|
*/
|
|
public function clearAllCache($exp_time = null, $type = null)
|
|
{
|
|
// load cache resource and call clearAll
|
|
$_cache_resource = Smarty_CacheResource::load($this, $type);
|
|
Smarty_CacheResource::invalidLoadedCache($this);
|
|
|
|
return $_cache_resource->clearAll($this, $exp_time);
|
|
}
|
|
|
|
/**
|
|
* Empty cache for a specific template
|
|
*
|
|
* @param string $template_name template name
|
|
* @param string $cache_id cache id
|
|
* @param string $compile_id compile id
|
|
* @param integer $exp_time expiration time
|
|
* @param string $type resource type
|
|
*
|
|
* @return integer number of cache files deleted
|
|
*/
|
|
public function clearCache($template_name, $cache_id = null, $compile_id = null, $exp_time = null, $type = null)
|
|
{
|
|
// load cache resource and call clear
|
|
$_cache_resource = Smarty_CacheResource::load($this, $type);
|
|
Smarty_CacheResource::invalidLoadedCache($this);
|
|
|
|
return $_cache_resource->clear($this, $template_name, $cache_id, $compile_id, $exp_time);
|
|
}
|
|
|
|
/**
|
|
* Loads security class and enables security
|
|
*
|
|
* @param string|Smarty_Security $security_class if a string is used, it must be class-name
|
|
*
|
|
* @return Smarty current Smarty instance for chaining
|
|
* @throws SmartyException when an invalid class name is provided
|
|
*/
|
|
public function enableSecurity($security_class = null)
|
|
{
|
|
if ($security_class instanceof Smarty_Security) {
|
|
$this->security_policy = $security_class;
|
|
|
|
return $this;
|
|
} elseif (is_object($security_class)) {
|
|
throw new SmartyException("Class '" . get_class($security_class) . "' must extend Smarty_Security.");
|
|
}
|
|
if ($security_class == null) {
|
|
$security_class = $this->security_class;
|
|
}
|
|
if (!class_exists($security_class)) {
|
|
throw new SmartyException("Security class '$security_class' is not defined");
|
|
} elseif ($security_class !== 'Smarty_Security' && !is_subclass_of($security_class, 'Smarty_Security')) {
|
|
throw new SmartyException("Class '$security_class' must extend Smarty_Security.");
|
|
} else {
|
|
$this->security_policy = new $security_class($this);
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Disable security
|
|
*
|
|
* @return Smarty current Smarty instance for chaining
|
|
*/
|
|
public function disableSecurity()
|
|
{
|
|
$this->security_policy = null;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Set template directory
|
|
*
|
|
* @param string|array $template_dir directory(s) of template sources
|
|
*
|
|
* @return Smarty current Smarty instance for chaining
|
|
*/
|
|
public function setTemplateDir($template_dir)
|
|
{
|
|
$this->template_dir = array();
|
|
foreach ((array) $template_dir as $k => $v) {
|
|
$this->template_dir[$k] = rtrim($v, '/\\') . DS;
|
|
}
|
|
$this->joined_template_dir = join(' # ', $this->template_dir);
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Add template directory(s)
|
|
*
|
|
* @param string|array $template_dir directory(s) of template sources
|
|
* @param string $key of the array element to assign the template dir to
|
|
*
|
|
* @return Smarty current Smarty instance for chaining
|
|
* @throws SmartyException when the given template directory is not valid
|
|
*/
|
|
public function addTemplateDir($template_dir, $key = null)
|
|
{
|
|
$this->_addDir('template_dir', $template_dir, $key);
|
|
$this->joined_template_dir = join(' # ', $this->template_dir);
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get template directories
|
|
*
|
|
* @param mixed $index index of directory to get, null to get all
|
|
*
|
|
* @return array|string list of template directories, or directory of $index
|
|
*/
|
|
public function getTemplateDir($index = null)
|
|
{
|
|
if ($index !== null) {
|
|
return isset($this->template_dir[$index]) ? $this->template_dir[$index] : null;
|
|
}
|
|
return (array) $this->template_dir;
|
|
}
|
|
|
|
/**
|
|
* Set config directory
|
|
*
|
|
* @param $config_dir
|
|
*
|
|
* @return Smarty current Smarty instance for chaining
|
|
*/
|
|
public function setConfigDir($config_dir)
|
|
{
|
|
$this->config_dir = array();
|
|
foreach ((array) $config_dir as $k => $v) {
|
|
$this->config_dir[$k] = rtrim($v, '/\\') . DS;
|
|
}
|
|
$this->joined_config_dir = join(' # ', $this->config_dir);
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Add config directory(s)
|
|
*
|
|
* @param string|array $config_dir directory(s) of config sources
|
|
* @param mixed $key key of the array element to assign the config dir to
|
|
*
|
|
* @return Smarty current Smarty instance for chaining
|
|
*/
|
|
public function addConfigDir($config_dir, $key = null)
|
|
{
|
|
$this->_addDir('config_dir', $config_dir, $key);
|
|
$this->joined_config_dir = join(' # ', $this->config_dir);
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get config directory
|
|
*
|
|
* @param mixed $index index of directory to get, null to get all
|
|
*
|
|
* @return array|string configuration directory
|
|
*/
|
|
public function getConfigDir($index = null)
|
|
{
|
|
if ($index !== null) {
|
|
return isset($this->config_dir[$index]) ? $this->config_dir[$index] : null;
|
|
}
|
|
return (array) $this->config_dir;
|
|
}
|
|
|
|
/**
|
|
* Set plugins directory
|
|
*
|
|
* @param string|array $plugins_dir directory(s) of plugins
|
|
*
|
|
* @return Smarty current Smarty instance for chaining
|
|
*/
|
|
public function setPluginsDir($plugins_dir)
|
|
{
|
|
$this->plugins_dir = array();
|
|
$this->addPluginsDir($plugins_dir);
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Adds directory of plugin files
|
|
*
|
|
* @param $plugins_dir
|
|
*
|
|
* @return Smarty current Smarty instance for chaining
|
|
*/
|
|
public function addPluginsDir($plugins_dir)
|
|
{
|
|
// make sure we're dealing with an array
|
|
$this->plugins_dir = (array) $this->plugins_dir;
|
|
foreach ((array) $plugins_dir as $v) {
|
|
$this->plugins_dir[] = rtrim($v, '/\\') . DS;
|
|
}
|
|
$this->plugins_dir = array_unique($this->plugins_dir);
|
|
$this->_is_file_cache = array();
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get plugin directories
|
|
*
|
|
* @return array list of plugin directories
|
|
*/
|
|
public function getPluginsDir()
|
|
{
|
|
return (array) $this->plugins_dir;
|
|
}
|
|
|
|
/**
|
|
* Set compile directory
|
|
*
|
|
* @param string $compile_dir directory to store compiled templates in
|
|
*
|
|
* @return Smarty current Smarty instance for chaining
|
|
*/
|
|
public function setCompileDir($compile_dir)
|
|
{
|
|
$this->compile_dir = rtrim($compile_dir, '/\\') . DS;
|
|
if (!isset(Smarty::$_muted_directories[$this->compile_dir])) {
|
|
Smarty::$_muted_directories[$this->compile_dir] = null;
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get compiled directory
|
|
*
|
|
* @return string path to compiled templates
|
|
*/
|
|
public function getCompileDir()
|
|
{
|
|
return $this->compile_dir;
|
|
}
|
|
|
|
/**
|
|
* Set cache directory
|
|
*
|
|
* @param string $cache_dir directory to store cached templates in
|
|
*
|
|
* @return Smarty current Smarty instance for chaining
|
|
*/
|
|
public function setCacheDir($cache_dir)
|
|
{
|
|
$this->cache_dir = rtrim($cache_dir, '/\\') . DS;
|
|
if (!isset(Smarty::$_muted_directories[$this->cache_dir])) {
|
|
Smarty::$_muted_directories[$this->cache_dir] = null;
|
|
}
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get cache directory
|
|
*
|
|
* @return string path of cache directory
|
|
*/
|
|
public function getCacheDir()
|
|
{
|
|
return $this->cache_dir;
|
|
}
|
|
|
|
/**
|
|
* add directories to given property name
|
|
*
|
|
* @param string $dirName directory property name
|
|
* @param string|array $dir directory string or array of strings
|
|
* @param mixed $key optional key
|
|
*/
|
|
private function _addDir($dirName, $dir, $key = null)
|
|
{
|
|
// make sure we're dealing with an array
|
|
$this->$dirName = (array) $this->$dirName;
|
|
|
|
if (is_array($dir)) {
|
|
foreach ($dir as $k => $v) {
|
|
if (is_int($k)) {
|
|
// indexes are not merged but appended
|
|
$this->{$dirName}[] = rtrim($v, '/\\') . DS;
|
|
} else {
|
|
// string indexes are overridden
|
|
$this->{$dirName}[$k] = rtrim($v, '/\\') . DS;
|
|
}
|
|
}
|
|
} else {
|
|
if ($key !== null) {
|
|
// override directory at specified index
|
|
$this->{$dirName}[$key] = rtrim($dir, '/\\') . DS;
|
|
} else {
|
|
// append new directory
|
|
$this->{$dirName}[] = rtrim($dir, '/\\') . DS;
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Set default modifiers
|
|
*
|
|
* @param array|string $modifiers modifier or list of modifiers to set
|
|
*
|
|
* @return Smarty current Smarty instance for chaining
|
|
*/
|
|
public function setDefaultModifiers($modifiers)
|
|
{
|
|
$this->default_modifiers = (array) $modifiers;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Add default modifiers
|
|
*
|
|
* @param array|string $modifiers modifier or list of modifiers to add
|
|
*
|
|
* @return Smarty current Smarty instance for chaining
|
|
*/
|
|
public function addDefaultModifiers($modifiers)
|
|
{
|
|
if (is_array($modifiers)) {
|
|
$this->default_modifiers = array_merge($this->default_modifiers, $modifiers);
|
|
} else {
|
|
$this->default_modifiers[] = $modifiers;
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get default modifiers
|
|
*
|
|
* @return array list of default modifiers
|
|
*/
|
|
public function getDefaultModifiers()
|
|
{
|
|
return $this->default_modifiers;
|
|
}
|
|
|
|
/**
|
|
* Set autoload filters
|
|
*
|
|
* @param array $filters filters to load automatically
|
|
* @param string $type "pre", "output", … specify the filter type to set. Defaults to none treating $filters'
|
|
* keys as the appropriate types
|
|
*
|
|
* @return Smarty current Smarty instance for chaining
|
|
*/
|
|
public function setAutoloadFilters($filters, $type = null)
|
|
{
|
|
if ($type !== null) {
|
|
$this->autoload_filters[$type] = (array) $filters;
|
|
} else {
|
|
$this->autoload_filters = (array) $filters;
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Add autoload filters
|
|
*
|
|
* @param array $filters filters to load automatically
|
|
* @param string $type "pre", "output", … specify the filter type to set. Defaults to none treating $filters'
|
|
* keys as the appropriate types
|
|
*
|
|
* @return Smarty current Smarty instance for chaining
|
|
*/
|
|
public function addAutoloadFilters($filters, $type = null)
|
|
{
|
|
if ($type !== null) {
|
|
if (!empty($this->autoload_filters[$type])) {
|
|
$this->autoload_filters[$type] = array_merge($this->autoload_filters[$type], (array) $filters);
|
|
} else {
|
|
$this->autoload_filters[$type] = (array) $filters;
|
|
}
|
|
} else {
|
|
foreach ((array) $filters as $key => $value) {
|
|
if (!empty($this->autoload_filters[$key])) {
|
|
$this->autoload_filters[$key] = array_merge($this->autoload_filters[$key], (array) $value);
|
|
} else {
|
|
$this->autoload_filters[$key] = (array) $value;
|
|
}
|
|
}
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Get autoload filters
|
|
*
|
|
* @param string $type type of filter to get autoloads for. Defaults to all autoload filters
|
|
*
|
|
* @return array array( 'type1' => array( 'filter1', 'filter2', … ) ) or array( 'filter1', 'filter2', …) if $type
|
|
* was specified
|
|
*/
|
|
public function getAutoloadFilters($type = null)
|
|
{
|
|
if ($type !== null) {
|
|
return isset($this->autoload_filters[$type]) ? $this->autoload_filters[$type] : array();
|
|
}
|
|
|
|
return $this->autoload_filters;
|
|
}
|
|
|
|
/**
|
|
* return name of debugging template
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getDebugTemplate()
|
|
{
|
|
return $this->debug_tpl;
|
|
}
|
|
|
|
/**
|
|
* set the debug template
|
|
*
|
|
* @param string $tpl_name
|
|
*
|
|
* @return Smarty current Smarty instance for chaining
|
|
* @throws SmartyException if file is not readable
|
|
*/
|
|
public function setDebugTemplate($tpl_name)
|
|
{
|
|
if (!is_readable($tpl_name)) {
|
|
throw new SmartyException("Unknown file '{$tpl_name}'");
|
|
}
|
|
$this->debug_tpl = $tpl_name;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* creates a template object
|
|
*
|
|
* @param string $template the resource handle of the template file
|
|
* @param mixed $cache_id cache id to be used with this template
|
|
* @param mixed $compile_id compile id to be used with this template
|
|
* @param object $parent next higher level of Smarty variables
|
|
* @param boolean $do_clone flag is Smarty object shall be cloned
|
|
*
|
|
* @return object template object
|
|
*/
|
|
public function createTemplate($template, $cache_id = null, $compile_id = null, $parent = null, $do_clone = true)
|
|
{
|
|
if ($cache_id !== null && (is_object($cache_id) || is_array($cache_id))) {
|
|
$parent = $cache_id;
|
|
$cache_id = null;
|
|
}
|
|
if ($parent !== null && is_array($parent)) {
|
|
$data = $parent;
|
|
$parent = null;
|
|
} else {
|
|
$data = null;
|
|
}
|
|
$_templateId = $this->getTemplateId($template, $cache_id, $compile_id);
|
|
if (isset($this->template_objects[$_templateId])) {
|
|
if ($do_clone) {
|
|
$tpl = clone $this->template_objects[$_templateId];
|
|
$tpl->smarty = clone $tpl->smarty;
|
|
} else {
|
|
$tpl = $this->template_objects[$_templateId];
|
|
}
|
|
$tpl->parent = $parent;
|
|
$tpl->tpl_vars = array();
|
|
$tpl->config_vars = array();
|
|
} else {
|
|
$tpl = new $this->template_class($template, $this, $parent, $cache_id, $compile_id);
|
|
if ($do_clone) {
|
|
$tpl->smarty = clone $tpl->smarty;
|
|
}
|
|
$tpl->templateId = $_templateId;
|
|
}
|
|
// fill data if present
|
|
if (!empty($data) && is_array($data)) {
|
|
// set up variable values
|
|
foreach ($data as $_key => $_val) {
|
|
$tpl->tpl_vars[$_key] = new Smarty_Variable($_val);
|
|
}
|
|
}
|
|
if ($this->debugging) {
|
|
Smarty_Internal_Debug::register_template($tpl);
|
|
}
|
|
return $tpl;
|
|
}
|
|
|
|
/**
|
|
* Takes unknown classes and loads plugin files for them
|
|
* class name format: Smarty_PluginType_PluginName
|
|
* plugin filename format: plugintype.pluginname.php
|
|
*
|
|
* @param string $plugin_name class plugin name to load
|
|
* @param bool $check check if already loaded
|
|
*
|
|
* @throws SmartyException
|
|
* @return string |boolean filepath of loaded file or false
|
|
*/
|
|
public function loadPlugin($plugin_name, $check = true)
|
|
{
|
|
// if function or class exists, exit silently (already loaded)
|
|
if ($check && (is_callable($plugin_name) || class_exists($plugin_name, false))) {
|
|
return true;
|
|
}
|
|
// Plugin name is expected to be: Smarty_[Type]_[Name]
|
|
$_name_parts = explode('_', $plugin_name, 3);
|
|
// class name must have three parts to be valid plugin
|
|
// count($_name_parts) < 3 === !isset($_name_parts[2])
|
|
if (!isset($_name_parts[2]) || strtolower($_name_parts[0]) !== 'smarty') {
|
|
throw new SmartyException("plugin {$plugin_name} is not a valid name format");
|
|
}
|
|
// if type is "internal", get plugin from sysplugins
|
|
if (strtolower($_name_parts[1]) == 'internal') {
|
|
$file = SMARTY_SYSPLUGINS_DIR . strtolower($plugin_name) . '.php';
|
|
if (isset($this->_is_file_cache[$file]) ? $this->_is_file_cache[$file] : $this->_is_file_cache[$file] = is_file($file)) {
|
|
require_once($file);
|
|
return $file;
|
|
} else {
|
|
return false;
|
|
}
|
|
}
|
|
// plugin filename is expected to be: [type].[name].php
|
|
$_plugin_filename = "{$_name_parts[1]}.{$_name_parts[2]}.php";
|
|
|
|
$_stream_resolve_include_path = function_exists('stream_resolve_include_path');
|
|
|
|
// loop through plugin dirs and find the plugin
|
|
foreach ($this->getPluginsDir() as $_plugin_dir) {
|
|
$names = array($_plugin_dir . $_plugin_filename, $_plugin_dir . strtolower($_plugin_filename),);
|
|
foreach ($names as $file) {
|
|
if (isset($this->_is_file_cache[$file]) ? $this->_is_file_cache[$file] : $this->_is_file_cache[$file] = is_file($file)) {
|
|
require_once($file);
|
|
return $file;
|
|
}
|
|
if ($this->use_include_path && !preg_match('/^([\/\\\\]|[a-zA-Z]:[\/\\\\])/', $_plugin_dir)) {
|
|
// try PHP include_path
|
|
if ($_stream_resolve_include_path) {
|
|
$file = stream_resolve_include_path($file);
|
|
} else {
|
|
$file = Smarty_Internal_Get_Include_Path::getIncludePath($file);
|
|
}
|
|
|
|
if ($file !== false) {
|
|
require_once($file);
|
|
|
|
return $file;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
// no plugin loaded
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Compile all template files
|
|
*
|
|
* @param string $extension file extension
|
|
* @param bool $force_compile force all to recompile
|
|
* @param int $time_limit
|
|
* @param int $max_errors
|
|
*
|
|
* @return integer number of template files recompiled
|
|
*/
|
|
public function compileAllTemplates($extension = '.tpl', $force_compile = false, $time_limit = 0, $max_errors = null)
|
|
{
|
|
return Smarty_Internal_Utility::compileAllTemplates($extension, $force_compile, $time_limit, $max_errors, $this);
|
|
}
|
|
|
|
/**
|
|
* Compile all config files
|
|
*
|
|
* @param string $extension file extension
|
|
* @param bool $force_compile force all to recompile
|
|
* @param int $time_limit
|
|
* @param int $max_errors
|
|
*
|
|
* @return integer number of template files recompiled
|
|
*/
|
|
public function compileAllConfig($extension = '.conf', $force_compile = false, $time_limit = 0, $max_errors = null)
|
|
{
|
|
return Smarty_Internal_Utility::compileAllConfig($extension, $force_compile, $time_limit, $max_errors, $this);
|
|
}
|
|
|
|
/**
|
|
* Delete compiled template file
|
|
*
|
|
* @param string $resource_name template name
|
|
* @param string $compile_id compile id
|
|
* @param integer $exp_time expiration time
|
|
*
|
|
* @return integer number of template files deleted
|
|
*/
|
|
public function clearCompiledTemplate($resource_name = null, $compile_id = null, $exp_time = null)
|
|
{
|
|
return Smarty_Internal_Utility::clearCompiledTemplate($resource_name, $compile_id, $exp_time, $this);
|
|
}
|
|
|
|
/**
|
|
* Return array of tag/attributes of all tags used by an template
|
|
*
|
|
* @param Smarty_Internal_Template $template
|
|
*
|
|
* @return array of tag/attributes
|
|
*/
|
|
public function getTags(Smarty_Internal_Template $template)
|
|
{
|
|
return Smarty_Internal_Utility::getTags($template);
|
|
}
|
|
|
|
/**
|
|
* Run installation test
|
|
*
|
|
* @param array $errors Array to write errors into, rather than outputting them
|
|
*
|
|
* @return boolean true if setup is fine, false if something is wrong
|
|
*/
|
|
public function testInstall(&$errors = null)
|
|
{
|
|
return Smarty_Internal_TestInstall::testInstall($this, $errors);
|
|
}
|
|
|
|
/**
|
|
* @param boolean $compile_check
|
|
*/
|
|
public function setCompileCheck($compile_check)
|
|
{
|
|
$this->compile_check = $compile_check;
|
|
}
|
|
|
|
/**
|
|
* @param boolean $use_sub_dirs
|
|
*/
|
|
public function setUseSubDirs($use_sub_dirs)
|
|
{
|
|
$this->use_sub_dirs = $use_sub_dirs;
|
|
}
|
|
|
|
/**
|
|
* @param boolean $caching
|
|
*/
|
|
public function setCaching($caching)
|
|
{
|
|
$this->caching = $caching;
|
|
}
|
|
|
|
/**
|
|
* @param int $cache_lifetime
|
|
*/
|
|
public function setCacheLifetime($cache_lifetime)
|
|
{
|
|
$this->cache_lifetime = $cache_lifetime;
|
|
}
|
|
|
|
/**
|
|
* @param string $compile_id
|
|
*/
|
|
public function setCompileId($compile_id)
|
|
{
|
|
$this->compile_id = $compile_id;
|
|
}
|
|
|
|
/**
|
|
* @param string $cache_id
|
|
*/
|
|
public function setCacheId($cache_id)
|
|
{
|
|
$this->cache_id = $cache_id;
|
|
}
|
|
|
|
/**
|
|
* @param int $error_reporting
|
|
*/
|
|
public function setErrorReporting($error_reporting)
|
|
{
|
|
$this->error_reporting = $error_reporting;
|
|
}
|
|
|
|
/**
|
|
* @param boolean $escape_html
|
|
*/
|
|
public function setEscapeHtml($escape_html)
|
|
{
|
|
$this->escape_html = $escape_html;
|
|
}
|
|
|
|
/**
|
|
* @param boolean $auto_literal
|
|
*/
|
|
public function setAutoLiteral($auto_literal)
|
|
{
|
|
$this->auto_literal = $auto_literal;
|
|
}
|
|
|
|
/**
|
|
* @param boolean $force_compile
|
|
*/
|
|
public function setForceCompile($force_compile)
|
|
{
|
|
$this->force_compile = $force_compile;
|
|
}
|
|
|
|
/**
|
|
* @param boolean $merge_compiled_includes
|
|
*/
|
|
public function setMergeCompiledIncludes($merge_compiled_includes)
|
|
{
|
|
$this->merge_compiled_includes = $merge_compiled_includes;
|
|
}
|
|
|
|
/**
|
|
* @param string $left_delimiter
|
|
*/
|
|
public function setLeftDelimiter($left_delimiter)
|
|
{
|
|
$this->left_delimiter = $left_delimiter;
|
|
}
|
|
|
|
/**
|
|
* @param string $right_delimiter
|
|
*/
|
|
public function setRightDelimiter($right_delimiter)
|
|
{
|
|
$this->right_delimiter = $right_delimiter;
|
|
}
|
|
|
|
/**
|
|
* @param boolean $debugging
|
|
*/
|
|
public function setDebugging($debugging)
|
|
{
|
|
$this->debugging = $debugging;
|
|
}
|
|
|
|
/**
|
|
* @param boolean $config_overwrite
|
|
*/
|
|
public function setConfigOverwrite($config_overwrite)
|
|
{
|
|
$this->config_overwrite = $config_overwrite;
|
|
}
|
|
|
|
/**
|
|
* @param boolean $config_booleanize
|
|
*/
|
|
public function setConfigBooleanize($config_booleanize)
|
|
{
|
|
$this->config_booleanize = $config_booleanize;
|
|
}
|
|
|
|
/**
|
|
* @param boolean $config_read_hidden
|
|
*/
|
|
public function setConfigReadHidden($config_read_hidden)
|
|
{
|
|
$this->config_read_hidden = $config_read_hidden;
|
|
}
|
|
|
|
/**
|
|
* @param boolean $compile_locking
|
|
*/
|
|
public function setCompileLocking($compile_locking)
|
|
{
|
|
$this->compile_locking = $compile_locking;
|
|
}
|
|
|
|
/**
|
|
* Class destructor
|
|
*/
|
|
public function __destruct()
|
|
{
|
|
// intentionally left blank
|
|
}
|
|
|
|
/**
|
|
* <<magic>> Generic getter.
|
|
* Calls the appropriate getter function.
|
|
* Issues an E_USER_NOTICE if no valid getter is found.
|
|
*
|
|
* @param string $name property name
|
|
*
|
|
* @return mixed
|
|
*/
|
|
public function __get($name)
|
|
{
|
|
$allowed = array('template_dir' => 'getTemplateDir', 'config_dir' => 'getConfigDir',
|
|
'plugins_dir' => 'getPluginsDir', 'compile_dir' => 'getCompileDir',
|
|
'cache_dir' => 'getCacheDir',);
|
|
|
|
if (isset($allowed[$name])) {
|
|
return $this->{$allowed[$name]}();
|
|
} else {
|
|
trigger_error('Undefined property: ' . get_class($this) . '::$' . $name, E_USER_NOTICE);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* <<magic>> Generic setter.
|
|
* Calls the appropriate setter function.
|
|
* Issues an E_USER_NOTICE if no valid setter is found.
|
|
*
|
|
* @param string $name property name
|
|
* @param mixed $value parameter passed to setter
|
|
*/
|
|
public function __set($name, $value)
|
|
{
|
|
$allowed = array('template_dir' => 'setTemplateDir', 'config_dir' => 'setConfigDir',
|
|
'plugins_dir' => 'setPluginsDir', 'compile_dir' => 'setCompileDir',
|
|
'cache_dir' => 'setCacheDir',);
|
|
|
|
if (isset($allowed[$name])) {
|
|
$this->{$allowed[$name]}($value);
|
|
} else {
|
|
trigger_error('Undefined property: ' . get_class($this) . '::$' . $name, E_USER_NOTICE);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Error Handler to mute expected messages
|
|
*
|
|
* @link http://php.net/set_error_handler
|
|
*
|
|
* @param integer $errno Error level
|
|
* @param $errstr
|
|
* @param $errfile
|
|
* @param $errline
|
|
* @param $errcontext
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public static function mutingErrorHandler($errno, $errstr, $errfile, $errline, $errcontext)
|
|
{
|
|
$_is_muted_directory = false;
|
|
|
|
// add the SMARTY_DIR to the list of muted directories
|
|
if (!isset(Smarty::$_muted_directories[SMARTY_DIR])) {
|
|
$smarty_dir = realpath(SMARTY_DIR);
|
|
if ($smarty_dir !== false) {
|
|
Smarty::$_muted_directories[SMARTY_DIR] = array('file' => $smarty_dir,
|
|
'length' => strlen($smarty_dir),);
|
|
}
|
|
}
|
|
|
|
// walk the muted directories and test against $errfile
|
|
foreach (Smarty::$_muted_directories as $key => &$dir) {
|
|
if (!$dir) {
|
|
// resolve directory and length for speedy comparisons
|
|
$file = realpath($key);
|
|
if ($file === false) {
|
|
// this directory does not exist, remove and skip it
|
|
unset(Smarty::$_muted_directories[$key]);
|
|
continue;
|
|
}
|
|
$dir = array('file' => $file, 'length' => strlen($file),);
|
|
}
|
|
if (!strncmp($errfile, $dir['file'], $dir['length'])) {
|
|
$_is_muted_directory = true;
|
|
break;
|
|
}
|
|
}
|
|
|
|
// pass to next error handler if this error did not occur inside SMARTY_DIR
|
|
// or the error was within smarty but masked to be ignored
|
|
if (!$_is_muted_directory || ($errno && $errno & error_reporting())) {
|
|
if (Smarty::$_previous_error_handler) {
|
|
return call_user_func(Smarty::$_previous_error_handler, $errno, $errstr, $errfile, $errline, $errcontext);
|
|
} else {
|
|
return false;
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Enable error handler to mute expected messages
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function muteExpectedErrors()
|
|
{
|
|
/*
|
|
error muting is done because some people implemented custom error_handlers using
|
|
http://php.net/set_error_handler and for some reason did not understand the following paragraph:
|
|
|
|
It is important to remember that the standard PHP error handler is completely bypassed for the
|
|
error types specified by error_types unless the callback function returns FALSE.
|
|
error_reporting() settings will have no effect and your error handler will be called regardless -
|
|
however you are still able to read the current value of error_reporting and act appropriately.
|
|
Of particular note is that this value will be 0 if the statement that caused the error was
|
|
prepended by the @ error-control operator.
|
|
|
|
Smarty deliberately uses @filemtime() over file_exists() and filemtime() in some places. Reasons include
|
|
- @filemtime() is almost twice as fast as using an additional file_exists()
|
|
- between file_exists() and filemtime() a possible race condition is opened,
|
|
which does not exist using the simple @filemtime() approach.
|
|
*/
|
|
$error_handler = array('Smarty', 'mutingErrorHandler');
|
|
$previous = set_error_handler($error_handler);
|
|
|
|
// avoid dead loops
|
|
if ($previous !== $error_handler) {
|
|
Smarty::$_previous_error_handler = $previous;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Disable error handler muting expected messages
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function unmuteExpectedErrors()
|
|
{
|
|
restore_error_handler();
|
|
}
|
|
}
|