Class: Smarty
Source Location: /phpDocumentor/Smarty-2.6.0/libs/Smarty.class.php
Class Smarty
Property Summary
array |
$autoload_filters |
This indicates which filters are automatically loaded into Smarty. |
string |
$cache_dir |
The name of the directory for cache files. |
null|string |
$cache_handler_func |
The function used for cache file handling. If not set, built-in caching is used. |
integer |
$cache_lifetime |
This is the number of seconds cached content will persist. |
boolean |
$cache_modified_check |
Only used when $caching is enabled. If true, then If-Modified-Since headers are respected with cached content, and appropriate HTTP headers are sent. |
integer |
$caching |
This enables template caching. |
string |
$compiler_file |
The file that contains the compiler class. This can a full pathname, or relative to the php_include path. |
boolean |
$compile_check |
This tells Smarty whether to check for recompiling or not. Recompiling does not need to happen unless a template or config file is changed. |
string |
$compile_dir |
The directory where compiled templates are located. |
string |
$compile_id |
Set this if you want different sets of compiled files for the same templates. This is useful for things like different languages. |
mixed |
$config_booleanize |
This tells whether or not to automatically booleanize config file variables. |
string |
$config_dir |
The directory where config files are located. |
mixed |
$config_overwrite |
This tells if config file vars of the same name overwrite each other or not. |
mixed |
$config_read_hidden |
This tells whether hidden sections [.foobar] are readable from the tempalates or not. Normally you would never allow this since that is the point behind hidden sections: the application can access them, but the templates cannot. |
boolean |
$debugging |
If debugging is enabled, a debug console window will display when the page loads (make sure your browser allows unrequested popup windows) |
string |
$debugging_ctrl |
This determines if debugging is enable-able from the browser. |
string |
$debug_tpl |
This is the path to the debug console template. If not set, the default one will be used. |
array |
$default_modifiers |
This is a list of the modifiers to apply to all template variables. |
boolean |
$force_compile |
This forces templates to compile every time. Useful for development or debugging. |
array |
$global_assign |
These are the variables from the globals array that are assigned to all templates automatically. This isn't really necessary any more, you can use the $smarty var to access them directly. |
integer |
$php_handling |
This determines how Smarty handles "<?php ... ?>" tags in templates. |
array |
$plugins_dir |
An array of directories searched for plugins. |
string |
$request_vars_order |
The order in which request variables are registered, similar to variables_order in php.ini E = Environment, G = GET, P = POST, C = Cookies, S = Server |
array |
$secure_dir |
This is the list of template directories that are considered secure. This is used only if $security is enabled. One directory per array element. $template_dir is in this list implicitly. |
boolean |
$security |
This enables template security. When enabled, many things are restricted |
array |
$security_settings |
These are the security settings for Smarty. They are used only when $security is enabled. |
string |
$template_dir |
The name of the directory where templates are located. |
array |
$trusted_dir |
This is an array of directories where trusted php scripts reside. |
null |
$undefined |
The value of "undefined". Leave it alone :-) |
boolean |
$use_sub_dirs |
This tells Smarty whether or not to use sub dirs in the cache/ and templates_c/ directories. sub directories better organized, but may not work well with PHP safe mode enabled. |
Method Summary
Smarty |
Smarty() |
The class constructor. |
void |
append() |
appends values to template variables |
void |
append_by_ref() |
appends values to template variables by reference |
void |
assign() |
assigns values to template variables |
void |
assign_by_ref() |
assigns values to template variables by reference |
boolean |
clear_all_cache() |
clear the entire contents of cache (all templates) |
void |
clear_assign() |
clear the given assigned template variable. |
boolean |
clear_cache() |
clear cached content for the given template and cache id |
boolean |
clear_compiled_tpl() |
clears compiled version of specified template resource, or all compiled template files if one is not specified. |
void |
display() |
executes & displays the template results |
void |
fetch() |
executes & returns or displays the template results |
string|false |
is_cached() |
test to see if valid cache exists for this template |
void |
load_filter() |
load a filter of specified type and name |
void |
register_block() |
Registers block function to be used in templates |
void |
register_postfilter() |
Registers a postfilter function to apply to a compiled template after compilation |
void |
register_prefilter() |
Registers a prefilter function to apply to a template before compiling |
string |
_dequote() |
Remove starting and ending quotes from the string |
mixed |
_eval() |
wrapper for eval() retaining $this |
boolean |
_fetch_resource_info() |
fetch the template info. Gets timestamp, and source if get_source is true |
string|null |
_get_auto_id() |
returns an auto_id for auto-file-functions |
mixed |
_include() |
wrapper for include() retaining $this |
string |
_read_file() |
read in a file from line $start for $lines. |
void |
_unlink() |
unlink a file, possibly using expiration time |
Properties
This indicates which filters are automatically loaded into Smarty.
Smarty Configuration Section
The name of the directory for cache files.
Smarty Configuration Section
The function used for cache file handling. If not set, built-in caching is used.
Smarty Configuration Section
This is the number of seconds cached content will persist.
Smarty Configuration Section - 0 = always regenerate cache
- -1 = never expires
Only used when $caching is enabled. If true, then If-Modified-Since headers are respected with cached content, and appropriate HTTP headers are sent.
Smarty Configuration Section This way repeated hits to a cached page do not send the entire page to the client every time.
This enables template caching.
Smarty Configuration Section - 0 = no caching
- 1 = use class cache_lifetime value
- 2 = use cache_lifetime in cache file
The class used for compiling templates.
The file that contains the compiler class. This can a full pathname, or relative to the php_include path.
This tells Smarty whether to check for recompiling or not. Recompiling does not need to happen unless a template or config file is changed.
Smarty Configuration Section Typically you enable this during development, and disable for production.
The directory where compiled templates are located.
Smarty Configuration Section
Set this if you want different sets of compiled files for the same templates. This is useful for things like different languages.
Smarty Configuration Section Instead of creating separate sets of templates per language, you set different compile_ids like 'en' and 'de'.
This tells whether or not to automatically booleanize config file variables.
If enabled, then the strings "on", "true", and "yes" are treated as boolean true, and "off", "false" and "no" are treated as boolean false.
The class used to load config vars.
The directory where config files are located.
Smarty Configuration Section
This tells whether or not automatically fix newlines in config files.
It basically converts \r (mac) or \r\n (dos) to \n
This tells if config file vars of the same name overwrite each other or not.
if disabled, same name variables are accumulated in an array.
This tells whether hidden sections [.foobar] are readable from the tempalates or not. Normally you would never allow this since that is the point behind hidden sections: the application can access them, but the templates cannot.
If debugging is enabled, a debug console window will display when the page loads (make sure your browser allows unrequested popup windows)
Smarty Configuration Section
This determines if debugging is enable-able from the browser.
Smarty Configuration Section - NONE => no debugging control allowed
- URL => enable debugging when SMARTY_DEBUG is found in the URL.
Information Tags:
This is the path to the debug console template. If not set, the default one will be used.
Smarty Configuration Section
This is a list of the modifiers to apply to all template variables.
Smarty Configuration Section Put each modifier in a separate array element in the order you want them applied. example: array('escape:"htmlall"');
This is the resource type to be used when not specified
Smarty Configuration Section at the beginning of the resource path. examples: $smarty->display('file:index.tpl'); $smarty->display('db:index.tpl'); $smarty->display('index.tpl'); // will use default resource type {include file="file:index.tpl"} {include file="db:index.tpl"} {include file="index.tpl"} {* will use default resource type *}
If a template cannot be found, this PHP function will be executed.
Useful for creating templates on-the-fly or other special action.
This forces templates to compile every time. Useful for development or debugging.
Smarty Configuration Section
These are the variables from the globals array that are assigned to all templates automatically. This isn't really necessary any more, you can use the $smarty var to access them directly.
Smarty Configuration Section API Tags:
The left delimiter used for the template tags.
Smarty Configuration Section
This determines how Smarty handles "<?php ... ?>" tags in templates.
Smarty Configuration Section possible values: - SMARTY_PHP_PASSTHRU -> print tags as plain text
- SMARTY_PHP_QUOTE -> escape tags as entities
- SMARTY_PHP_REMOVE -> remove php tags
- SMARTY_PHP_ALLOW -> execute php tags
An array of directories searched for plugins.
Smarty Configuration Section
Indicates wether $HTTP_*_VARS[] (request_use_auto_globals=false)
Smarty Configuration Section are uses as request-vars or $_*[]-vars. note: if request_use_auto_globals is true, then $request_vars_order has no effect, but the php-ini-value "gpc_order"
The order in which request variables are registered, similar to variables_order in php.ini E = Environment, G = GET, P = POST, C = Cookies, S = Server
Smarty Configuration Section
The right delimiter used for the template tags.
Smarty Configuration Section
This is the list of template directories that are considered secure. This is used only if $security is enabled. One directory per array element. $template_dir is in this list implicitly.
Smarty Configuration Section
This enables template security. When enabled, many things are restricted
Smarty Configuration Section in the templates that normally would go unchecked. This is useful when untrusted parties are editing templates and you want a reasonable level of security. (no direct execution of PHP in templates for example)
These are the security settings for Smarty. They are used only when $security is enabled.
Smarty Configuration Section
The name of the directory where templates are located.
Smarty Configuration Section
This is an array of directories where trusted php scripts reside.
Smarty Configuration Section $security is disabled during their inclusion/execution.
The value of "undefined". Leave it alone :-)
Smarty Configuration Section
This tells Smarty whether or not to use sub dirs in the cache/ and templates_c/ directories. sub directories better organized, but may not work well with PHP safe mode enabled.
Smarty Configuration Section
Methods
The class constructor.
API Tags:
void append(
array|string
$tpl_var, [mixed
$value = null], [
$merge = false]
)
|
|
appends values to template variables
Parameters:
array|string |
$tpl_var: |
the template variable name(s) |
mixed |
$value: |
the value to append |
|
$merge: |
|
void append_by_ref(
string
$tpl_var,
&$value, [
$merge = false], mixed
$value
)
|
|
appends values to template variables by reference
Parameters:
string |
$tpl_var: |
the template variable name |
mixed |
$value: |
the referenced value to append |
|
&$value: |
|
|
$merge: |
|
void assign(
array|string
$tpl_var, [mixed
$value = null]
)
|
|
assigns values to template variables
Parameters:
array|string |
$tpl_var: |
the template variable name(s) |
mixed |
$value: |
the value to assign |
void assign_by_ref(
string
$tpl_var,
&$value, mixed
$value
)
|
|
assigns values to template variables by reference
Parameters:
string |
$tpl_var: |
the template variable name |
mixed |
$value: |
the referenced value to assign |
|
&$value: |
|
clear all the assigned template variables.
boolean clear_all_cache(
[string
$exp_time = null]
)
|
|
clear the entire contents of cache (all templates)
Parameters:
string |
$exp_time: |
expire time |
API Tags:
void clear_assign(
string
$tpl_var
)
|
|
clear the given assigned template variable.
Parameters:
string |
$tpl_var: |
the template variable to clear |
boolean clear_cache(
[string
$tpl_file = null], [string
$cache_id = null], [string
$compile_id = null], [string
$exp_time = null]
)
|
|
clear cached content for the given template and cache id
Parameters:
string |
$tpl_file: |
name of template file |
string |
$cache_id: |
name of cache_id |
string |
$compile_id: |
name of compile_id |
string |
$exp_time: |
expiration time |
boolean clear_compiled_tpl(
[string
$tpl_file = null], [string
$compile_id = null], [string
$exp_time = null]
)
|
|
clears compiled version of specified template resource, or all compiled template files if one is not specified.
This function is for advanced use only, not normally needed.
Parameters:
string |
$tpl_file: |
|
string |
$compile_id: |
|
string |
$exp_time: |
|
API Tags:
void clear_config(
[string
$var = null]
)
|
|
clear configuration values
Parameters:
void config_load(
string
$file, [string
$section = null], [string
$scope = 'global']
)
|
|
load configuration values
Parameters:
string |
$file: |
|
string |
$section: |
|
string |
$scope: |
|
void display(
string
$resource_name, [string
$cache_id = null], [string
$compile_id = null]
)
|
|
executes & displays the template results
Parameters:
string |
$resource_name: |
|
string |
$cache_id: |
|
string |
$compile_id: |
|
void fetch(
string
$resource_name, [string
$cache_id = null], [string
$compile_id = null], [boolean
$display = false]
)
|
|
executes & returns or displays the template results
Parameters:
string |
$resource_name: |
|
string |
$cache_id: |
|
string |
$compile_id: |
|
boolean |
$display: |
|
array &get_config_vars(
[string
$name = null], string
$type
)
|
|
Returns an array containing config variables
Parameters:
string |
$name: |
|
string |
$type: |
|
object &get_registered_object(
string
$name
)
|
|
return a reference to a registered object
Parameters:
array &get_template_vars(
[string
$name = null], string
$type
)
|
|
Returns an array containing template variables
Parameters:
string |
$name: |
|
string |
$type: |
|
string|false is_cached(
string
$tpl_file, [string
$cache_id = null], [string
$compile_id = null]
)
|
|
test to see if valid cache exists for this template
Parameters:
string |
$tpl_file: |
name of template file |
string |
$cache_id: |
|
string |
$compile_id: |
|
API Tags:
Return: | results of _read_cache_file() |
void load_filter(
string
$type, string
$name
)
|
|
load a filter of specified type and name
Parameters:
string |
$type: |
filter type |
string |
$name: |
filter name |
void register_block(
string
$block, string
$block_impl, [
$cacheable = true], [
$cache_attrs = null]
)
|
|
Registers block function to be used in templates
Parameters:
string |
$block: |
name of template block |
string |
$block_impl: |
PHP function to register |
|
$cacheable: |
|
|
$cache_attrs: |
|
void register_compiler_function(
string
$function, string
$function_impl, [
$cacheable = true]
)
|
|
Registers compiler function
Parameters:
string |
$function: |
name of template function |
string |
$function_impl: |
name of PHP function to register |
|
$cacheable: |
|
void register_function(
string
$function, string
$function_impl, [
$cacheable = true], [
$cache_attrs = null]
)
|
|
Registers custom function to be used in templates
Parameters:
string |
$function: |
the name of the template function |
string |
$function_impl: |
the name of the PHP function to register |
|
$cacheable: |
|
|
$cache_attrs: |
|
void register_modifier(
string
$modifier, string
$modifier_impl
)
|
|
Registers modifier to be used in templates
Parameters:
string |
$modifier: |
name of template modifier |
string |
$modifier_impl: |
name of PHP function to register |
void register_object(
string
$object, object
&$object_impl, [null|array
$allowed = array()], [boolean
$smarty_args = true], [
$block_methods = array()], null|array
$block_functs
)
|
|
Registers object to be used in templates
Parameters:
string |
$object: |
name of template object |
object |
&$object_impl: |
the referenced PHP object to register |
null|array |
$allowed: |
list of allowed methods (empty = all) |
boolean |
$smarty_args: |
smarty argument format, else traditional |
null|array |
$block_functs: |
list of methods that are block format |
|
$block_methods: |
|
void register_outputfilter(
string
$function
)
|
|
Registers an output filter function to apply to a template output
Parameters:
string |
$function: |
name of PHP function |
void register_postfilter(
string
$function
)
|
|
Registers a postfilter function to apply to a compiled template after compilation
Parameters:
string |
$function: |
name of PHP function to register |
void register_prefilter(
string
$function
)
|
|
Registers a prefilter function to apply to a template before compiling
Parameters:
string |
$function: |
name of PHP function to register |
void register_resource(
string
$type, array
$functions
)
|
|
Registers a resource to fetch a template
Parameters:
string |
$type: |
name of resource |
array |
$functions: |
array of functions to handle resource |
boolean template_exists(
string
$tpl_file
)
|
|
Checks whether requested template exists.
Parameters:
void trigger_error(
string
$error_msg, [integer
$error_type = E_USER_WARNING]
)
|
|
trigger Smarty error
Parameters:
string |
$error_msg: |
|
integer |
$error_type: |
|
void unregister_block(
string
$block
)
|
|
Unregisters block function
Parameters:
string |
$block: |
name of template function |
void unregister_compiler_function(
string
$function
)
|
|
Unregisters compiler function
Parameters:
string |
$function: |
name of template function |
void unregister_function(
string
$function
)
|
|
Unregisters custom function
Parameters:
string |
$function: |
name of template function |
void unregister_modifier(
string
$modifier
)
|
|
Unregisters modifier
Parameters:
string |
$modifier: |
name of template modifier |
void unregister_object(
string
$object
)
|
|
Unregisters object
Parameters:
string |
$object: |
name of template object |
void unregister_outputfilter(
string
$function
)
|
|
Unregisters an outputfilter function
Parameters:
string |
$function: |
name of PHP function |
void unregister_postfilter(
string
$function
)
|
|
Unregisters a postfilter function
Parameters:
string |
$function: |
name of PHP function |
void unregister_prefilter(
string
$function
)
|
|
Unregisters a prefilter function
Parameters:
string |
$function: |
name of PHP function |
void unregister_resource(
string
$type
)
|
|
Unregisters a resource
Parameters:
string |
$type: |
name of resource |
boolean _compile_resource(
string
$resource_name, string
$compile_path
)
|
|
compile the template
Parameters:
string |
$resource_name: |
|
string |
$compile_path: |
|
boolean _compile_source(
string
$resource_name,
&$source_content,
&$compiled_content, [
$cache_include_path = null], string
$source_content, string
$compiled_content
)
|
|
compile the given source
Parameters:
string |
$resource_name: |
|
string |
$source_content: |
|
string |
$compiled_content: |
|
|
&$source_content: |
|
|
&$compiled_content: |
|
|
$cache_include_path: |
|
string _dequote(
string
$string
)
|
|
Remove starting and ending quotes from the string
Parameters:
mixed _eval(
$code, [
$params = null]
)
|
|
wrapper for eval() retaining $this
Parameters:
boolean _fetch_resource_info(
&$params, string
$resource_name, string
$source_content, integer
$resource_timestamp, boolean
$get_source, boolean
$quiet
)
|
|
fetch the template info. Gets timestamp, and source if get_source is true
sets $source_content to the source of the template, and $resource_timestamp to its time stamp
Parameters:
string |
$resource_name: |
|
string |
$source_content: |
|
integer |
$resource_timestamp: |
|
boolean |
$get_source: |
|
boolean |
$quiet: |
|
|
&$params: |
|
string _get_auto_filename(
string
$auto_base, [string
$auto_source = null], [string
$auto_id = null]
)
|
|
get a concrete filename for automagically created content
Parameters:
string |
$auto_base: |
|
string |
$auto_source: |
|
string |
$auto_id: |
|
API Tags:
Staticvar: | string|null 1: |
Staticvar: | string|null $_cache_info: |
string|null _get_auto_id(
[string
$cache_id = null], [string
$compile_id = null]
)
|
|
returns an auto_id for auto-file-functions
Parameters:
string |
$cache_id: |
|
string |
$compile_id: |
|
string _get_compile_path(
string
$resource_name
)
|
|
Get the compile path for this resource
Parameters:
API Tags:
string|false _get_plugin_filepath(
string
$type, string
$name
)
|
|
get filepath of requested plugin
Parameters:
string |
$type: |
|
string |
$name: |
|
mixed _include(
$filename, [
$once = false], [
$params = null]
)
|
|
wrapper for include() retaining $this
Parameters:
|
$filename: |
|
|
$once: |
|
|
$params: |
|
boolean _is_compiled(
string
$resource_name, string
$compile_path
)
|
|
test if resource needs compiling
Parameters:
string |
$resource_name: |
|
string |
$compile_path: |
|
boolean _parse_resource_name(
&$params, string
$resource_base_path, string
$resource_name, string
$resource_type
)
|
|
parse out the type and name from the resource
Parameters:
string |
$resource_base_path: |
|
string |
$resource_name: |
|
string |
$resource_type: |
|
|
&$params: |
|
string _process_compiled_include_callback(
$match
)
|
|
callback function for preg_replace, to call a non-cacheable block
Parameters:
string _read_file(
string
$filename, [integer
$start = null], [integer
$lines = null]
)
|
|
read in a file from line $start for $lines.
read the entire file if $start and $lines are null.
Parameters:
string |
$filename: |
|
integer |
$start: |
|
integer |
$lines: |
|
string _run_mod_handler(
string|null
$modifier_name, array|null
$map_array
)
|
|
Handle modifiers
Parameters:
string|null |
$modifier_name: |
|
array|null |
$map_array: |
|
API Tags:
Return: | result of modifiers |
array &_smarty_cache_attrs(
$cache_serial,
$count
)
|
|
get or set an array of cached attributes for function that is
not cacheable
Parameters:
void _smarty_include(
$params, string
$_smarty_include_tpl_file, string
$_smarty_include_vars
)
|
|
called for included templates
Parameters:
string |
$_smarty_include_tpl_file: |
|
string |
$_smarty_include_vars: |
|
|
$params: |
|
void _trigger_fatal_error(
string
$error_msg, [string
$tpl_file = null], [integer
$tpl_line = null], [string
$file = null], [integer
$line = null], [integer
$error_type = E_USER_ERROR]
)
|
|
trigger Smarty plugin error
Parameters:
string |
$error_msg: |
|
string |
$tpl_file: |
|
integer |
$tpl_line: |
|
string |
$file: |
|
integer |
$line: |
|
integer |
$error_type: |
|
void _unlink(
string
$resource, [integer
$exp_time = null]
)
|
|
unlink a file, possibly using expiration time
Parameters:
string |
$resource: |
|
integer |
$exp_time: |
|
|
|