{$smarty} reserved variable
The PHP reserved {$smarty} variable can be used to
access several enviroment and request variables.
The full list of them follows.
Request variables
The request variables
such as $_GET, $_POST,
$_COOKIE, $_SERVER,
$_ENV and $_SESSION
(see
$request_vars_order
and
$request_use_auto_globals)
can be accessed as demonstrated in the examples below:
Example 4-7. Displaying request variables {* display value of page from URL ($_GET) http://www.example.com/index.php?page=foo *}
{$smarty.get.page}
{* display the variable "page" from a form ($_POST['page']) *}
{$smarty.post.page}
{* display the value of the cookie "username" ($_COOKIE['username']) *}
{$smarty.cookies.username}
{* display the server variable "SERVER_NAME" ($_SERVER['SERVER_NAME'])*}
{$smarty.server.SERVER_NAME}
{* display the system environment variable "PATH" *}
{$smarty.env.PATH}
{* display the php session variable "id" ($_SESSION['id']) *}
{$smarty.session.id}
{* display the variable "username" from merged get/post/cookies/server/env *}
{$smarty.request.username} |
|
Note:
For historical reasons {$SCRIPT_NAME} can be accessed
directly, although {$smarty.server.SCRIPT_NAME} is the
proposed way to access this value.
<a href="{$SCRIPT_NAME}?page=smarty">click me</a>
<a href="{$smarty.server.SCRIPT_NAME}?page=smarty">click me</a> |
{$smarty.now}
The current timestamp
can be accessed with {$smarty.now}.
The value reflects the number of
seconds passed since the so-called Epoch on January 1, 1970,
and can be passed directly to the
date_format
modifier for display. Note that
time()
is called on each invocation; eg a script that takes three seconds to execute
with a call to $smarty.now at start and end
will show the three second difference.
{$smarty.const}
You can access PHP constant values directly. See also smarty constants.
Output the constant in a template with
{$smarty.capture}
Template output captured via the built-in
{capture}..{/capture} function can be accessed
using the {$smarty.capture} variable.
See the
{capture} page for more information.
{$smarty.config}
{$smarty.config} variable can be used to refer
to loaded config variables.
{$smarty.config.foo} is a synonym for
{#foo#}. See the
{config_load} page
for more info.
{$smarty.section}, {$smarty.foreach}
The {$smarty.section} and
{$smarty.foreach} variables can be used to refer to
{section}
and
{foreach}
loop properties respectfully. These have some very useful values such as
.first, .index, etc.
{$smarty.template}
Returns the name of the current template being processed.
The following example shows the container.tpl and the
included banner.tpl with
{$smarty.template} within both.
<b>Main container is {$smarty.template}</b>
{include file='banner.tpl'} |
will output
<b>Main page is container.tpl</b>
banner.tpl |
{$smarty.version}
Returns the version of Smarty the template was compiled with.
<div id="footer">Powered by Smarty {$smarty.version}</div> |
