What is Smarty?
Why use it?
Use Cases and Work Flow
Syntax Comparison
Template Inheritance
Best Practices
Crash Course
What is Smarty?
Why use it?
Use Cases and Work Flow
Syntax Comparison
Template Inheritance
Best Practices
Crash Course
Quick Install
Documentation
Discussion
Mailing Lists
Github
Example App
www.phpinsider.com
Smarty Icon
You may use the Smarty logo according to the trademark notice.
For sponsorship, advertising, news or other inquiries, contact us at:
Sites Using Smarty
Advertisement
Table of Contents
模板可以是各种不同的来源提供的。
当你display() 或者
fetch()一个模板，
又或者当你包含一个模板到另一个模板中的时候，你需要提供一个资源类型、路径及模板名。
如果没有明确指明资源类型，则将假定是使用
$default_resource_type
（默认是“file”）。
Smarty通常运行在内置的、基于文件系统的模板资源上。
默认资源是file:。
如果修改了$default_resource_type
那么资源关键字file:就必须要指明。
如果找不到需要的模板文件，那么 $default_template_handler_func将会被调用。
说明
在Smarty 3.1开始，除非开启了
$use_include_path配置，否则文件资源不会再搜索
include_path
的路径了。
Smarty从$template_dir设置的目录中，
获取模板文件资源。
多个模板目录将以在数组中的顺序进行搜索，在寻找到第一个匹配的模板时将返回。
Example 16.1. 使用$template_dir
<?php
$smarty->display('index.tpl');
$smarty->display('file:index.tpl'); // 同上
?>
模板中使用
{include file='index.tpl'}
{include file='file:index.tpl'} {* 同上 *}
Smarty 3.1 提供“归类符号”来定义$template_dir中的特定元素。
此特性可允许网站中使用和更好地管理多个模板集合。
“归类符号”可以用在任何定义了file:资源类型的地方。
Example 16.2. 特定的$template_dir
<?php
// 设置模板目录
$smarty->setTemplateDir(array(
'./templates', // element: 0, index: 0
'./templates_2', // element: 1, index: 1
'10' => 'templates_10', // element: 2, index: '10'
'foo' => 'templates_foo', // element: 3, index: 'foo'
));
/*
假定模板目录结构如下：
./templates/foo.tpl
./templates_2/foo.tpl
./templates_2/bar.tpl
./templates_10/foo.tpl
./templates_10/bar.tpl
./templates_foo/foo.tpl
*/
// 正常读取
$smarty->display('file:foo.tpl');
// 将载入 ./templates/foo.tpl
// 默认使用数字下标
$smarty->display('file:[1]foo.tpl');
// 将载入 ./templates_2/foo.tpl
// 使用字符串的下标（'10'看起来像数字下标，但却是有单引号的字符串）
$smarty->display('file:[10]foo.tpl');
// 将载入 ./templates_10/foo.tpl
// 使用字符串的下标
$smarty->display('file:[foo]foo.tpl');
// 将载入 ./templates_foo/foo.tpl
// 使用 "未知" 数字下标 (用元素的数字)
$smarty->display('file:[2]foo.tpl');
// 将载入 ./templates_10/foo.tpl
?>
模板中调用
{include file="file:foo.tpl"}
{* 将载入 ./templates/foo.tpl *}
{include file="file:[1]foo.tpl"}
{* 将载入 ./templates_2/foo.tpl *}
{include file="file:[foo]foo.tpl"}
{* 将载入 ./templates_foo/foo.tpl *}
在$template_dir之外的模板，
file:将需要使用绝对路径来获取模板。
Note
当Security开启，
在$template_dir之外的模板是不允许读取的，除非你将这些目录都设置在$secure_dir中。
Example 16.3. 任意目录的模板
<?php
$smarty->display('file:/export/templates/index.tpl');
$smarty->display('file:/path/to/my/templates/menu.tpl');
?>
模板中：
{include file='file:/usr/local/share/templates/navigation.tpl'}