Smarty基本安装
将下载的smarty解压到/libs/目录里。这些文件被所有应用程序所共享,不建议随意更改。在你更新smarty版本时,这些文件将会被更新。
Smarty库文件:
Smarty.class.php Smarty_Compiler.class.php Config_File.class.php debug.tpl /core/*.php (all of them) /plugins/*.php (all of them)
Smarty使用一个叫做'SMARTY_DIR'的php常量作为它的系统库目录。基本上,如果你的应用程序可以找到 Smarty.class.php文件,你就不需要设置SMARTY_DIR,Smarty将会自己运行。但是,如果 Smarty.class.php没有在你的include_path(php.ini里的一项设置)里,或者没有在你的应用程序里设置它的绝对路径的时候,你就必须手动配置SMARTY_DIR 了(大多数程序都如此)SMARTY_DIR必须包含结尾斜杠。
下面是在php脚本里创建一个smarty的应用实例的例子:
require('Smarty.class.php');
$smarty = new Smarty;试着运行一下以上脚本,如果你发现"未找到Smarty.class.php 文件"的错误时,你应该这样做:
加入库文件目录的绝对路径:
require('/usr/local/lib/php/Smarty/Smarty.class.php');
$smarty = new Smarty;在include_path加入库文件目录:
// Edit your php.ini file, add the Smarty library
// directory to the include_path and restart web server.
// Then the following should work:
require('Smarty.class.php');
$smarty = new Smarty;手动设置SMARTY_DIR常量:
define('SMARTY_DIR','/usr/local/lib/php/Smarty/');
require(SMARTY_DIR.'Smarty.class.php');
$smarty = new Smarty;
现在库文件已经搞定,该是设置为你的应用程序配置其他有关Smarty的目录的时候了。
Smarty要求4个目录,默认下命名为:tempalates, templates_c, configs , cache。
每个都是可以自定义的,可以修改Smarty类属性: $template_dir, $compile_dir, $config_dir, and $cache_dir respectively。强烈推荐你为每个用到smarty的应用程序设置单一的目录!
确定你已经知道了你的web服务器文件根目录。在我们的例子里,文件根目录是:"/web/www.w3cschool.cn/docs/"Smarty的4个目录 只可以被那些库文件访问,不可以被网络上的浏览器访问的目录。因此为避免任何安全问题,要求将那4个目录和网页文件目录(就是浏览器看的)分开来。
在我们的安装例子里,我们将为一个留言板程序配置smarty环境。我们挑选应用程序只为了实现目录命名约定。你可以对任何程序使用相同的环境,只要将"guestbook"改成你要的名字就可以了。我们将把Smarty目录放在 "/web/www.w3cschool.cn/smarty/guestbook/"下。
在你的文档目录下至少得有一个文件,这个文件可以被浏览器访问.我们叫它 "index.php"好了.把它放到"/guestbook/"目录下.
温馨提示：建立web服务器很方便，这个文件可以被web服务器自动识别。如果你访问"//www.w3cschool.cn/guestbook/"，你不需要在URL上输入"index.php"，index.php脚本就可以被执行。在Apache服务器中，可以通过在DirectoryIndex的后面添加"index.php" 文件(用反斜杠分开每个入口)来完成设置。
现在我们看看这些文件结构:
/usr/local/lib/php/Smarty/Smarty.class.php /usr/local/lib/php/Smarty/Smarty_Compiler.class.php /usr/local/lib/php/Smarty/Config_File.class.php /usr/local/lib/php/Smarty/debug.tpl /usr/local/lib/php/Smarty/core/*.php /usr/local/lib/php/Smarty/plugins/*.php /web/www.w3cschool.cn/smarty/guestbook/templates/ /web/www.w3cschool.cn/smarty/guestbook/templates_c/ /web/www.w3cschool.cn/smarty/guestbook/configs/ /web/www.w3cschool.cn/smarty/guestbook/cache/ /web/www.w3cschool.cn/docs/guestbook/index.php
Smarty的 $compile_dir 和$cache_dir必须可写。通常是user "nobody" 和 group "nobody"。如果是 OSX用户,默认为user "web" 和 group "web"。如果你在使用Apache,你可以看看httpd.conf 文件 (通常在"/usr/local/apache/conf/"目录下)哪些user和group正在被使用。
Smarty文件权限设置:
chown nobody:nobody /web/www.w3cschool.cn/smarty/guestbook/templates_c/ chmod 770 /web/www.w3cschool.cn/smarty/guestbook/templates_c/ chown nobody:nobody /web/www.w3cschool.cn/smarty/guestbook/cache/ chmod 770 /web/www.w3cschool.cn/smarty/guestbook/cache/
温馨提示:
chmod 770相当安全了,它只让user "nobody" 和 group "nobody" 读/写 访问。如果你要对任何人开放读取访问权限(大多是为了你自己查看文件),你可以使用 775。
我们需要创建index.tpl文件让smarty载入.这个文件放在 $template_dir目录里。
Smarty手册范例 2-8 编辑/web/www.w3cschool.cn/smarty/templates/index.tpl
{* Smarty *}
Hello, {$name}!温馨提示:
{* Smarty *} 是一个模板注释。虽然并不是必须的,但是这可以很好的锻炼你在模板文件里加入注释的习惯。它可以使文件便于识别。例如，一些文本编辑器可以识别这个文件,并加以语法高亮显示。
现在来编辑index.php。我们将创建一个Smarty的实例,指派模板变量,显示 index.tpl文件。在我们的例子的环境里, "/usr/local/lib/php/Smarty"已经包括在了 include_path里了。示例如下:
// load Smarty library
require('Smarty.class.php');
$smarty = new Smarty;
$smarty->template_dir = '/web/www.w3cschool.cn/smarty/guestbook/templates/';
$smarty->compile_dir = '/web/www.w3cschool.cn/smarty/guestbook/templates_c/';
$smarty->config_dir = '/web/www.w3cschool.cn/smarty/guestbook/configs/';
$smarty->cache_dir = '/web/www.w3cschool.cn/smarty/guestbook/cache/';
$smarty->assign('name','Ned');
$smarty->display('index.tpl');温馨提示:
在我们的例子里,已经设置了所有Smarty目录的绝对目录。如果 '/web/www.w3cschool.cn/smarty/guestbook/' 已经包括在 include_path里了,那么这些设置则没有必要。但是,从经验和通用性看来,为避免发生错误,还是配置一下为好。
现在在浏览器打开 index.php,你应该看到"Hello, Porky!"
你现在已经完成了Smarty的基本设置